此技能旨在帮助用户自动从谷歌地图搜索结果中提取商业数据。当……时,Agent应主动应用此技能。
Google Maps 搜索自动化 SkillQQ介绍. 此技能利用浏览器 Act Google Maps 搜索 API 模板提供一站式业务数据收集服务. 它提是一项面向实际任务的技能。它将相关步骤、工具调用和结果整理方式集中到统一流程中,帮助使用者更快完成目标并减少重复操作。
实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数,再依据技能说明逐步执行;若输入条件不完整,应先补齐信息或采用保守配置,避免因错误假设导致结果偏离需求。
执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期,并对异常提示、缺失字段和边界情况进行处理;涉及批量任务时,还应保存进度,避免中断后重复操作。
本技能基于 BrowserAct Google Maps 搜索 API 模板,提供一站式商业数据采集服务。它直接从 Google Maps 搜索结果列表中提取结构化的企业信息。您只需提供搜索关键词、语言及国家/地区筛选条件,即可获得干净、可直接使用的商业数据。
运行前,请检查环境变量 BROWSERACT_API_KEY 是否已设置。若未设置,请勿自行采取其他措施;应主动向用户询问并等待其提供该密钥。
Agent 必须明确告知用户:
“由于您尚未配置 BrowserAct API Key,请前往 BrowserAct 控制台获取您的 Key。”
调用脚本时,Agent 应根据用户实际需求灵活配置以下参数:
KeyWords
stringcoffee shop、dental clinic、coworking spacelanguage
stringen、de、fr、it、es、ja、zh-CN、zh-TWencountry
stringus、gb、ca、au、de、fr、jpusmax_dates
number100Agent 应执行以下独立脚本,以实现“单行命令即得结果”:
# 示例调用 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 应遵循以下逻辑:
检查输出内容:
"Invalid authorization",表示 API Key 无效或已过期。禁止重试,应引导用户重新核对并提供正确的 API Key。"Invalid authorization",但任务仍失败(例如输出以 Error: 开头,或返回空结果),Agent 应自动重试执行一次脚本。重试次数限制: