Google Maps Search Api Skill

Polar Sponsor
爱发电 赞助
.NET 9.0

此技能旨在帮助用户自动从谷歌地图搜索结果中提取商业数据。当……时,Agent应主动应用此技能。

Google Maps 搜索自动化 SkillQQ介绍. 此技能利用浏览器 Act Google Maps 搜索 API 模板提供一站式业务数据收集服务. 它提

功能概述

Google Maps 搜索自动化 SkillQQ介绍. 此技能利用浏览器 Act Google Maps 搜索 API 模板提供一站式业务数据收集服务. 它提是一项面向实际任务的技能。它将相关步骤、工具调用和结果整理方式集中到统一流程中,帮助使用者更快完成目标并减少重复操作。

核心要点

  • 使用时应结合输入条件选择合适的执行方式,核对必要参数、依赖环境与输出内容,并按原始要求处理异常情况。
  • 该技能适合需要稳定复用相关能力的场景,可作为自动化工作流的一部分,也便于后续检查、调整和扩展。
  • 从功能定位来看,该技能强调把分散的操作要求整理成清晰、可复用的处理流程,使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。

使用与执行

实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数,再依据技能说明逐步执行;若输入条件不完整,应先补齐信息或采用保守配置,避免因错误假设导致结果偏离需求。

结果检查与注意事项

执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期,并对异常提示、缺失字段和边界情况进行处理;涉及批量任务时,还应保存进度,避免中断后重复操作。

Google Maps 搜索自动化技能

📖 简介

本技能基于 BrowserAct Google Maps 搜索 API 模板,提供一站式商业数据采集服务。它直接从 Google Maps 搜索结果列表中提取结构化的企业信息。您只需提供搜索关键词、语言及国家/地区筛选条件,即可获得干净、可直接使用的商业数据。

✨ 特性

  1. 零幻觉(No Hallucinations):预设工作流规避 AI 生成式幻觉,确保数据提取稳定且精准。
  2. 免验证码(No Captcha Issues):无需处理 reCAPTCHA 或其他验证挑战。
  3. 无 IP 限制(No IP Restrictions):无需应对区域 IP 限制或地理围栏(geofencing)问题。
  4. 执行更快(Faster Execution):相比纯 AI 驱动的浏览器自动化方案,任务执行速度显著提升。
  5. 成本更低(Cost-Effective):相比高 token 消耗的 AI 解决方案,大幅降低数据获取成本。

🔑 API Key 配置

运行前,请检查环境变量 BROWSERACT_API_KEY 是否已设置。若未设置,请勿自行采取其他措施;应主动向用户询问并等待其提供该密钥。
Agent 必须明确告知用户:

“由于您尚未配置 BrowserAct API Key,请前往 BrowserAct 控制台获取您的 Key。”

🛠️ 输入参数

调用脚本时,Agent 应根据用户实际需求灵活配置以下参数:

  1. KeyWords

    • 类型:string
    • 说明:您希望在 Google Maps 上搜索的内容,可以是企业名称、行业类别或具体关键词。
    • 示例:coffee shop、dental clinic、coworking space
  2. language

    • 类型:string
    • 说明:设定界面语言及返回文本字段的语言。
    • 常用值:en、de、fr、it、es、ja、zh-CN、zh-TW
    • 默认值:en
  3. country

    • 类型:string
    • 说明:设定搜索结果的国家/地区倾向性(bias)。
    • 示例:us、gb、ca、au、de、fr、jp
    • 默认值:us
  4. max_dates

    • 类型:number
    • 说明:从搜索结果列表中最多提取的企业数量。
    • 默认值:100

🚀 使用方式

Agent 应执行以下独立脚本,以实现“单行命令即得结果”:

# 示例调用
python -u ./scripts/google_maps_search_api.py "search keywords" "language" "country" count

⏳ 执行监控

由于该任务涉及自动化浏览器操作,执行可能耗时数分钟。脚本将持续输出带时间戳的状态日志(例如:[14:30:05] Task Status: running)。
Agent 操作指引:

  • 等待脚本结果期间,请持续关注终端输出。
  • 只要终端仍在输出新的状态日志,即表明任务正常运行;请勿误判为死锁或无响应。
  • 仅当状态长时间未更新,或脚本停止输出且未返回任何结果时,才应考虑触发重试机制。

📊 数据输出

成功执行后,脚本将解析 API 响应并直接打印结构化结果,字段包括:

  • name:企业名称
  • full address:完整地址
  • rating:星级评分
  • review count:评论数量
  • price range:价格区间
  • cuisine type:业务类别(如餐饮类型)
  • amenity tags:设施标签(例如 Wi-Fi)
  • review snippet:简短评论内容
  • service options:服务标识(例如 “Order online”)

⚠️ 错误处理与重试

