下载地址
https://www.zhengdianxue.com/wp-content/uploads/skills/org-a8wl2pat--tripadvisor-travel-assistant.zip将提示词发送给你的 AI 安装该 skills
请根据 https://skillhub.cn/install/skillhub.md,安装 @org-a8wl2pat/tripadvisor-travel-assistant。查猫途鹰榜单、酒店、景点、餐厅、玩乐,看详情、评分和点评摘要。猫途鹰旅行助手可通过自然语言,查询基于全球旅行者评价汇总的酒店、餐厅、景点和体验产品的信息,支持多平台价格查询和预订返现权益领取,寻找海外目的地小众玩法。通过自带 Python 脚本直接调用公开接口,不需要 MCP、不需要登录;不涉及下单和个人数据。
阅读全文 (展开查看完整说明)
概述
猫途鹰旅行查询
所有数据来自猫途鹰 H5 站(m.tripadvisor.cn)用的公开只读接口,通过本技能自带的脚本调用:
python3 "${CODEBUDDY_SKILL_DIR}/scripts/ta.py" <子命令> [参数]- 只需要 Python 3.8+,不依赖第三方包。Windows 上
python3不可用时改用python。 - 每次调用向 stdout 输出一行 JSON。出错时输出
{"error": "<code>", "message": "..."},退出码为 1;参数本身写错(如--limit超范围)时 stderr 打印用法,退出码为 2。 - 多个互不依赖的查询(如景点、餐厅、玩乐)可以并行执行。
回答规则
- 评分、点评数、排名、奖项、门票/玩乐起价只引用脚本结果,不凭记忆补充;结果里没有的字段就说没有。
- 每个提到的酒店、景点、餐厅、玩乐都用结果里的
url做成 Markdown 链接[名称](url),表格里也一样。链接原样使用,不要删掉或改动末尾的渠道参数m=1400300021,也不要自己拼链接;所有给用户的猫途鹰链接都必须带这个参数。 - 列表结果里点评很少(如
reviewCount< 10)或没有评分的条目,推荐时放后面或略过,除非用户就是按名称找它。 - 不提供酒店房价、比价、预订和返现。
ticketFrom/priceFrom是「起价」,不是最终报价。 - 归纳点评时只用
reviews子命令返回的内容,说明「基于 N 条点评」(N 为实际读到的条数),不要编造引文,也不要写成某位用户的原话。 ranking是「在某区域同类里排第几」,原样转述;awards里的「旅行者之选」「旅行者之选至尊奖」是年度奖项。
子命令
| 子命令 | 用途 | 主要参数 |
|---|---|---|
search <关键词> | 按名称找目的地或某家 POI,拿 locationId / geoId | --type geo/hotel/attraction/restaurant/experience、--limit 1-10 |
hotels | 城市酒店列表 | --city(城市名或 geoId,必填)、--sort popular/value/price_asc/distance、--near <locationId> + --radius <公里>(默认 2)、--filter type=id1,id2(可重复)、--limit 1-30、--page |
attractions | 城市景点列表(默认按旅行者排名) | --city、--keyword、--filter <value>(可重复)、--limit 1-20、--page |
restaurants | 城市餐厅列表 | --city、--keyword(菜名、店名)、--sort default/ranking、--filter <value>(可重复)、--limit 1-20、--page |
experiences | 城市玩乐(一日游、演出、体验课等) | --city、--keyword、--limit 1-20、--page |
filters <hotel/attraction/restaurant> | 查某城市可用的筛选项 | --city、--keyword(只返回名称含该词的选项) |
detail <locationId> | POI 详情:品类、评分、点评数、坐标、介绍、所属地区 | --max-chars(介绍截断长度,默认 300) |
reviews <locationId> | 评分分布和点评原文 | --keyword(如 隔音、早餐)、--rating 1-5(可重复)、--limit 1-20、--offset、--max-chars |
筛选
先用 filters 查到选项,再传给列表命令:
- 酒店:
filters hotel返回{name, id},组名括号里是类型,如「酒店钻级(lv)」「区域(zone)」「酒店类型(type)」「酒店风格(style)」「品牌(brand)」。传参写成--filter lv=4,5,同组多个 id 用逗号分隔。 - 景点、餐厅:
filters attraction|restaurant返回{name, value},把value原样传给--filter,记得加引号,如--filter 'cuisine|5086|||法餐|@cuisine@cuisine'。 - 景点的「奖项/评分」组有「旅行者之选至尊奖」「旅行者之选」「≥4.5分」等,可用来找获奖景点。
周边酒店
--near 接任意 POI 的 locationId(景点、地标、餐厅都行),脚本取它的坐标,只返回半径内的酒店,每家带 distance(如「离上海外滩0.2公里」)。默认仍按 popular 排;用户要「最近的」时加 --sort distance,但距离排序会把没有点评的小旅馆排前面,需要自己过滤。
常见用法
- 「上海有什么必去的景点」:
attractions --city 上海 --limit 10。 - 「东京的旅行者之选景点」:
filters attraction --city 东京 --keyword 旅行者取 value,再attractions --city 东京 --filter '<value>'。 - 「外滩附近评分高的酒店」:
search 外滩 --type attraction拿到locationId,再hotels --city 上海 --near <locationId> --radius 1.5。 - 「上海五钻酒店」:
filters hotel --city 上海 --keyword 五钻拿 id,再hotels --city 上海 --filter lv=5。 - 「上海好吃的法餐」:
filters restaurant --city 上海 --keyword 法餐取 value,再restaurants --city 上海 --filter '<value>' --sort ranking。 - 「和平饭店怎么样」:
search 和平饭店 --type hotel确认是哪一家(同名的看region),再并行detail <id>和reviews <id> --limit 10,回答评分、评分分布、排名和点评要点,附链接。 - 「和平饭店隔音怎么样」:
reviews <id> --keyword 隔音 --limit 10;「差评说了什么」:reviews <id> --rating 1 --rating 2 --limit 15。 - 「三天怎么玩」:并行查景点、玩乐、餐厅(
--sort ranking),按坐标就近分组,每天 2 到 3 项,每项附链接。
结果字段
- 列表命令返回
geoId、city、total(总条数,接口封顶 10000)和items;total为 0 时换关键词或去掉筛选再试。 search的结果不带评分,需要评分时再调detail或reviews。detail的category为 hotel / attraction / restaurant / geo。detail没有地址、营业时间、电话,不要编造。reviews:score、count、ratingDistribution(各星级条数)是整体数据;matched是按关键词或星级筛选后的条数;nextOffset有值时可以继续翻页。点评可能是外文,转述时翻译成用户的语言。
错误处理
error | 含义 | 处理 |
|---|---|---|
destination_not_found | --city 的名字没识别出来 | 换成所在城市的名字,或先用 search <名称> --type geo 拿 geoId |
not_found | locationId 不存在或没有坐标 | 重新 search 确认 id |
invalid_args | 参数格式不对(如 --filter 缺 =) | 按上面的格式修正 |
network_error | 网络不通或超时(单次 20 秒) | 重试一次,仍失败就告诉用户稍后再试 |
upstream_error | 接口返回非 200 或非 JSON | 告诉用户猫途鹰接口暂时不可用,不要用记忆中的信息代替 |
接口细节(地址、请求体、字段来源)见 @references/api.md,排查问题或接口变更时再看。