tripadvisor-mcp

Name: tripadvisor-mcp
Author: chrischall

ローカル

github.com/chrischall地図・旅行05 日前に更新

リポジトリ

tripadvisor-mcp について

tripadvisor-mcpは、Terra API経由でTripAdvisorの旅行先情報を扱うMCPサーバーです。場所の検索や詳細・写真・口コミの取得に加え、ブラウザブリッジで公開ページの情報も参照できます。

主な機能

01名称や地理範囲で検索
02場所の詳細情報を取得
03写真と旅行者の口コミを取得
04複数の場所情報を一括取得
05ブラウザブリッジでAPIキーなしの検索

活用シーン

01地域のホテル、飲食店、観光地を探す
02旅行前に評価や住所を確認
03写真や旅行者の口コミを比較
04Terraキーなしで公開情報を参照

MCP 対応

MCPクライアントにTripAdvisorの読み取り専用検索・場所情報ツールを提供します。TerraツールにはTerra APIキーが必要で、任意のWebツールはペアリング済みのContextMint Bridge拡張機能を使います。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定

{
  "mcpServers": {
    "chrischall-tripadvisor": {
      "command": "npx",
      "args": [
        "-y",
        "@chrischall/tripadvisor-mcp"
      ],
      "env": {
        "TRIPADVISOR_API_KEY": "<TRIPADVISOR_API_KEY>",
        "TRIPADVISOR_CACHE_TTL": "<TRIPADVISOR_CACHE_TTL>",
        "TRIPADVISOR_STATIC_CACHE_TTL": "<TRIPADVISOR_STATIC_CACHE_TTL>",
        "TRIPADVISOR_REQUEST_TIMEOUT_MS": "<TRIPADVISOR_REQUEST_TIMEOUT_MS>",
        "TRIPADVISOR_DEBUG_LOG": "<TRIPADVISOR_DEBUG_LOG>",
        "TRIPADVISOR_WS_PORT": "<TRIPADVISOR_WS_PORT>",
        "FETCHPROXY_WS_PORT": "<FETCHPROXY_WS_PORT>",
        "FETCHPROXY_WS_HOST": "<FETCHPROXY_WS_HOST>",
        "FETCHPROXY_IDENTITY_DIR": "<FETCHPROXY_IDENTITY_DIR>"
      }
    }
  }
}

起動コマンドnpx -y @chrischall/tripadvisor-mcp

設定が必要な環境変数

TRIPADVISOR_API_KEYシークレットYour TripAdvisor Terra API key (tripadvisor.com/developers). Needed by the Terra tools; the ta_web_* tools work without it.

TRIPADVISOR_CACHE_TTLSeconds to cache search responses (default: 300; `0` disables).

TRIPADVISOR_STATIC_CACHE_TTLSeconds to cache details/photos/reviews (default: 3600; `0` disables).

TRIPADVISOR_REQUEST_TIMEOUT_MSPer-request timeout for the optional browser bridge (default: 30000).

TRIPADVISOR_DEBUG_LOGSet to `1` to log browser-bridge requests to stderr.

TRIPADVISOR_WS_PORTBridge port override (default: FETCHPROXY_WS_PORT, else 37149). Tests only.

FETCHPROXY_WS_PORTLocalhost concentrator port (default 37149). On one machine every MCP shares the concentrator, so move it for ALL of them or not at all.

FETCHPROXY_WS_HOSTBind interface (default 127.0.0.1; a literal IP only, anything else is ignored). Keep on loopback — it exists for ONE topology: a hosted child in its own network namespace.

FETCHPROXY_IDENTITY_DIRWhere to store the long-term identity keypair (default ~/.fetchproxy/identity/; an absolute path only, anything else is ignored). Exists for a host that runs a separate child per caller, so they can share one identity.

ローカルサーバーにはマシン上の実行環境（Node.js 18 以上など）が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ

npm@chrischall/tripadvisor-mcp1.1.12stdio

ツール

掲載時のツール一覧 · 2 週間前に更新

パラメーター	型	必須	説明
page	integer	いいえ	ページインデックス（1 始まり）
size	integer	いいえ	1ページあたりの結果数（最大20件）
view	enum	いいえ	レスポンス形式："compact"（デフォルト）は、レスポンス内の他の場所にすでに含まれるフィールドを省略します。"full" は、このサーバーが認識するすべてのフィールドを返します。compact は、存在する場合は簡潔な投影を返し、それ以外では画像 URL を削除します。"full" は TripAdvisor の完全なレコードを返します。compact \| full
query	string	はい	場所名の検索に使用するテキスト
locale	array	いいえ	ローカライズされたフィールドに優先して使用するロケール（優先順位順。例：["en","es"]）
category	enum	いいえ	1つのカテゴリに限定しますRESTAURANT \| ATTRACTION \| HOTEL
geo_name	string	いいえ	検索範囲を限定する市、町、または国名
postal_code	string	いいえ	郵便番号/ZIP コード（geo_name より優先）
country_code	string	いいえ	Alpha-2 国コード（例："US"）

詳細

tripadvisor-mcp

