# @chrischall/tripadvisor-mcp 中文文档

规范地址：https://npmcn.com/package/%40chrischall/tripadvisor-mcp/

版本：1\.2\.0
npm 元数据更新时间：2026-11-04T18:08:52.192Z
中文译文更新时间：2026-11-09T15:39:34.870Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40chrischall/tripadvisor-mcp
原文对照：https://npmcn.com/package/%40chrischall/tripadvisor-mcp/?lang=original
项目主页：https://github.com/chrischall/tripadvisor-mcp#readme
源码仓库：https://github.com/chrischall/tripadvisor-mcp

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：3 MB，27 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- 运行依赖：5 个
- 首次发布：2026-07-05T00:36:18.675Z
- 最新版本发布：2026-11-04T18:08:51.866Z
- 近 30 天下载量：2344（2026-10-10 至 2026-11-08，npm 官方下载统计）
- 已发布版本数：34（近 12 个月 34 个）

## 中文简介

TripAdvisor Terra API 为克洛德服务的MCP服务器——搜索地点,细节,照片,以及评论. 由AI(Claude Code)开发和维护.

## 安装

```sh
npm install @chrischall/tripadvisor-mcp
```

也可以使用：`pnpm add @chrischall/tripadvisor-mcp`、`yarn add @chrischall/tripadvisor-mcp`、`bun add @chrischall/tripadvisor-mcp`

## README

# 三进制咨询员- mcp

[![npm](https://img.shields.io/npm/v/@chrischall/tripadvisor-mcp)](https://www.npmjs.com/package/@chrischall/tripadvisor-mcp)

MCP 服务器 **TripAdvisor Terra API 互联网档案馆的存檔,存档日期2013-12-02** -克劳德的旅行数据 搜索酒店,餐厅,以及按名称或坐标排列的景点,然后拉出全部细节,相片,和评论,遍及 stdio. (Terra是TripAdvisor目前的API;遗产内容API是2026-08-31.)

> 由AI(Claude Code)开发和维护. 自行取用.

## 快开始

```json
{
  "mcpServers": {
    "tripadvisor": {
      "command": "npx",
      "args": ["-y", "@chrischall/tripadvisor-mcp"],
      "env": { "TRIPADVISOR_API_KEY": "your-terra-api-key-here" }
    }
  }
}
```

找到钥匙 [tripadvisor.com/开发商](https://www.tripadvisor.com/developers)免费 **发现** 级别为现收现付(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 浏览器扩展名, 安装于 [其发布页面](https://github.com/nullnet-app/contextmint-bridge/releases) (Chrome:下载铬拉链并装入它解开的 `chrome://extensions` 已启用开发者模式; Safari 尚未可用 。 它将在 ContentMint app,它没有公开下载——所以现在使用Chrome). 这需要 安装扩展并一次性对齐批准; 内容 API 工具 上面永远不要碰桥.

ContextMint Bridge是取出新名称下的代理浏览器扩展名,来自 相同的维护者——获取代理服务器自己的 README (单位:千美元)[https://github.com/chrischall/fetchproxy#extension 页面存档备份,存于互联网档案馆](https://github.com/chrischall/fetchproxy#extension))指之. 它的来源是 公开时间 [https://github.com/nullnet-app/contextmint-bridge (中文(中国大陆) )](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),但不包括个别审查文本. 请求形状被固定在 [文件/文件索引](https://npmcn.com/package/%40chrischall/tripadvisor-mcp/docs/TRIPADVISOR-WEB-API.md)。 。 。 .

## 环境

| 瓦尔 | 需求 | 目的 |
| --- | --- | --- |
| `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 . |

## 发展

```bash
npm install
npm run build   # tsc + esbuild bundle
npm test        # vitest (no real network)
```

端点请求形状被钉入 [文件/文件编号](https://npmcn.com/package/%40chrischall/tripadvisor-mcp/docs/TRIPADVISOR-API.md)键入 `.env`, (中文(简体) ), `node scripts/live-probe.mjs` 通过已建客户端练习每个读取路径 .

## 许可证

麻省理工学院

## 常见问题

### @chrischall/tripadvisor-mcp 是什么？

TripAdvisor Terra API 为克洛德服务的MCP服务器——搜索地点,细节,照片,以及评论\. 由AI\(Claude Code\)开发和维护\.

### 如何安装 @chrischall/tripadvisor-mcp？

在项目目录运行 npm install @chrischall/tripadvisor-mcp，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 tripadvisor-mcp，可以用 npx tripadvisor-mcp 直接运行。

### @chrischall/tripadvisor-mcp 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/chrischall\_\_tripadvisor-mcp 是否存在。

### @chrischall/tripadvisor-mcp 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @chrischall/tripadvisor-mcp 可以商用吗？

@chrischall/tripadvisor-mcp 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @chrischall/tripadvisor-mcp 的下载量有多少？

根据 npm 官方下载统计，@chrischall/tripadvisor-mcp 在 2026/10/10 – 2026/11/08 这 30 天内被下载 2,344 次，日均约 78 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @chrischall/tripadvisor-mcp 还在维护吗？

最新版本 1\.2\.0 发布于 2026/11/05（4 天前）；至今共发布 34 个版本，其中过去 12 个月发布了 34 个；首次发布于 2026/07/05。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。