商业数据API服务

Yelp Fusion MCP Server提供商业搜索、评级、评论和市场调研数据访问服务,适用于市场研究和商业分析。

  • by shawndrake2
  • TypeScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 shawndrake2/mcp-yelp

使用说明

Yelp融合MCP服务器

访问Yelp业务数据,包括搜索、评级、评论和业务计数,以进行市场研究。

可用数据

  • 商业搜索 -按位置、类别、关键字查找企业
  • 业务详情 -评分、评论、工作时间、联系方式
  • 类别 -Yelp商业类别的完整列表
  • 商业举足轻重 -一个地区的总业务(市场规模)

设置

  1. 在以下位置创建应用程序:https://www.yelp.com/developers/v3/manage_app
  2. 从应用程序仪表板获取API密钥
  3. 添加到MCP配置中:
{
  "yelp": {
    "command": "node",
    "args": ["/path/to/yelp/dist/index.js"],
    "env": {
      "YELP_API_KEY": "your-api-key"
    }
  }
}

定价层次

层级 成本 每日通话 功能
新手 7.99/1000美元通话 300 基本搜索、业务详情
加 9.99美元/1000次通话 500 +评论端点
企业 14.99/1000美元通话 更多 +评论亮点

工具

search_businesses

按位置、类别或关键字搜索企业。

参数 必填 说明
地点 是 地点(例如,“纽约州纽约市”、“90210”)
term 否 搜索词(例如,“餐馆”、“水管工”)
categories 否 类别别名,逗号分隔(例如,“bars,french”)
价格 否 价格级别:“1”=$,“2”=$$,“3”=$$$,”4“=$$$$。逗号分隔多个
半径 否 搜索半径(米)(最大40000)
limit 否 返回的结果(最多50个,默认20个)
sortBy 否 “最佳匹配”、“评分”、“审核计数”、“距离”

例子: 在芝加哥找到评价很高的意大利餐厅

location: "Chicago, IL"
term: "italian"
categories: "restaurants"
sortBy: "rating"
limit: 10

get_business

获取特定业务的详细信息。

参数 必填 说明
businessId 是 Yelp企业ID(来自搜索结果)

退货: 姓名、评分、评论数、价格、类别、地址、电话、时间、照片

search_by_phone

通过电话号码查找企业。

参数 必填 说明
电话 是 带国家代码的电话(例如,“+14157492060”)

get_reviews

获取一家企业最多3条评论摘录。

参数 必填 说明
businessId 是 Yelp企业ID

注: 需要Plus级别(9.99美元/1000次通话)或更高。初学者层将收到错误消息。

list_categories

列出所有带有别名的Yelp业务类别。

参数 必填 说明
LOCALE NO LOCALE(默认值:“EN-US”)

使用案例: 查找在search_business中使用的类别别名

autocomplete

获取搜索词的自动补全建议。

参数 必填 说明
text 是 要自动完成的文本
纬度 否 位置上下文的纬度
经度 否 位置上下文的经度

count_businesses

获取市场规模的总业务计数。

参数 必填 说明
地点 是 地点(例如,“加利福尼亚州洛杉矶”)
类别 否 类别别名(例如,“餐馆”、“牙医”)

例子: 统计洛杉矶的汽车修理店

location: "Los Angeles, CA"
categories: "autorepair"

常见类别

别名 描述
餐馆 餐厅
酒吧 酒吧
咖啡 咖啡和茶
酒店 酒店
beautysvc 美容与水疗
自动修复 自动修复
牙医 牙医
医生 医生
律师 律师
房地产 房地产

速率限制

  • 因级别而异(300-500+个电话/天)
  • 每秒最多5个请求

文档

  • API文件:https://docs.developer.yelp.com/
  • 类别列表:https://www.yelp.com/developers/documentation/v3/all_category_list