HasData Yelp

Yelp MCP サーバー

Claude、Cursor、Windsurf、その他すべての MCP クライアントに、3 つの読み取り専用 Yelp ツールを提供するホスト型 Model Context Protocol（MCP）サーバーです。キーワードと地域でビジネスを検索したり、1 件のビジネスの詳細をすべて取得したり、レビューのフィード全体をページ分割して取得したりできます。すべて構造化 JSON で取得でき、Yelp Fusion キーもホスト環境も不要です。

サインアウトした訪問者が閲覧できる公開 Yelp ページを、41 の地域ドメインすべてで読み取ります。

毎月 1,000 クレジット無料、カード登録不要。10 クレジットの料金なら、Yelp を 100 回呼び出せます。

https://mcp.hasdata.com/mcp?apis=yelp

• プロンプトとリソース

目次

• 必要なもの
• クイックスタート
• プロンプトの例
• ツール
• エラーと失敗時の処理
• 料金、無料枠、制限
• ツールの選択
• 他のツールとの比較
• よくある質問
• HasData のリンク
• 開発
• 貢献
• ライセンス

必要なもの

MCP クライアントと、ダッシュボードから取得できる HasData API キーが必要です。カード登録不要で無料で作成でき、無料枠では 10 クレジットの料金で月に約 100 回呼び出せます。これはリモートサーバーなので、最も簡単な方法は URL と x-api-key ヘッダーを使うことで、コンテナを実行する必要はありません。stdio のみを話すクライアントからは、下記の薄いランチャーを介して接続します。このランチャーは npm では @hasdata/yelp-mcp、PyPI では hasdata-yelp-mcp として公開されています。

クイックスタート

サーバー URL はすべてのクライアントで同じです。Claude Code と Claude Desktop では、実際に動作させる手順を紹介します。その他のブロックは、それぞれのクライアントで公開されているリモートサーバー向けの形式に従っています。

OAuth に対応したクライアントでは、同じ URL をコネクターとして追加し、設定ファイルにキーを記述せずにサインインできます。

claude mcp add --transport http yelp "https://mcp.hasdata.com/mcp?apis=yelp" \
  --header "x-api-key: HASDATA_API_KEY"

{
  "mcpServers": {
    "yelp": {
      "command": "npx",
      "args": ["-y", "@hasdata/yelp-mcp"],
      "env": { "HASDATA_API_KEY": "YOUR_KEY" }
    }
  }
}

{
  "mcpServers": {
    "yelp": {
      "command": "uvx",
      "args": ["hasdata-yelp-mcp"],
      "env": { "HASDATA_API_KEY": "YOUR_KEY" }
    }
  }
}

{
  "mcpServers": {
    "yelp": {
      "url": "https://mcp.hasdata.com/mcp?apis=yelp",
      "headers": { "x-api-key": "HASDATA_API_KEY" }
    }
  }
}

{
  "mcpServers": {
    "yelp": {
      "serverUrl": "https://mcp.hasdata.com/mcp?apis=yelp",
      "headers": { "x-api-key": "HASDATA_API_KEY" }
    }
  }
}

{
  "servers": {
    "yelp": {
      "type": "http",
      "url": "https://mcp.hasdata.com/mcp?apis=yelp",
      "headers": { "x-api-key": "HASDATA_API_KEY" }
    }
  }
}

プロンプトの例

これらのプロンプトはそれぞれ 1 つのツールを呼び出します。2 つ目のツールが 1 つ目のツールから返される識別子を必要とする場合は、順に 2 つのツールを呼び出します。

• テキサス州オースティンのコーヒー焙煎所を検索し、評価とレビュー数を基準に順位付けしてください。
• Yelp のビジネス desnudo-coffee-austin の営業時間、電話番号、ウェブサイトを取得してください。
• このビジネスの星 1 つと 2 つのレビューをすべて読み、苦情をテーマごとに分類してください。
• Yelp ではこの店の人気メニューとしてどの料理が挙げられていますか。また、レビュー投稿者はそれらについて何と言っていますか。
• 同じ近隣エリアにあるこの 3 つの競合店の評価分布を比較してください。
• Yelp がこのビジネスについておすすめしていないレビューと、おすすめしているレビューとの違いを見せてください。

Yelp ID ではなく店名を指定するプロンプトでは、ID を特定する検索と、その情報を読むための店舗情報またはレビューの検索の 2 回の呼び出しが必要です。検索ツールは placeId と placeAlias の両方を返し、どちらも店舗情報ツールの placeId 引数として使用できます。

ツール

3 つのツールを利用でき、呼び出しが成功するごとに 10 クレジットを消費します。すべてのツールは domain を指定して国を切り替えられます。www.yelp.com から、各言語向けの fr.yelp.ca や zh.yelp.com.hk などのサイトを含む、ヨーロッパ、アジア、ラテンアメリカのサイトまで、41 の値に対応しています。

Yelp の検索結果を取得

hasdata_yelp_search_getSearchResults

場所を指定してキーワードを検索した場合のビジネス一覧ページです。

searchInformation には、検索に使用した keyword と location、および totalResults が返されます。また、有料掲載の ads 配列、organicResults 配列、currentPage、perPage、totalPages、nextPageUrl、otherPagesUrls を含む pagination が返されます。

2 つの結果配列の構造は異なります。オーガニック検索結果には position と streetAddress が含まれますが、広告にはこれらが含まれず、phone と、Yelp が広告主に表示するバッジの highlights 配列が追加されます。どちらの配列にビジネスが含まれていたかを確認せずに配列を結合すると、有料掲載が検索順位として扱われてしまいます。

{
  "position": 2,
  "placeId": "oiJ7QuhhpsEpe9zFTZF0bA",
  "placeAlias": "desnudo-coffee-austin",
  "url": "https://www.yelp.com/biz/desnudo-coffee-austin",
  "title": "Desnudo Coffee",
  "streetAddress": "2505 Webberville Rd, Austin",
  "price": "$$",
  "categories": [{ "title": "Coffee Roasteries", "url": "https://www.yelp.com/search?find_desc=Coffee+Roasteries&find_loc=Austin%2C+TX" }],
  "snippet": "My favorite coffee shop to go to ever! Everyone must go. [[HIGHLIGHT]]Great coffee[[ENDHIGHLIGHT]], great vibes,great customer...",
  "rating": 4.7,
  "reviews": 347,
  "thumbnail": "https://s3-media0.fl.yelpcdn.com/bphoto/0nE_IcbRiyxrw3kk2z6owg/ls.jpg",
  "allImagesUrl": "https://www.yelp.com/biz_photos/oiJ7QuhhpsEpe9zFTZF0bA"
}

Yelp の場所の詳細を取得

hasdata_yelp_place_getPlaceDetails

1 件のビジネスの詳細情報です。

placeResult オブジェクトには、name、url、address、neighborhoods、country、phone、website、price、categories、rating、reviews、isClaimed、isClaimable が含まれます。また、1 週間分の hours と today を含む operationHours オブジェクト、features 配列、popularDishes を含む menu オブジェクト、Yelp の利用者が質問し、回答を得た内容を含む faqs 配列、Yelp がページ上部に固定表示するフレーズの reviewHighlights 配列、images 配列、静的地図画像の URL である businessMap も返されます。

features は設備・サービスの一覧で、各エントリには title と isActive フラグが含まれます。そのため、値が false のエントリは、設備・サービスが不明なのではなく、存在しないと Yelp が示していることを意味します。フィルター処理ではこの違いが重要です。false のエントリを除外するクエリと、値が欠落しているエントリを除外するクエリは同じではありません。

{
  "name": "Desnudo Coffee",
  "url": "https://www.yelp.com/biz/desnudo-coffee-austin",
  "address": "2505 Webberville Rd Austin, TX 78702",
  "neighborhoods": "East Austin",
  "country": "US",
  "phone": "(424) 400-1857",
  "website": "http://www.desnudocoffee.com",
  "price": "$$",
  "categories": ["Coffee Roasteries"],
  "rating": 4.7,
  "reviews": 347,
  "isClaimed": true,
  "isClaimable": false,
  "operationHours": { "hours": [{ "day": "Mon", "hours": ["7:00 AM - 2:00 PM"] }] },
  "features": [
    { "title": "Offers delivery", "isActive": true },
    { "title": "ADA-compliant restroom", "isActive": false }
  ],
  "menu": {
    "section": "Popular Drinks",
    "popularDishes": [{ "name": "Brown Sugar Miso Latte", "rating": 4.7, "reviews": 113, "photos": 71 }]
  }
}

Yelp の店舗レビューを取得

hasdata_yelp_reviews_getPlaceReviews

1 つの店舗のレビュー一覧を全文で取得します。並べ替え、絞り込み、ページネーションに対応しています。

店舗名、エイリアス、URL、totalResults、rating、reviewCountsByRating 配列、reviewCountsByLanguage の内訳、pagination オブジェクト、reviews 配列を含む searchInformation を返します。

各レビューには、position、id、link、user オブジェクト、text と検出された language を含む comment オブジェクト、date、rating が含まれます。レビュアーが添付している場合は、photos、videos、reactions も含まれます。user オブジェクトには、name、userId、address、累計の reviews 数、friends 数、photos 数、および Yelp Elite メンバーの場合は eliteYear が含まれます。

投稿者が後から書き直したレビューには、以前のバージョンを格納した previousReviews も含まれます。以前のバージョンには、独自のテキスト、評価、日付が記録されています。評価が変わったかどうかを確認する場合は、このフィールドを参照してください。現在のレビューだけでは判断できません。

{
  "position": 1,
  "id": "7zLIm3c2v2hRBVmgaKkR7w",
  "link": "https://www.yelp.com/biz/desnudo-coffee-austin?hrid=7zLIm3c2v2hRBVmgaKkR7w",
  "user": {
    "name": "Karson S.",
    "userId": "3LxSs_dQ37-LBRz07EDbyg",
    "address": "Austin, TX",
    "reviews": 374,
    "friends": 61,
    "photos": 875,
    "eliteYear": "26"
  },
  "comment": { "text": "Coming back to Desnudo to update my old review...", "language": "en" },
  "date": "2026-08-20T17:33:47-05:00",
  "rating": 5,
  "photos": [{ "link": "https://s3-media0.fl.yelpcdn.com/bphoto/YbjFKmRf7j0ejQQSaqtqVw/o.jpg", "caption": "Matcha latte", "width": 1126, "height": 2000 }],
  "reactions": [{ "type": "HELPFUL", "label": "Helpful", "count": 1 }],
  "previousReviews": [{ "id": "0WNI2IG7K1_Dg9zdXm03SA", "rating": 4, "comment": { "text": "..." } }]
}

プロンプトとリソース

サーバーには 1 つのプロンプトが用意されています。クライアントが、ユーザーにツール呼び出しを作成してもらう代わりに提示できる、すぐに使えるワークフローです。

また、サーバーは、受け付ける値が固定リストになっているパラメーターごとに 1 つずつ、2 つのリソースを公開しています。拒否された呼び出しから値の一覧を把握するより、リソースを読み取るほうが簡単で、クレジットも消費しません。各 URI は hasdata://yelp/<parameter> です。

どちらのリストも API キーなしで提供されるため、ユーザーが登録する前にクライアントから読み取ることができます。

エラーと失敗時の処理

正常に動作する場合だけを想定せず、以下のケースも考慮してください。

一致する結果がない検索でも、エラーではなく空の organicResults 配列を含む成功結果が返ります。requestMetadata.status は引き続き ok です。反復処理を行う前に、配列の長さを確認してください。

snippet は整形済みテキストではなく、マークアップ付きのテキストです。Yelp は一致した語句を [[HIGHLIGHT]] と [[ENDHIGHLIGHT]] で囲み、これらのマーカーはそのまま返されます。スニペットをインデックス化、埋め込み、表示する前に削除してください。

カテゴリ URL は HTML エスケープされています。categories エントリ内の url には、ページ上での表記に合わせて、通常のアンパサンドではなく & が含まれています。リンク先に移動する前に、エスケープを解除してください。

レビュー用ツールでは、rating と query を併用できません。自由入力のクエリを実行すると、Yelp は星評価によるフィルターを無視するため、すべての評価のレビューが返されます。両方が必要な場合は、結果を自分で絞り込んでください。