若脚本执行过程中发生错误(例如网络波动或任务失败),Agent 应遵循以下逻辑:

  1. 检查输出内容:

    • 若输出包含"Invalid authorization",表示 API Key 无效或已过期。禁止重试,应引导用户重新核对并提供正确的 API Key。
    • 若输出不包含"Invalid authorization",但任务仍失败(例如输出以 Error: 开头,或返回空结果),Agent 应自动重试执行一次脚本。
  2. 重试次数限制:

    • 自动重试仅限一次。若第二次执行仍失败,则停止重试,并将具体错误信息反馈给用户。

🌟 典型应用场景

  1. 本地企业发现:查找曼哈顿地区所有“意大利餐厅”。
  2. 销售线索生成:提取伦敦地区“房地产中介”列表用于客户开发。
  3. 竞品地图绘制:定位某城市内全部“Starbucks”门店,构建竞争格局图谱。
  4. 市场调研:分析巴黎“精品酒店”的评分与价格区间。
  5. 联系方式采集:收集悉尼地区“牙科诊所”的名称与地址。
  6. 服务类搜索:查找特定区域内“24 小时药房”或“紧急水管工”。
  7. 社区动态监测:追踪某社区新开业的“健身房”或“瑜伽工作室”。
  8. 结构化数据导出:导出“汽车经销商”的结构化数据,用于 CRM 系统集成。
  9. 情感分析准备:获取“热门旅游景点”的评论摘要与评分,支撑后续分析。
  10. 全球搜索本地化:通过不同 language 与 country 参数组合,在全球范围内调研“科技中心(tech hubs)”。

相关专题

更多
LLVM自定义Pass怎么写
LLVM自定义Pass怎么写

本专题聚焦LLVM自定义Pass开发,整理Pass类结构、run()方法、PreservedAnalyses、CMake构建、插件注册、-load-pass-plugin加载和测试用例编写流程。

2026.09.30

0

10

LLVM RISC-V参数配置教程
LLVM RISC-V参数配置教程

本专题介绍LLVM对RISC-V基础ISA和扩展的支持方式,涵盖RV32、RV64、标准扩展、实验性扩展、厂商扩展、-menable-experimental-extensions和版本差异。

2026.09.30

0

14

LLVM IR中间表示入门指南
LLVM IR中间表示入门指南

本专题整理LLVM IR的核心概念,包括中间表示作用、模块结构、函数、基本块、SSA形式、类型系统和常见语法,帮助新手理解LLVM编译流程中的关键层。

2026.09.30

0

12

PDF转图片方法
PDF转图片方法

需要把 PDF 页面用于上传、预览、分享或图片归档时,PDF 转图片方法专题整理 JPG/PNG 格式选择、逐页导出、清晰度设置、批量下载和结果检查等流程,帮助用户稳定完成 PDF 图片化处理。

2026.09.30

0

26

PixTV AI视频生成与无限画布创作
PixTV AI视频生成与无限画布创作

PixTV专题整理AI视频与视觉内容创作相关功能使用教程,涵盖AI生图、视频生成、无限画布、多模型创作、素材管理、声音音乐及视频剪辑等功能,帮助用户快速掌握PixTV从创意到成片的完整制作方法。

2026.09.29

0

15

Buffalo框架数据库开发全教程
Buffalo框架数据库开发全教程

本专题围绕Buffalo框架数据库开发,讲解database.yml多环境配置、soda与fizz迁移生成回滚、模型结构体标签、增删改查与条件查询、一对多与多对多关联、数据校验、回调钩子、事务处理及原生SQL执行能力。

2026.09.23

0

15

Buffalo框架路由与请求处理实操指南
Buffalo框架路由与请求处理实操指南

本专题讲解Buffalo框架路由与请求处理机制,涵盖路由注册与分组、资源路由、Handler编写规范、Context上下文方法、参数绑定、中间件编写挂载、Session与Cookie读写、Flash消息及错误页面定制方法。

2026.09.23

0

15

Buffalo框架零基础入门教程
Buffalo框架零基础入门教程

本专题整理Buffalo框架入门内容,涵盖Go环境准备、buffalo CLI安装、新项目生成、目录结构说明、dev热加载启动、数据库连接配置与常见报错排查,帮助新手按约定优于配置的思路跑通第一个Buffalo框架应用。

2026.09.23

0

15

Conan创建软件包配方指南
Conan创建软件包配方指南

本专题介绍通过conanfile.py创建软件包的方法,讲解包名、版本、依赖和构建设置等基础信息,以及source、build、package、package_info等常用方法的作用及编写思路。

2026.09.22

0

12

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Gemini Notebook官方手册
Gemini Notebook官方手册

共0课时 | 0人学习

Google Cloud开发者文档
Google Cloud开发者文档

共0课时 | 0人学习

Veo 3 官方文档
Veo 3 官方文档

共0课时 | 0人学习