内容
# Airbnb 技能
**适用于 Airbnb 住宿数据的代理技能。** 三个可直接使用的技能，允许任何代理查找和搜索 Airbnb 房源 — 照片、评论、房东、定价和 12 个月的可用性 — 通过 [Staying API](https://stayingapi.com)。一个输入的 `Stay` 契约，不会在 Airbnb 修改其网站时中断，提供 REST **和** MCP 版本。
免费使用 — [获取密钥](https://stayingapi.com/app/keys)（100 个积分，无需信用卡）您就可以在两分钟内从 Claude、ChatGPT、Cursor 或您自己的代理循环中调用 Airbnb 住宿数据。
纯 Python 标准库。无依赖。MIT-0 许可。
## 安装
```bash
# OpenClaw（通过 ClawHub）
npx clawhub@latest install airbnb-full
# Hermes 代理
hermes skills install skills-sh/nikhonit/airbnb-skills/skills/airbnb-full
# 通用代理技能（Claude Code、Cursor、Cline）
npx skills add nikhonit/airbnb-skills
```
## 本仓库中的技能
| 技能 | 目的 | 费用 |
|---|---|---|
| [`airbnb-full`](skills/airbnb-full) | 完整的工具包 — ID/URL/地址查找、子资源、搜索、异步批处理作业、Webhook、账户/用量 | 每条记录 1 个积分 |
| [`airbnb-stay`](skills/airbnb-stay) | 单个房源查找以及照片、评论、房东、设施、可用性、定价、位置、评分 | 每次调用 1 个积分 |
| [`airbnb-search`](skills/airbnb-search) | 位置 / 日期 / 价格 / 容量搜索，带有超级房东、即时预订和豪华预设 | 每个结果 1 个积分 |
为需要广泛覆盖的代理安装捆绑的 `airbnb-full`。在您想要最小化工具表面时，安装专注的变体。
## 身份验证
将 `STAYINGAPI_KEY` 环境变量设置为您的 Staying API 密钥（格式为 `sk_...`）。
```bash
export STAYINGAPI_KEY="sk_..."
```
**[30 秒内获取免费密钥](https://stayingapi.com/app/keys)** — 100 个积分，无需信用卡。相同的密钥适用于这些技能、[托管的 MCP 服务器](https://api.stayingapi.com/mcp)和直接 REST 调用。
### 改用 MCP
Staying API 托管了一个可流式传输的 HTTP MCP 服务器，因此 MCP 原生代理可以完全跳过脚本。将您的客户端指向 `https://api.stayingapi.com/mcp`，并带有 `Authorization: Bearer sk_...` 头（或 OAuth 2.1 PKCE，范围 `mcp:access`），即可获得五个工具：`lookup_stay_by_id`、`lookup_stay_by_url`、`search_stays`、`get_stay_photos`、`get_stay_reviews`。服务器卡：<https://stayingapi.com/.well-known/mcp/server-card.json>。
## 定价
| 计划 | 价格 | 积分 | 速率限制 |
|---|---|---|---|
| 免费 | $0 | 100（一次性） | 20/分钟 |
| 每月 | $5/月 | 400/月 | 200/分钟 |
| 年度 | $54/年 | 5,000/年 | 300/分钟 |
| 企业 | 自定义 | 自定义 | 1,500/分钟 |
一个积分等于返回一条房源记录（搜索按结果计费；`by-address` 权重为 3）。失败的调用不消耗积分。积分可以结转，不会过期。
## 来源
- API 参考：<https://stayingapi.com/openapi.json>
- 托管的 MCP 服务器：<https://api.stayingapi.com/mcp>
- 快速入门：<https://stayingapi.com/quickstart/>
- 适用于 AI 代理：<https://stayingapi.com/ai-agents/>
## 问题和贡献
参见 [CONTRIBUTING.md](CONTRIBUTING.md)。安全报告：[SECURITY.md](SECURITY.md)。
## 许可证
[MIT 无署名](LICENSE)。分叉、交付、 sublicense — 无需署名。
## 商标
Staying API 是一项独立服务，与 Airbnb, Inc. 无关，也不受其认可或赞助。“Airbnb” 是 Airbnb, Inc. 的注册商标。
