google-maps-api-skill

Google 地图自动化抓取器技能

📖 简介

这项技能利用 BrowserAct 的 Google Maps API 模板，提供一站式商家数据采集服务。它可以直接从 Google 地图中提取结构化信息，包括商家名称、类别、联系信息、评分等。只需提供搜索关键词和位置偏好，即可获取整洁、可用的数据。

✨ 功能

1. 无幻觉：预设工作流可避免 AI 生成式幻觉，确保数据提取稳定、准确。
2. 无验证码问题：无需处理 reCAPTCHA 或其他验证挑战。
3. 无 IP 限制：无需处理区域 IP 限制或地理围栏。
4. 执行更快：与纯 AI 驱动的浏览器自动化方案相比，任务执行速度更快。
5. 经济高效：与消耗大量 token 的 AI 方案相比，大幅降低数据获取成本。

🔑 API 密钥设置

运行前，请检查 BROWSERACT_API_KEY 环境变量。如果未设置，不要采取其他措施；请询问用户并等待其提供。 Agent 必须告知用户：

“由于您尚未配置 BrowserAct API Key，请访问 BrowserAct Console 获取您的 Key。”

🛠️ 输入参数

根据用户需求配置以下参数：

1. keywords（搜索关键词）

   • 类型：string
   • 说明：您想在 Google Maps 上搜索的查询词。
   • 示例：coffee shop、dental clinic、Turkish-style restaurant

2. language（界面语言）

   • 类型：string
   • 说明：指定界面语言和返回文本的语言（例如 en、zh-CN）。
   • 默认值：en

3. country（国家偏好）

   • 类型：string
   • 说明：指定国家或地区偏好（例如 us、gb、ca）。
   • 默认值：us

🚀 用法

执行以下脚本，即可通过一条命令获取结果：

# Example call
python -u ./scripts/google_maps_api.py "keywords" "language" "country"

⏳ 执行监控

由于此任务涉及自动化浏览器操作，可能需要一些时间（数分钟）。脚本会持续输出带时间戳的状态日志（例如 [14:30:05] Task Status: running）。 Agent 操作说明：

• 等待脚本结果期间，持续监控终端输出。
• 只要终端持续输出新的状态日志，任务就处于正常运行状态；不要误认为发生死锁或无响应。
• 只有当状态长时间未变化，或脚本停止输出且未返回结果时，才应考虑触发重试机制。

📊 数据输出

成功后，脚本会解析并打印 API 返回的以下字段：

• Title Name：商家官方名称
• Category_primary：商家主要类别
• Address：完整街道地址
• Phone number：联系电话
• Website link：官方网站 URL
• Rating：平均星级评分
• reviews_count：评论总数
• business_status：营业状态（例如 operational）

⚠️ 错误处理与重试

如果脚本执行期间发生错误（例如网络波动或任务失败），Agent 应遵循以下逻辑：

1. 检查输出内容：

   • 如果输出包含 "Invalid authorization"，表示 API Key 无效或已过期。不要重试；请引导用户重新检查并提供正确的 API Key。
   • 如果输出不包含 "Invalid authorization"，但任务失败（例如输出以 Error: 开头或返回空结果），Agent 应自动重新执行脚本一次。

2. 重试次数限制：

   • 自动重试仅限一次。如果第二次尝试失败，请停止重试，并向用户报告具体错误信息。

🌟 典型用例

1. 潜在客户开发：查找“美国”的“SaaS 公司”，用于销售拓展。
2. 竞争对手研究：提取特定街区内“咖啡店”的数据。
3. 市场分析：确定某个地区“牙科诊所”的密度。
4. 联系信息检索：获取“房地产中介”的电话号码和网站。
5. 本地服务发现：查找评分较高的“土耳其风味餐厅”。
6. 商家状态监控：检查特定商店是否“正常营业”。
7. 目录构建：收集本地商家目录所需的地址和类别。
8. 评分对标：比较各家“豪华酒店”的评分。
9. 全球考察：研究“科技初创公司”，涉及“gb”或“au”等不同国家。
10. 自动数据同步：定期将本地商家数据导入 CRM。