Airbnb 搜索扩展
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @org-rn88lg3j/airbnb-search-ext
技能介绍
为什么需要这个技能
在自动化旅行规划场景里,直接抓取或解析 Airbnb 页面往往很脆弱:筛选条件分散在 UI 上,日期、人数、价格区间很难用稳定参数表达,分页和详情页结构也经常变化。Airbnb 搜索扩展把这类查询收敛成两个明确的工具调用,让 Agent 可以用结构化参数完成搜索与详情获取,而不是依赖不稳定的页面解析。
核心能力与工作方式
该技能采用「LLM 作为路由层,代码负责 API 调用」的设计。模型负责理解用户意图、选择工具、提取参数;scripts.tools 中的函数负责真正发起查询,并返回结构化结果。
- 房源搜索:
scripts.tools.airbnb_search支持按location或 Google MapsplaceId搜索,可传入checkin、checkout、adults、children、infants、pets、minPrice、maxPrice等条件,并通过cursor做分页。 - 房源详情:
scripts.tools.airbnb_listing_details根据id获取单个房源详情,可附带入住日期和人数信息,用于核对价格或可订状态。 - 统一返回结构:工具返回
result["raw"]、result["success"]和result["message"],展示层应基于raw整理结果,并给用户可点击的房源链接。
关键步骤
- 先检查
scripts.config.settings.api_key;若为空,使用AskUserQuestion询问密钥,再调用scripts.config.set_api_key(api_key)保存。 - 根据用户意图选择搜索或详情工具。
- 提取参数;参数不完整时继续用
AskUserQuestion追问。 - 使用关键字参数调用
scripts.tools中的函数。 - 将返回的
raw数据整理后展示给用户。
适用边界与注意点
该技能依赖外部 API 密钥,没有密钥时不能工作,也不允许模型自行搜索或编造数据。它更适合旅行规划和房源研究,而不是实时预订或库存确认。若请求需要忽略 robots.txt,必须显式传入 ignoreRobotsText,并由调用方评估合规风险。
使用场景
- 规划家庭旅行时,按城市、入住日期、人数和预算筛选可订房源。
- 需要核对某个房源详情时,用 listing ID 获取价格、日期与入住人数信息。
- 做房源研究时,用 cursor 翻页继续查看下一批搜索结果。
- 用户提供 Google Maps Place ID 时,用 placeId 搜索替代城市名称。
适合人员
- 自助旅行规划者:想按日期、人数和价格筛选 Airbnb 房源并快速查看结果。
- 民宿运营或选品人员:需要批量比较多个 listing 的详情和价格条件。
- Agent 应用开发者:要把 Airbnb 搜索和详情能力接入自动化旅行助手。
- 使用桌面扩展做行程调研的用户:希望复用同一套筛选参数持续查看房源。