google-maps-search-api

Google Maps Search Automation Skill 是一款专注于商业数据智能提取的自动化工具，通过集成 BrowserAct API 服务，帮助用户高效获取 Google Maps 中的商家信息。用户只需提供搜索关键词（如"咖啡店"、"牙科诊所"），即可快速获得包含商家名称、完整地址、评分、评论数量、价格区间、营业时间等维度的结构化数据，适用于市场调研、竞品分析和商业线索挖掘等场景。

核心用法
该 Skill 采用命令行脚本执行模式，通过调用 google_maps_search_api.py 实现"一键式"数据采集。用户需预先配置 BROWSERACT_API_KEY 环境变量，随后通过指定关键词、目标国家/地区、界面语言及最大提取数量（默认100条）等参数触发搜索。脚本自动处理 API 请求、响应解析及数据格式化，最终输出包含商家详情、服务选项（如在线预订、堂食）、特色标签（如 Wi-Fi、户外座椅）等丰富字段的结构化结果。

显著优点
首先，跨平台兼容性出色，原生支持 OpenCode、Claude Code、Cursor 等主流 AI 编程助手，实现即插即用。其次，数据维度全面，不仅包含基础联系信息，还涵盖评分星级、价格定位、精选评论片段等深度商业情报。再者，具备智能错误处理机制，对于网络波动导致的临时失败会自动重试一次，仅在 API 密钥失效时停止并引导用户重新配置。最后，无需维护复杂的浏览器环境或处理反爬机制，所有底层复杂性由 BrowserAct 平台托管，大幅降低技术门槛。

潜在局限
该 Skill 存在几个关键限制：其一，强依赖第三方 BrowserAct 服务，需额外注册获取 API Key 且可能存在调用费用；其二，作为 T3 级社区开源项目，代码维护更新频率与长期支持存在不确定性；其三，数据质量受 Google Maps 平台本身制约，部分小型或未认领商家可能存在信息缺失；其四，当前版本缺乏高级筛选功能（如按评分排序、营业状态过滤），需用户后期手动处理数据；其五，受 API 调用限制，单次最大提取量为100条，大规模数据采集需分批处理。

适用群体
本产品特别适合市场研究团队进行竞品分析与商圈调研，销售开发代表（SDR）挖掘潜在客户线索，咨询公司开展本地生活服务市场分析，以及初创企业验证线下商业机会。对于需要快速构建区域商家数据库、监测连锁品牌分布或分析消费者评价趋势的业务场景尤为高效，同时也适合学术研究人员进行地理商业分布研究。

使用风险
主要风险包括：API 密钥泄露可能导致账户被盗用，建议在安全环境变量中配置而非硬编码；搜索关键词会明文发送至 BrowserAct 服务器，敏感商业查询可能存在隐私暴露风险；依赖外部 API 稳定性，若 BrowserAct 服务中断或限额耗尽将直接影响功能可用性；此外，大规模数据采集可能触发 Google Maps 服务条款限制，商业用途需确保合规性，避免用于不正当竞争或隐私侵犯场景。

核心用法

Google Maps Search API Skill 是一款基于 BrowserAct 平台的商业数据采集工具，用户只需提供搜索关键词、目标国家/地区、语言偏好及提取数量上限，即可一键获取结构化商户数据。执行方式为调用 Python 脚本，命令格式为：python ./scripts/google_maps_search_api.py "关键词" "语言" "国家" 数量。系统通过轮询机制异步获取任务结果，最终输出包含商户名称、完整地址、评分、评论数、价格区间、业态类型、设施标签、精选短评及服务选项等字段。

显著优点

1. 零配置开箱即用：支持 OpenCode、Claude Code、Cursor、OpenClaw 等主流 AI 助手平台，复制即用无需额外配置。
2. 多语言多区域支持：覆盖英语、德语、法语、意大利语、西班牙语、日语及简繁中文，可针对特定国家/地区偏置搜索结果。
3. 数据维度丰富：不仅获取基础联系信息，还包含评分、价格感知、设施特征（如 Wi-Fi、户外座位）及服务选项，便于精准筛选潜在客户。
4. 安全合规：API Key 通过环境变量管理，无硬编码密钥；HTTPS 加密传输，符合 GDPR 数据最小化原则。
5. 依赖精简：仅使用 Python 标准库与 requests，无供应链安全风险。

潜在缺点与局限性

1. 外部 API 依赖：核心功能完全依赖 BrowserAct 付费服务，若服务中断或调整定价策略将直接影响可用性。
2. 输入验证不足：当前版本未对 max_dates 参数进行边界校验（如负值或超大数值），可能引发意外行为。
3. 轮询机制缺陷：任务状态轮询采用 while True 无限循环，缺乏超时保护，网络异常时可能长时间挂起。
4. 静默异常处理：连接错误被静默捕获，缺少日志记录，增加调试难度。
5. 项目成熟度有限：代码较新（单一 commit），长期维护稳定性有待观察，且未指定开源许可证。

适合人群

• 销售与商务拓展团队：快速构建目标区域潜在客户清单（如「上海咖啡馆」「柏林牙科诊所」）。
• 市场研究员：批量采集竞品分布、价格带及用户口碑数据。
• 本地化运营人员：验证特定城市商户入驻情况或服务覆盖密度。
• 开发者与自动化工程师：作为数据管道的一环，集成至更大的业务工作流。

常规风险

• API Key 泄露风险：若用户误将 Key 硬编码至脚本或共享环境，可能导致配额被盗用。
• 数据合规边界：采集的商户信息虽为公开数据，但大规模爬取需遵守 Google Maps 服务条款及当地数据保护法规。
• 服务可用性：BrowserAct 为第三方 SaaS，存在服务变更、速率限制或区域性访问限制的可能性。
• 结果准确性：依赖 Google Maps 实时数据，API 返回结果与实际页面可能存在延迟或差异。