mcpField
G
google-reviews

google-reviews

github.com/openclaudia营销与增长722378 次安装1 周前更新
代码仓库

关于 google-reviews

通过调用 DataForSEO API 的脚本，获取 Google Maps 商家的评分、评论数、评分分布和商家信息。支持单个查询及批量搜索，可用于查看和比较商家评论。

主要功能

  1. 01获取评分和评论数
  2. 02返回评分分布及商家信息
  3. 03支持单个或多个商家搜索
  4. 04输出 JSON 和批量表格
  5. 05按地点查询商家

适用场景

  1. 01查看商家的 Google Maps 评论
  2. 02比较多个商家的评分
  3. 03为报告收集评论数据

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/openclaudia/openclaudia-skills --skill google-reviews

安装后在 Claude Code 中输入/google-reviews确认已加载。

详细介绍

Google Reviews

使用 DataForSEO API 获取任意商家的 Google Maps 评分、评论数和评分分布。

适用场景

当用户有以下需求时，使用此工具：

  • 要求查看某家商家的 Google 评论
  • 想比较多家商家的评分
  • 需要获取 Google 评论数，用于报告或分析
  • 询问某家商家在 Google Maps 上的展示情况
  • 想审查竞争对手的评论

工具位置

全局工具目录：~/.agents/tools/

  • 脚本：~/.agents/tools/fetch-google-reviews.js
  • 凭据（首选）：环境变量中的 AISA_ONE_API_KEY——通过 aisa.one 代理
  • 凭据（备用）：环境变量中的 DATAFORSEO_LOGIN 和 DATAFORSEO_PASSWORD——直接连接 DataForSEO。脚本会自动检测已设置的凭据。

用法

单个商家
cd ~/.agents/tools && node fetch-google-reviews.js "Business Name" "City,Province,Country"

示例：

cd ~/.agents/tools && node fetch-google-reviews.js "Trust Auto Sales" "Richmond,British Columbia,Canada"
批量模式

创建一个包含商家数组的 JSON 文件，然后运行：

cd ~/.agents/tools && node fetch-google-reviews.js --batch /path/to/businesses.json

JSON 文件格式：

[
  {"keyword": "Business One", "location": "Vancouver,British Columbia,Canada"},
  {"keyword": "Business Two"}
]
  • keyword（必填）：要搜索的商家名称
  • location（可选）：默认为 "Richmond,British Columbia,Canada"

输出

单个商家（JSON）
{
  "keyword": "Trust Auto Sales",
  "title": "Trust Auto Sales",
  "rating": 4.2,
  "reviews": 677,
  "rating_distribution": {"1": 117, "2": 7, "3": 3, "4": 19, "5": 531},
  "address": "3691 Number 3 Rd, Richmond, BC V6X 2B8",
  "category": "Car dealer",
  "url": "https://trustauto.ca/"
}
批量模式

输出一个 Markdown 表格，后接完整 JSON：

| Business | Rating | Reviews | Address |
|----------|--------|---------|---------|
| Trust Auto Sales | 4.2 | 677 | 3691 Number 3 Rd, Richmond, BC V6X 2B8 |

位置格式

使用 DataForSEO 的位置格式：City,Province/State,Country

示例：

  • Richmond,British Columbia,Canada
  • Vancouver,British Columbia,Canada
  • Toronto,Ontario,Canada
  • New York,New York,United States

API 详情

  • 使用 DataForSEO business_data/google/my_business_info/live 端点
  • 设置 AISA_ONE_API_KEY 时，通过 aisa.one 代理路由（api.aisa.one/apis/v1/dataforseo/...，Bearer 身份验证）；否则回退到直接连接 api.dataforseo.com/v3/...（Basic 身份验证）
  • 同步执行（立即返回结果）
  • 返回与关键词和位置匹配的首个商家
  • 批量模式会在请求之间增加 200ms 延迟，以避免触发速率限制

重要说明

  • 如果尚未运行 npm install：cd ~/.agents/tools && npm install
  • 脚本会从本地 .env 文件和环境变量中加载凭据
  • DataForSEO 按 API 调用次数收费——处理大批量请求时请注意

评论

支持 Markdown