该技能旨在帮助用户通过 Google Maps 评论 API 自动提取 Google Maps 评论。智能体应主动应用此技能...
Google Maps 检讨自动化 SkillQQ 介绍. 这种技能提供了一站式检讨收集服务,使用浏览器Act的Google Maps 检讨 API 模板. 它是一项面向实际任务的技能。它将相关步骤、工具调用和结果整理方式集中到统一流程中,帮助使用者更快完成目标并减少重复操作。
实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数,再依据技能说明逐步执行;若输入条件不完整,应先补齐信息或采用保守配置,避免因错误假设导致结果偏离需求。
执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期,并对异常提示、缺失字段和边界情况进行处理;涉及批量任务时,还应保存进度,避免中断后重复操作。
本技能基于 BrowserAct 的 Google Maps 评论 API 模板,提供一站式评论采集服务,可直接从 Google Maps 搜索结果中提取结构化评论数据。您只需提供搜索关键词、语言和国家/地区,即可获得干净、可用的评论数据。
运行前,请检查环境变量 BROWSERACT_API_KEY 是否已设置。若未设置,请勿自行采取其他措施;应主动提示并等待用户提供。
“由于您尚未配置 BrowserAct API Key,请前往 BrowserAct 控制台获取您的 Key。”
Agent 在调用脚本时,应灵活配置以下参数:
KeyWords(搜索关键词)
stringcoffee shop、dental clinic、Tesla showroomlanguage(语言)
stringen、zh-CN、es、fr 等。encountry(国家/地区)
stringus、gb、ca、au、jp 等。usAgent 应使用以下独立脚本实现“单行命令即得结果”:
# 示例调用 python -u ./scripts/google_maps_reviews_api.py "Keywords" "Language" "Country"
由于该任务涉及自动化浏览器操作,执行耗时可能较长(数分钟)。脚本将持续输出带时间戳的状态日志(例如:[14:30:05] Task Status: running)。
Agent 操作指引:
执行成功后,脚本将解析 API 响应并打印如下字段:
author_name:评论者显示名称author_profile_url:评论者个人主页 URLrating:星级评分text:评论正文内容comment_date:人类可读日期likes_count:点赞数author_image_url:评论者头像 URL若脚本执行过程中发生错误(如网络波动或任务失败),Agent 应遵循以下逻辑处理:
检查输出内容:
"Invalid authorization",表示 API Key 无效或已过期。不得重试,应引导用户重新核对并提供正确的 API Key。"Invalid authorization",但任务仍失败(例如输出以 Error: 开头,或返回空结果),Agent 应自动重试执行脚本一次。重试次数限制: