mcpField
Y
yelp

yelp

github.com/fetcher-shデータ・データベース23.8k 回インストール8 週間前に更新
リポジトリ

yelp について

Yelpで地域の店舗を検索し、詳細やレビューを取得するデータスキルです。位置に基づく店舗情報を扱うAgent向けに、HTTP GETエンドポイントとMCP接続を提供します。

主な機能

  1. 01キーワードと場所で店舗検索
  2. 02評価またはレビュー数で並べ替え
  3. 03IDまたはYelp handleで詳細取得
  4. 04店舗レビューのページ取得

活用シーン

  1. 01指定した都市のレストラン検索
  2. 02評価やレビュー数による店舗比較
  3. 03店舗に対する顧客の感想確認

MCP 対応

https://yelp.fetcher.sh/mcp から接続します。MCPクライアントはエンドポイント情報の確認や残高照会に加え、有料ツールで店舗・レビュー情報を取得できます。

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/fetcher-sh/fetcher-skills --skill yelp

インストール後、Claude Code で/yelpを入力して読み込まれたか確認します。

詳細

Yelp API

地域のビジネス検索、ビジネスの詳細、レビューをクリーンな JSON で取得できます。呼び出しごとに通常の HTTP GET を 1 回実行し、使った分だけ支払います。Yelp Fusion API アプリの承認も、1 日あたりの呼び出し上限も、API キー申請フォームも不要です。

ベース URL：https://yelp.fetcher.sh

認証

支払い方法は 2 種類ありますが、取得できるデータは同じです。詳しい仕組みについては、fetcher スキルをご覧ください。

# 1. Prepaid credits (recommended — get a key at https://fetcher.sh/topup
#    or via POST /api/credits/topup, see the fetcher skill)
export FETCHER_API_KEY="bby_live_xxxxxxxxxxxx"
curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  "https://yelp.fetcher.sh/api/search?query=ramen&location=San+Francisco"

# 2. x402 pay-per-call — omit the header; a GET with no payment returns 402
#    with machine-readable payment requirements (USDC on Base, Polygon,
#    Arbitrum, Monad, or Solana). @x402/fetch signs and retries automatically.

すべてのレスポンスは { "status": number, "message": string, "data": ... } 形式です。HTTP ステータスは status と同じ値になります。

エンドポイント（4 種類 — すべて GET、1 回あたり $0.003）

エンドポイント返される内容
/api/searchクエリと場所に一致するビジネス
/api/place/{id}ID によるビジネスの全詳細
/api/place/handle/{handle}Yelp の URL ハンドル／スラッグによるビジネスの全詳細
/api/place/{id}/reviewsビジネスのレビュー

検索では query と location が必須です。sortBy（recommended、rating、reviewCount）と page は省略可能です。レビューでは page を指定できます。

シナリオ

評価の高い順：

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  --data-urlencode "query=ramen" -G \
  --data-urlencode "location=San Francisco" \
  --data-urlencode "sortBy=rating" \
  "https://yelp.fetcher.sh/api/search"

レビュー数の多い順：

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  --data-urlencode "query=tacos" -G \
  --data-urlencode "location=Austin, TX" \
  --data-urlencode "sortBy=reviewCount" \
  "https://yelp.fetcher.sh/api/search"

ID、または Yelp の URL ハンドル／スラッグによるビジネスの詳細：

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  "https://yelp.fetcher.sh/api/place/gary-danko-san-francisco"

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  "https://yelp.fetcher.sh/api/place/handle/gary-danko-san-francisco"

ページ分割されたビジネスのレビュー：

curl -H "Authorization: Bearer $FETCHER_API_KEY" \
  --data-urlencode "page=2" -G \
  "https://yelp.fetcher.sh/api/place/gary-danko-san-francisco/reviews"

MCP

{
  "mcpServers": {
    "yelp": {
      "url": "https://yelp.fetcher.sh/mcp",
      "headers": { "Authorization": "Bearer bby_live_..." }
    }
  }
}

無料：search_endpoints、describe_endpoint、check_balance。有料：fetch_data（上記の任意のエンドポイント）、topup_credits、および名前付きショートカットの yelp_search。代わりに x402 で呼び出しごとに支払うには、headers ブロックを省略してください。詳しい手順については、fetcher スキルをご覧ください。

エラー

  • 400 — パラメーターが不足しているか無効です（メッセージに該当するパラメーターが示されます）
  • 401 — キーが不明、またはローテーションされています
  • 402 — 支払いが必要です（x402 チャレンジ）、または topup_required（クレジットを使い切りました）
  • 404 — 価格設定されたパスではありません
  • レート制限はありません。上流での障害に対する返金はありません（配信前に決済されます）

リファレンス

コメント

Markdown 対応