yelpdata

yelpdata

yelpdata は、ホストされている HasData Yelp MCP サーバーへの小規模なローカルブリッジです。Yelp のビジネスデータを JSON で返します。場所とキーワードを指定してビジネスを検索したり、 Yelp ID またはエイリアスを使ってビジネスの詳細情報を取得したり、 そのビジネスの公開レビュー一覧を読み取ったりできます。 取得できるのは、名前、住所、ビジネスが公開している電話番号と ウェブサイト、価格帯、カテゴリ、総合評価、 レビュー件数、営業時間、および公開されている投稿者の表示名とともに掲載された レビュー本文です。

このブリッジは独自のビジネスデータを保持しません。 ツール一覧には、ライブエンドポイントから取得した内容をそのままローカルで返し、 各ツール呼び出しは上流に転送して、返された内容を変更せずに返します。取得した 機能は、ビジネスが公開したデータと公開レビューを読み取る3つの読み取り専用 フェッチ機能です。予約、注文、メッセージ送信、支払いのツールは含まれておらず、 Yelp でビジネスまたは投稿者が公開した情報を超える個人の連絡先データも 含まれていません。

ツール

• hasdata_yelp_search_getSearchResults — Yelp のビジネスを検索します。必須項目：keyword と location。 任意項目：l（g:lon1,lat1,lon2,lat2 形式の地図範囲文字列）、 domain（検索対象の各国版 Yelp サイト）、および start（ページ送り用の 検索結果オフセット）。Yelp のエイリアス／ID、名前、カテゴリ、評価、 レビュー件数、価格帯、サムネイルを含む、関連度順のビジネス一覧を返します。 詳細レコードを取得するには、返されたエイリアスを place ツールに渡します。
• hasdata_yelp_place_getPlaceDetails — 1件のビジネスの詳細情報を取得します。必須項目：placeId（Yelp ID または Yelp エイリアス）。任意項目：domain。名前、 住所、電話番号、ウェブサイト、価格帯、カテゴリ、 総合評価、レビュー件数、営業時間、アメニティ、 写真、注目レビューを返します。
• hasdata_yelp_reviews_getPlaceReviews — 1件のビジネスのレビュー一覧を読み取ります。必須項目：placeId。 任意項目：domain、query（レビュー内の自由記述検索）、 sortBy（relevanceDesc、dateDesc、dateAsc、ratingDesc、ratingAsc、elitesDesc）、 rating（星評価のフィルター。カンマ区切りで複数の値を指定可能）、 languageCode、notRecommended（Yelp が現在おすすめしていないレビューを返すかどうか）、および start／num によるページ送り、または前回の応答で返された不透明な nextPageToken。各レビューには、公開されている投稿者プロフィール、全文、 星評価、タイムスタンプ、写真と動画、 読者のリアクション、投稿がある場合はオーナーの返信が含まれます。また、 評価別および言語別のビジネスのレビュー総数も返します。

設定

• HASDATA_YELP_MCP_URL（任意）— 上流エンドポイントを上書きします。デフォルトは https://mcp.hasdata.com/mcp?apis=yelp です。（この 上書き用フックは、この再構築版独自のラベル付き再現です。）
• HASDATA_API_KEY（任意）— 設定すると、すべての 上流リクエストに、呼び出し元自身の HasData API キーを指定した x-api-key: <key> ヘッダーが付与されます。設定されていない場合、キーのヘッダーは送信されません。（ヘッダー 名と環境変数名は、元のレジストリレコードで固定されています。この環境変数から キーを転送する機能はラベル付きの再現です。元の機能はキーなしで 取得されています。）

転送の仕組み

最初のツール呼び出し時に、クライアントは上流とのストリーム可能な HTTP セッションを開きます。まず JSON-RPC の initialize リクエストを送信し （protocolVersion 2025-03-26、clientInfo name yelpdata）、続けて notifications/initialized 通知を送信し、その後、呼び出し元の引数を変更せずに含めた tools/call リクエストを送信します。上流が Mcp-Session-Id ヘッダーを含めて initialize に応答すると、その値はセッションの後続リクエストすべてに付与され、 プロセスが終了するまでそのセッションが再利用されます。 応答は通常の JSON またはサーバー送信イベントとして届く場合があり、どちらも読み取ります。

上流からの成功結果は、上流が設定した isError フラグを含め、 一切変更せずにそのまま渡されます。 失敗（JSON-RPC エラー、2xx 以外のステータス、読み取れない応答、 または完了できないリクエスト）は、テキストが yelpdata error: で始まる isError 結果として返されます。（この形式での返却は、 この再構築版独自のラベル付き再現です。）

CLI

各ツールは、1 つの JSON 引数文字列を受け取るサブコマンドでもあります。

npx @reneturcios/yelpdata hasdata_yelp_search_getSearchResults '{"keyword":"coffee","location":"Seattle, Washington"}'
npx @reneturcios/yelpdata hasdata_yelp_place_getPlaceDetails '{"placeId":"mcdonalds-new-york-386"}'
npx @reneturcios/yelpdata hasdata_yelp_reviews_getPlaceReviews '{"placeId":"-4ofMtrD7pSpZIX5pnDkig","sortBy":"dateDesc"}'
npx @reneturcios/yelpdata --version

終了コード：成功時は 0、isError の結果の場合は 1、使用方法に誤りがある場合は 2 です。

MCP サーバー

npx -y @reneturcios/yelpdata mcp

MCP クライアントの設定：

{
  "mcpServers": {
    "yelpdata": {
      "command": "npx",
      "args": ["-y", "@reneturcios/yelpdata", "mcp"]
    }
  }
}

Docker

docker run -i ghcr.io/cloudcorprecords/yelpdata
docker run --rm ghcr.io/cloudcorprecords/yelpdata --version

コンテナのデフォルトコマンドは mcp であるため、最初の形式では stdio MCP サーバーとして動作します。それ以外の引数は通常どおり CLI に渡されます。

開発

npm install
npm run build
npm test
npm run dev

テストスイートはすべてスタブ化された JSON-RPC アップストリームに対して実行され、実際のネットワーク呼び出しは行いません。

ライセンス

MIT — LICENSE を参照してください。