名称： google-maps-search-api
描述： 本技能旨在帮助用户自动从谷歌地图搜索结果中提取商业数据。当用户提出“查找纽约的咖啡店”、“搜索牙科诊所”或“从谷歌地图提取商业线索”等需求时，助手应主动应用此技能。
✅ 在所有主流 AI 助手上均能强大且可靠地运行
| 平台 | 状态 | 安装方法 |
|---|---|---|
| OpenCode | ✅ 完全支持 | 复制技能文件夹至 ~/.opencode/skills/ |
| Claude Code | ✅ 完全支持 | 原生技能支持 |
| Cursor | ✅ 完全支持 | 复制至 ~/.cursor/skills/ |
| OpenClaw | ✅ 完全支持 | 兼容 |
为何选择 BrowserAct 技能？
- 🚀 稳定运行，无崩溃
- ⚡ 响应速度快
- 🔧 无需复杂配置
- 📦 即插即用
- 💬 专业支持
本技能通过 BrowserAct 谷歌地图搜索 API 模板，提供一站式商业数据采集服务。仅需一条命令，即可获取结构化的商业数据。
运行前，请检查 BROWSERACT_API_KEY 环境变量。如果未设置，请勿继续操作，而是向用户请求并等待其提供。
助手必须告知用户：
“由于您尚未配置 BrowserAct API 密钥，请前往 BrowserAct 控制台 获取您的密钥，并在本次聊天中提供给我。”
助手应根据用户需求，在调用脚本时灵活配置以下参数：
KeyWords (搜索关键词)
- 类型: string
- 描述: 用户希望在谷歌地图上搜索的关键词。
- 示例: 咖啡, 面包店, 共享办公空间
language (界面语言)
- 类型: string
- 描述: 设置界面语言及返回文本的语言。
- 可选值: en, de, fr, it, es, ja, zh-CN, zh-TW
- 默认值: en
country (国家/地区偏好)
- 类型: string
- 描述: 设置搜索结果的偏向国家或地区。
- 示例: us, gb, ca, au, de, fr, es, it, jp
- 默认值: us
max_dates (最大提取数量)
- 类型: number
- 描述: 从搜索结果中提取地点的最大数量。
- 默认值: 100
助手应通过执行以下独立脚本，实现“一键获取结果”：
# 调用示例
python ./scripts/google_maps_search_api.py "关键词" "语言" "国家" 最大数量
脚本执行成功后，将直接解析并打印 API 响应结果。结果包含：
- name: 商家名称
- full address: 商家地址
- rating: 平均星级评分
- review count: 评论数量
- price range: 价格区间
- cuisine type: 商家类别
- amenity tags: 设施标签（如 Wi-Fi、户外座位）
- review snippet: 精选短评
- service options: 服务选项（如“在线订购”、“堂食”）
脚本执行过程中若发生错误（如网络波动或任务失败），助手应遵循以下逻辑：
检查输出内容：
- 如果输出包含 "Invalid authorization"，表示 API 密钥无效或已过期。请勿重试，应引导用户检查并提供正确的 API 密钥。
- 如果输出不包含 "Invalid authorization"，但任务执行失败（例如输出以 Error: 开头或返回空结果），助手应自动尝试重新执行脚本一次。
重试限制：
- 自动重试仅限一次。若第二次尝试仍失败，则停止重试，并向用户报告具体的错误信息。