核心用法
本技能基于 BrowserAct 的 Google Maps Reviews API 模板，实现 Google Maps 评论数据的自动化抓取。用户只需提供搜索关键词、语言和地区参数，即可获取结构化的评论数据。调用方式为通过 Python 脚本执行：
python -u ./.cursor/skills/google-maps-reviews-api-skill/scripts/google_maps_reviews_api.py "关键词" "语言" "国家"
关键参数包括：
- KeyWords：搜索关键词（如商家名称、类别）
- language：界面及返回文本语言（默认
en，支持zh-CN、es、fr等） - country：搜索结果的地区偏向（默认
us，支持gb、ca、au、jp等）
执行后返回结构化数据，包含评论者名称、头像、评分、评论文本、日期、点赞数等字段。
---
显著优点
1. 零幻觉数据提取：采用预置工作流，避免纯 AI 生成内容的虚构风险
2. 反 CAPTCHA 机制：内置绕过 reCAPTCHA 等验证挑战的能力
3. 无 IP 地域限制：突破区域 IP 封锁，支持全球稳定访问
4. 执行效率高：相比纯 AI 驱动的浏览器自动化方案，任务执行更快
5. 成本优势明显：显著降低高 Token 消耗方案的数据获取成本
---
潜在缺点与局限性
1. 依赖第三方 API：需配置 BROWSERACT_API_KEY，服务可用性受 BrowserAct 平台制约
2. 执行耗时较长：涉及真实浏览器自动化操作，单次任务可能需要数分钟
3. 单次重试限制：失败时仅自动重试一次，复杂场景下成功率有限
4. 数据覆盖不确定：Google Maps 页面结构变更可能影响抓取稳定性
5. 授权风险：API Key 失效时需人工介入更换，无自动续期机制
---
适合人群
- 本地生活服务商（餐饮、医疗、零售）的运营与数据分析人员
- 市场研究员、竞品分析师
- 品牌声誉管理（ORM）从业者
- 需要批量获取真实用户反馈的产品经理与用户研究人员
- 地理位置敏感的商业情报收集者
---
常规风险
| 风险类型 | 说明 | 缓解措施 |
|---------|------|---------|
| 授权失效 | API Key 过期或无效导致任务失败 | 引导用户至 BrowserAct Console 获取新 Key |
| 网络波动 | 代理或目标站点不稳定 | 内置一次自动重试机制 |
| 数据合规 | 抓取公开评论可能涉及 GDPR 等隐私法规 | 建议仅用于内部分析，避免商业再分发 |
| 服务依赖 | BrowserAct 平台变更或停止服务 | 关注官方更新，准备备用数据源 |
| 抓取速率 | 高频调用可能触发风控 | 合理控制调用频率，避免滥用 |
---
安全等级说明
本技能未在受控环境中执行安全扫描，基于设计特征评估为 B 级：
- 需要外部 API Key，存在凭证泄露风险
- 涉及第三方网络服务调用，存在数据传输安全风险
- 无代码执行权限，无本地系统篡改能力
- 建议用户在可信网络环境下使用，妥善保管 API Key