mcpField
Y
yelp

yelp

github.com/fetcher-sh数据与数据库23.8k 次安装8 周前更新
代码仓库

关于 yelp

面向 Agent 的 Yelp 数据技能，可搜索本地商户并获取商户详情和评论。它提供 HTTP GET 接口及 MCP 连接，适用于处理位置相关商户信息的场景。

主要功能

  1. 01按关键词和地点搜索商户
  2. 02按评分或评论数排序
  3. 03按 ID 或 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 请求，按量付费。无需申请 Yelp Fusion API 应用审批，没有每日调用上限，也无需填写 API 密钥申请表。

基础 URL：https://yelp.fetcher.sh

身份验证

两种付费方式，数据相同——完整机制请参阅 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，每次调用 $0.003）

端点返回内容
/api/search匹配查询词和位置的商家
/api/place/{id}按 ID 获取商家的完整详情
/api/place/handle/{handle}按 Yelp URL 句柄/slug 获取商家的完整详情
/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 句柄/slug 获取商家详情：

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 的快捷工具。移除 headers 块即可通过 x402 按次付费——完整流程请参阅 fetcher 技能。

错误

  • 400 — 缺少或参数无效（消息会指出参数名称）
  • 401 — 密钥未知或已轮换
  • 402 — 需要付款（x402 挑战）或 topup_required（额度已用尽）
  • 404 — 非计价路径
  • 无速率限制；上游故障不退款（先结算，再交付）

参考

评论

支持 Markdown