用途:查询指定企业在 Google 地图上的评分、评论数量和评级分布,可用于对比多家商户评分、撰写报告、分析商户线上口碑或审计竞争对手评论。
主要能力:单次查询返回匹配企业的名称、评分、评论总数、1 至 5 星各级评论分布、地址、类别和网址;批量模式可一次处理多个商户,输出 Markdown 表格及完整 JSON。返回结果为同步响应,仅取关键词加地点匹配到的第一家商户。
使用方式:脚本位于 ~/.agents/tools/fetch-google-reviews.js。未安装依赖时先执行 cd ~/.agents/tools && npm install。单个商户执行 cd ~/.agents/tools && node fetch-google-reviews.js "Business Name" "City,Province,Country"。批量模式需准备包含 keyword(必填)和 location(可选,默认 Richmond,British Columbia,Canada)的 JSON 数组文件,执行 node fetch-google-reviews.js --batch /path/to/businesses.json,请求之间间隔 200ms。凭据优先读取环境变量 AISA_ONE_API_KEY,经 aisa.one 代理并以 Bearer 认证访问;否则回退读取 DATAFORSEO_LOGIN 与 DATAFORSEO_PASSWORD,直连 DataForSEO 并以 Basic 认证访问,脚本会自动检测。地点格式为 City,Province/State,Country。
限制:依赖 DataForSEO 接口,每次调用会计费,批量任务需注意成本;单次只返回第一家匹配商户;未提供定价、配额及错误处理细节。