TripAdvisor Terra API 用の MCP サーバーです。Claude 向けに旅行データを提供します。名前や座標でホテル、レストラン、観光スポットを検索し、詳細情報、写真、レビューを stdio 経由ですべて取得できます。（Terra は TripAdvisor の現行 API です。旧 Content 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/developers でキーを取得してください。無料の Discover プランは従量課金制（10 QPS、1 日あたり 10,000 回の呼び出し）です。応答はメモリ内にキャッシュされ、利用枠を節約できます。Terra キーであることを確認してください。旧 Content API キーでは 403 が返されます。

ツール

ツール	機能
`ta_search_locations`	名前でスポットを検索します（カテゴリ、国／地域／郵便番号で絞り込み可能）。ページネーションに対応し、`compact:true` で簡潔な概要を取得できます
`ta_search_nearby`	緯度／経度と半径、`location_id` と半径、または南西／北東の境界ボックス内からスポットを検索します（カテゴリ、最小評価、並べ替えに対応）。`compact:true` にも対応しています
`ta_get_location_details`	詳細情報を取得します。名称、説明、住所、座標、旅行者の評価、電話番号、掲載ページの URL が含まれます
`ta_get_locations`	一括取得します。複数のスポット ID の詳細を 1 回の呼び出しで取得できます（詳細取得を N 回呼び出すより低コストです）。`compact:true` にも対応しています
`ta_get_location_photos`	複数サイズの画像 URL、提供元、寸法を含む写真を取得します。ページネーションに対応しています
`ta_get_location_reviews`	旅行者のレビューを取得します。ページネーションに対応しています
`ta_web_healthcheck`	オプションの tripadvisor.com ブラウザブリッジ接続を診断します（以下を参照）
`ta_web_get_location`	ブラウザブリッジ経由で公開ページから取得したスポットの詳細（評価、住所、座標、電話番号、写真）です。API キーは不要です

すべてのツールは読み取り専用です。Terra には書き込み用エンドポイントがありません。

ブラウザブリッジ（オプション）

ta_web_healthcheck は、オプションの第 2 層にある最初のツールです。このツールは、ContextMint Bridge ブラウザ拡張機能を通じて、ログイン済みのブラウザタブから同一オリジンの fetch を中継し、tripadvisor.com の一般ユーザー向けサイトにアクセスします（サイトはボット対策によりサーバー側からは到達できません）。拡張機能はリリースページからインストールしてください（Chrome の場合、Chrome 用 zip をダウンロードし、開発者モードをオンにして chrome://extensions から展開済みの拡張機能を読み込みます。Safari 版はまだ利用できず、公開ダウンロードのない ContextMint アプリに同梱される予定です。現時点では Chrome をお使いください）。拡張機能のインストールと、初回のペアリング承認が必要です。上記の Content API ツールはブリッジを使用しません。

ContextMint Bridge は、同じメンテナーが新しい名前で提供する fetchproxy ブラウザ拡張機能です。fetchproxy の README（https://github.com/chrischall/fetchproxy#extension）にも記載されています。ソースコードは https://github.com/nullnet-app/contextmint-bridge で公開されています。自分でビルドするか、リリース zip を隣に公開されている .sha256 ファイルで検証してください（shasum -a 256 -c contextmint-bridge-chrome-<version>.zip.sha256）。

ta_web_get_location はこのブリッジを使い、公開されている TripAdvisor ページからスポットの詳細を直接取得するため、API キーなしで利用できます。観光スポット、ホテル、レストランに対応しています。中核となるビジネスデータ（評価、レビュー件数、住所、座標、電話番号、メイン写真、掲載ページ URL）を返しますが、個々のレビュー本文は取得しません。リクエスト形式は 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`	いいえ	オプションのブラウザーブリッジに対するリクエストごとのタイムアウトです（デフォルト：30000）。
`TRIPADVISOR_DEBUG_LOG`	いいえ	`1` に設定すると、ブラウザーブリッジのリクエストが標準エラー出力に記録されます。

開発

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

エンドポイントのリクエスト形式は docs/TRIPADVISOR-API.md で固定されています。.env にキーを設定して node scripts/live-probe.mjs を実行すると、ビルド済みクライアントを通じてすべての読み取りパスをテストできます。

ライセンス

MIT

Markdown 対応

ログインしてコメント

基本情報

作者: chrischall
言語: node
バージョン: 1.1.12
トランスポート: stdio
掲載日: 2026年10月17日
最終更新: 5 日前
公式 Registry: io.github.chrischall/tripadvisor-mcp

問題を報告

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

入門ガイドを読む

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。

tripadvisor-mcp

tripadvisor-mcp について

主な機能

活用シーン

MCP 対応

設定

ツール

詳細

tripadvisor-mcp

クイックスタート

ツール

ブラウザブリッジ（オプション）

環境

開発

ライセンス

コメント

MCP は初めてですか？

MCP（Model Context Protocol）とは？

MCP サーバーとクライアントの違いは？

ローカルとリモート、どちらを選ぶべき？

Claude や Cursor にサーバーを導入するには？

掲載プロジェクトは審査されていますか？「認証済み」とは？

自分のプロジェクトが掲載されています。どう申請できますか？