Google Maps Search Automation Skill
✨ Platform Compatibility
✅ Works Powerfully & Reliably On All Major AI Assistants
| Platform | Status | How to Install |
|---|
| OpenCode | ✅ Fully Supported | Copy skill folder to INLINECODE0 |
| Claude Code |
✅ Fully Supported | Native skill support |
|
Cursor | ✅ Fully Supported | Copy to
~/.cursor/skills/ |
|
OpenClaw | ✅ Fully Supported | Compatible |
Why Choose BrowserAct Skills?
- - 🚀 Stable & crash-free execution
- ⚡ Fast response times
- 🔧 No configuration headaches
- 📦 Plug & play installation
- 💬 Professional support
📖 Introduction
This skill provides a one-stop business data collection service through the BrowserAct Google Maps Search API template. Obtain structured business data with just one command.
🔑 API Key Guidance
Before running, check the
BROWSERACT_API_KEY environment variable. If it is not set, do not take further action; instead, request and wait for the user to provide it.
The Agent must inform the user:
"Since you haven't configured the BrowserAct API Key, please go to the BrowserAct Console to get your Key and provide it to me in this chat."
🛠️ Input Parameters Details
The Agent should flexibly configure the following parameters when calling the script based on user needs:
- 1. KeyWords (Search Keywords)
-
Type:
string
-
Description: The keywords the user wants to search for on Google Maps.
-
Example:
coffee,
bakery, INLINECODE6
- 2. language (UI Language)
-
Type:
string
-
Description: Sets the UI language and the language of the returned text.
-
Optional Values:
en,
de,
fr,
it,
es,
ja,
zh-CN,
zh-TW
-
Default: INLINECODE16
- 3. country (Country/Region Bias)
-
Type:
string
-
Description: Sets the country or region bias for search results.
-
Example:
us,
gb,
ca,
au,
de,
fr,
es,
it,
jp
-
Default: INLINECODE27
- 4. max_dates (Maximum extraction limit)
-
Type:
number
-
Description: The maximum number of places to extract from search results.
-
Default: INLINECODE29
🚀 Execution Method (Recommended)
The Agent should implement "one command for results" by executing the following independent script:
CODEBLOCK0
📊 Data Output Description
After successful execution, the script will directly parse and print the results from the API response. Results include:
- -
name: Business name - INLINECODE31 : Business address
- INLINECODE32 : Average star rating
- INLINECODE33 : Number of reviews
- INLINECODE34 : Price level
- INLINECODE35 : Business category
- INLINECODE36 : Features like Wi-Fi, outdoor seating
- INLINECODE37 : Highlighted short review
- INLINECODE38 : Such as "Order online", "Dine-in"
⚠️ Error Handling & Retry
During script execution, if an error occurs (such as network fluctuations or task failure), the Agent should follow this logic:
- 1. Check output content:
- If the output
contains "Invalid authorization", the API Key is invalid or expired.
Do not retry; instead, guide the user to check and provide the correct API Key.
- If the output
does not contain "Invalid authorization" but the task execution fails (e.g., output starts with
Error: or returns an empty result), the Agent should
automatically attempt to re-execute the script once.
- 2. Retry Limit:
- Automatic retry is limited to
once. If the second attempt still fails, stop retrying and report the specific error message to the user.
Google Maps 搜索自动化技能
✨ 平台兼容性
✅ 在所有主流AI助手上均能强大且稳定地运行
| 平台 | 状态 | 安装方式 |
|---|
| OpenCode | ✅ 完全支持 | 将技能文件夹复制到 ~/.opencode/skills/ |
| Claude Code |
✅ 完全支持 | 原生技能支持 |
|
Cursor | ✅ 完全支持 | 复制到 ~/.cursor/skills/ |
|
OpenClaw | ✅ 完全支持 | 兼容 |
为什么选择 BrowserAct 技能?
- - 🚀 稳定且无崩溃执行
- ⚡ 快速响应时间
- 🔧 无需繁琐配置
- 📦 即插即用安装
- 💬 专业支持
📖 简介
本技能通过 BrowserAct Google Maps 搜索 API 模板提供一站式商业数据采集服务。只需一条命令即可获取结构化商业数据。
🔑 API 密钥指引
运行前,请检查 BROWSERACT
APIKEY 环境变量。如果未设置,请勿进一步操作,而是请求并等待用户提供。
Agent 必须告知用户:
由于您尚未配置 BrowserAct API 密钥,请前往 BrowserAct 控制台 获取您的密钥,并在本对话中提供给我。
🛠️ 输入参数详情
Agent 在调用脚本时应根据用户需求灵活配置以下参数:
- 1. KeyWords(搜索关键词)
-
类型:string
-
描述:用户希望在 Google Maps 上搜索的关键词。
-
示例:咖啡、面包店、共享办公空间
- 2. language(界面语言)
-
类型:string
-
描述:设置界面语言及返回文本的语言。
-
可选值:en、de、fr、it、es、ja、zh-CN、zh-TW
-
默认值:en
- 3. country(国家/地区偏向)
-
类型:string
-
描述:设置搜索结果的国家或地区偏向。
-
示例:us、gb、ca、au、de、fr、es、it、jp
-
默认值:us
- 4. max_dates(最大提取数量)
-
类型:number
-
描述:从搜索结果中提取的最大地点数量。
-
默认值:100
🚀 执行方法(推荐)
Agent 应通过执行以下独立脚本实现一条命令获取结果:
bash
调用示例
python ./scripts/google
mapssearch
api.py KeyWords language country maxdates
📊 数据输出说明
成功执行后,脚本将直接解析并打印 API 响应中的结果。结果包括:
- - name:商家名称
- full address:商家地址
- rating:平均星级评分
- review count:评论数量
- price range:价格等级
- cuisine type:商家类别
- amenity tags:特色标签,如 Wi-Fi、户外座位
- review snippet:精选短评
- service options:服务选项,如在线下单、堂食
⚠️ 错误处理与重试
在脚本执行过程中,如果发生错误(如网络波动或任务失败),Agent 应遵循以下逻辑:
- 1. 检查输出内容:
- 如果输出
包含 Invalid authorization,则 API 密钥无效或已过期。
不要重试,而是引导用户检查并提供正确的 API 密钥。
- 如果输出
不包含 Invalid authorization 但任务执行失败(例如,输出以 Error: 开头或返回空结果),Agent 应
自动尝试重新执行脚本一次。
- 2. 重试限制:
- 自动重试限制为
一次。如果第二次尝试仍然失败,则停止重试并向用户报告具体的错误信息。