三进制咨询员- mcp
MCP 服务器 TripAdvisor Terra API 互联网档案馆的存檔,存档日期2013-12-02 -克劳德的旅行数据 搜索酒店,餐厅,以及按名称或坐标排列的景点,然后拉出全部细节,相片,和评论,遍及 stdio. (Terra是TripAdvisor目前的API;遗产内容API是2026-08-31.)
由AI(Claude Code)开发和维护. 自行取用.
快开始
{
"mcpServers": {
"tripadvisor": {
"command": "npx",
"args": ["-y", "@chrischall/tripadvisor-mcp"],
"env": { "TRIPADVISOR_API_KEY": "your-terra-api-key-here" }
}
}
}
找到钥匙 tripadvisor.com/开发商免费 发现 级别为现收现付(10个QPS, 每天10 000通电话);反应被隐藏在记忆中来拉伸. 确定这是 地面 密钥 — 一个遗留的内容 API 密钥返回 403.
工具
| 工具 | 它会做什么 |
|---|---|
ta_search_locations | 按名称搜索地点(按类别、国家/地理/邮政编码选择范围)——标出; compact:true 粗略摘要 |
ta_search_nearby | 查找靠近一lat/lon+radius, a的位置 location_id+radius,或者在 sw/ne 边框内(类别、分级、排序)—— compact:true 支持 |
ta_get_location_details | 完整细节:姓名,描述,地址,坐标,旅行者评分,电话,列出URL |
ta_get_locations | 批次——细节 多个 在一个呼叫中(比N详细呼叫便宜); compact:true 支持 |
ta_get_location_photos | 具有多尺寸图像 URL、源和维度的照片 |
ta_get_location_reviews | 旅行者评论——标注 |
ta_web_healthcheck | 诊断可选 tripavisor.com 浏览器-桥接(见下文) |
ta_web_get_location | 通过浏览器桥从公共页面读取位置细节(平面,地址,coords,电话,相片)—— 不需要 API 密钥 |
所有工具都是只读的——Terra没有写出终点.
浏览器桥 (可选)
ta_web_healthcheck 是可选的第二层次的第一个工具,可达到
tribeadvisor.com的消费网站(bot-walled,如此无法到达的服务器侧面) 由:
通过您登录的浏览器标签获取相同的源代码
背景Mint Bridge 浏览器扩展名, 安装于
其发布页面
(Chrome:下载铬拉链并装入它解开的 chrome://extensions
已启用开发者模式; Safari 尚未可用 。 它将在
ContentMint app,它没有公开下载——所以现在使用Chrome). 这需要
安装扩展并一次性对齐批准; 内容 API 工具
上面永远不要碰桥.
ContextMint Bridge是取出新名称下的代理浏览器扩展名,来自
相同的维护者——获取代理服务器自己的 README
(单位:千美元)https://github.com/chrischall/fetchproxy#extension 页面存档备份,存于互联网档案馆)指之. 它的来源是
公开时间 https://github.com/nullnet-app/contextmint-bridge (中文(中国大陆) ):自己建造它,
或对照 .sha256 旁边公布的文件
(单位:千美元)shasum -a 256 -c contextmint-bridge-chrome-<version>.zip.sha256) (中文(简体) ).
ta_web_get_location 使用此桥读取一个位置的细节
从它的公开 TripAdvisor的页面——所以它的工作 没有 API 密钥, (中文(简体) ),
包括景点、旅馆和餐馆。 它返回核心业务数据
(评级、审查计数、地址、坐标、电话、主要照片、列名)
URL),但不包括个别审查文本. 请求形状被固定在
文件/文件索引。 。 。 .
环境
| 瓦尔 | 需求 | 目的 |
|---|---|---|
TRIPADVISOR_API_KEY | 用于Terra工具 | Terra API 密钥,作为 X-API-Key 头曰. 这个 ta_web_* 工具没有它. |
TRIPADVISOR_CACHE_TTL | 没有 | 秒到缓存搜索回复( 默认: 300; 0 / 禁用). |
TRIPADVISOR_STATIC_CACHE_TTL | 没有 | 秒到缓存细节/相片/审查(默认:3600; 0 / 禁用). |
TRIPADVISOR_REQUEST_TIMEOUT_MS | 没有 | 可选浏览器桥的每个请求超时(默认:3000). |
TRIPADVISOR_DEBUG_LOG | 没有 | 设定为 1 以登录浏览器-桥请求以 stderr . |
发展
npm install
npm run build # tsc + esbuild bundle
npm test # vitest (no real network)
端点请求形状被钉入 文件/文件编号键入 .env, (中文(简体) ), node scripts/live-probe.mjs 通过已建客户端练习每个读取路径 .
许可证
麻省理工学院