start と nextPageToken はページネーションの別々の方法であり、併用できません。どちらか一方を渡してください。トークンにはオフセットとページサイズの両方が含まれているため、トークンだけを再送すればフィードの続きを取得できます。一方、start を使う場合は、呼び出し間で位置を維持するために num も指定する必要があります。

おすすめしないレビューのフィードは、別の制限が適用される別フィードです。notRecommended を設定すると、Yelp がメインリストから除外したレビューが返されます。取得件数は49件ではなく一度に10件で、写真、動画、リアクションは付属しません。

ビジネスが未登録の場合があり、未登録ページの情報は限られています。isClaimed が false の場合、通常はウェブサイト、営業時間、アメニティがありません。これらの情報は誰も入力していないためです。フィールドが欠けていることをスクレイピングの失敗と判断する前に、このフラグを確認してください。

データを含む結果には、サポートへの問い合わせ時に伝えると役立つ requestMetadata.id も含まれます。

料金、無料枠、制限

Yelp の各ツールは、呼び出しが成功するごとに10クレジットを消費します。レスポンスのサイズによって料金は変わらないため、49件のレビューがあるページも5件のページも同じ料金です。したがって、フィードを読むには最大ページを取得するのが最もお得です。

無料枠では、カード登録不要で毎月1,000クレジットを利用でき、基本料金で100回の Yelp 呼び出しが可能です。請求サイクルごとに更新されるため、呼び出し頻度の低いエージェントなら、無料枠を期限なく使い続けられます。

有料プランは、200,000クレジット（20,000回の呼び出し）が含まれる月額59ドルから始まります。利用量が増えるほど単価は下がり、エントリープランでは1,000回の呼び出しあたり2.95ドル、Basic では1.19ドル、Growth の各プランでは0.83ドルです。最新の料金は料金ページをご覧ください。

プランによって同時実行数も異なります。無料枠では一度に1件、Startup では5件、Basic では15件、Growth の各プランでは50～500件を実行できます。無人で動かす場合は、429 が返されたときにバックオフして再試行してください。ビジネスのリストに対して並列実行するエージェントは、気付く前に上限に達します。

200 以外のステータスで返されたリクエストには課金されません。結果が見つからなかった場合も、成功した呼び出しは課金対象です。

ツールの選び方

まず、プロンプトに何が含まれているかを確認してください。キーワードと場所がある場合は検索ツール、Yelp ID またはエイリアスがある場合は場所用ツール、顧客の声についての質問ならレビュー用ツールを使います。すでに ID がわかっているのに検索呼び出しをして ID を取得するのは、最もありがちな無駄です。

次に、質問の内容に応じて選びます。場所用ツールでは、ビジネス自体、営業時間、アメニティ、価格帯、概要評価について回答できます。レビュー用ツールでは顧客についての質問に回答でき、レビュー本文、投稿者、評価の分布を返すのはこのツールだけです。場所用ツールの reviewHighlights ブロックは Yelp が選んだレビューのサンプルであり、フィードの代わりにはなりません。

フィードは最大ページで読み取ってください。num はデフォルトで最大値の49に設定されているため、意図的にサンプルを取得する場合を除き、そのままにしておいてください。

比較

Yelp 独自の Fusion API は、このデータを取得するための公式な方法ですが、これは別の手段です。

判断の決め手となるのは、レビュー本文です。Fusion が返すのはビジネスごとに 3 件の抜粋で、店舗ページ上の表示に関する問いには答えられますが、感情、苦情、評価がどう変化したかといった分析上の問いには答えられません。3 件の抜粋と公式な契約が必要な場合は、Fusion のほうが適しています。

よくある質問

Yelp 公式の MCP サーバーはありますか？

Yelp は公式の MCP サーバーを公開していません。このサーバーは HasData が保守しており、公開されている Yelp のページを読み取ります。

Yelp MCP サーバーとは何ですか？

MCP サーバーは、AI クライアントが呼び出せるツールを公開します。このサーバーは Yelp の検索結果、ビジネスページ、レビューのフィードを、ブラウザーやスクレイピングライブラリをスタックに追加せずに、エージェントが推論に使える JSON に変換します。

