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 服务条款限制，商业用途需确保合规性，避免用于不正当竞争或隐私侵犯场景。