Staying Api — Airbnb Stay Data

airbnb-skills

用于 Airbnb 入住数据的 Agent 技能。 这三个即插即用的技能可让任何 Agent 通过 Staying API 查询和搜索 Airbnb 房源，包括照片、评价、房东、价格和未来 12 个月的可订状态。统一的类型化 Stay 契约不会因 Airbnb 改版网站而失效，并且同时支持 REST 和 MCP。

免费使用——获取密钥（100 个额度点，无需银行卡），不到两分钟即可通过 Claude、ChatGPT、Cursor 或你自己的 Agent 循环调用 Airbnb 入住数据。

纯 Python 标准库，无依赖。采用 MIT-0 许可证。

安装

# OpenClaw (via ClawHub)
npx clawhub@latest install airbnb-full

# Hermes Agent
hermes skills install skills-sh/nikhonit/airbnb-skills/skills/airbnb-full

# Generic agent skills (Claude Code, Cursor, Cline)
npx skills add nikhonit/airbnb-skills

此仓库中的技能

技能	用途	费用
airbnb-full	完整工具包——按 ID/URL/地址查找、子资源、搜索、异步批量任务、Webhook、账户/用量	每条记录 1 个额度点
airbnb-stay	查询单个房源，以及照片、评价、房东、便利设施、可订状态、价格、位置、评分	每次调用 1 个额度点
airbnb-search	按地点/日期/价格/容纳人数搜索，并提供超赞房东、即时预订和豪华房源预设	每条结果 1 个额度点

对于需要广泛覆盖的 Agent，请安装捆绑的 airbnb-full。如果希望尽量缩小工具范围，请安装专用版本。

身份验证

将 STAYINGAPI_KEY 环境变量设置为你的 Staying API 密钥（格式为 sk_...）。

export STAYINGAPI_KEY="sk_..."

30 秒内获取免费密钥——100 个额度点，无需银行卡。同一个密钥可用于这些技能、托管 MCP 服务和直接 REST 调用。

改用 MCP

Staying API 托管了一个可流式传输的 HTTP MCP 服务，因此原生支持 MCP 的 Agent 可以完全跳过脚本。将客户端指向 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/分钟

每返回一条入住记录计 1 个额度点（搜索按结果计费；by-address 按 3 个额度点计）。失败的调用不消耗额度点。额度点会结转且不会过期。

来源

• API 参考：https://stayingapi.com/openapi.json
• 托管 MCP 服务：https://api.stayingapi.com/mcp
• 快速入门：https://stayingapi.com/quickstart/
• 面向 AI Agent：https://stayingapi.com/ai-agents/

问题与贡献

请参阅 CONTRIBUTING.md。安全问题报告：SECURITY.md。

许可证

MIT No Attribution。可自由分叉、发布和再许可——无需注明出处。

商标

Staying API 是一项独立服务，与 Airbnb, Inc. 无关联，也未获得其认可或赞助。“Airbnb”是 Airbnb, Inc. 的注册商标。