Yelp アカウントや Fusion キーは必要ですか？

いいえ。必要な認証情報は HasData のキーのみです。

対応している Yelp サイトはどれですか？

API が受け付ける 41 個すべてのドメインに対応しています。www.yelp.com から、ヨーロッパ、アジア、ラテンアメリカの各サイトまで含まれます。複数のドメインがある国もあり、言語ごとに分かれています。たとえば、fr.yelp.ca と www.yelp.ca があります。domain を渡すと切り替えられます。

ビジネスのレビューをすべて取得できますか？

はい。ページを順に取得できます。フィードは一度に 49 件を返し、pagination.hasNextPage で終了するタイミングがわかります。レビューが 347 件あるビジネスを読み込むには、8 回の呼び出しが必要です。

おすすめレビューとおすすめ対象外のレビューの違いは何ですか？

Yelp は、一部のレビューをメインのフィードに表示しないソフトウェアを使用しています。デフォルトのレスポンスはおすすめレビューのフィードで、訪問者に表示されるものです。notRecommended を設定すると、代わりに非表示のレビューが返されます。このフィードは件数が少なく、1 ページあたり 10 件で、写真やリアクションは含まれません。

評価のフィルターを指定したのに、すべての評価が返されたのはなぜですか？

同時に query が設定されていたためです。Yelp はテキスト検索を実行すると星評価のフィルターを無効にするため、サーバー側ではこの 2 つを組み合わせられません。

ほかの HasData API と併用できますか？

はい。1 つのキーですべての API を利用でき、1 つのエンドポイントから apis パラメーターを通じて呼び出せます。クライアントを ?apis=yelp,google_maps に接続すると、1 つの接続で両方のツールセットを利用できます。または、すべてのカタログを利用するには mcp.hasdata.com/mcp に接続してください。

HasData は Yelp と提携していますか？

いいえ。HasData は独立したサービスであり、Yelp と提携、推奨、後援関係にありません。Yelp はそれぞれの所有者の商標です。ツールは一般に公開されているデータのみを扱います。結果を Yelp の利用規約および適用される法律に従って使用する責任は、お客様にあります。

コンプライアンスと個人データ

レビューのツールは個人データを返します。レビューには、投稿者の表示名、プロフィール写真、申告した所在地、ユーザー ID、プロフィールへのリンクが含まれます。また、レビュー投稿者はビジネスではなく個人です。そのため、ビジネスの掲載情報とは異なり、このレスポンスは GDPR および CCPA の適用範囲に含まれます。保存する前に必要な情報を見極め、目的上必要な期間を超えて保持せず、ご自身の義務を確認してください。集計分析では、投稿者の情報が不要なことも少なくありません。

HasData のリンク

• Yelp スクレイパー API、これらのツールの基盤となる REST エンドポイント
• API ドキュメント
• MCP サーバーのドキュメント
• 料金
• ダッシュボード

その他の HasData MCP サーバー：Google Search、Google Maps、Google Trends、Google Flights、DuckDuckGo、YouTube、TikTok、Instagram、Amazon、Zillow、Airbnb、Booking.com、Indeed。

開発

ランチャーはリモートサーバーへのシンプルな stdio ブリッジなので、ビルドは不要です。

npm install
HASDATA_API_KEY=your_key_here npm test

test/ のテストでは、コミットがなくても変更される可能性があるツールの契約を検証します。?apis=yelp が期待される数のツールを返すこと、名前が変更されていないこと、すべてのツールで必須パラメーターが宣言され説明が付いていること、使用中のキーが実際に受け入れられることを確認します。最後の検証ではツールを実際に呼び出すため、10 クレジットかかります。これは、適切な理由で失敗する可能性のあるカナリアテストの料金です。

上流のツール一覧はこのリポジトリに変更がなくても変わる可能性があるため、契約テストスイートはスケジュールに従って毎週実行されます。

コントリビューション

ツールの表、レスポンス例、または実態と異なるドキュメントの記述があれば、Issue を作成してください。そのためのテンプレートがあります。同様の内容や、ランチャーに関するあらゆる内容について、プルリクエストも歓迎します。

ライセンス

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