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 ~/.opencode/skills/ |
| 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:
KeyWords (Search Keywords)
- Type:
string
- Description: The keywords the user wants to search for on Google Maps.
- Example:
coffee, bakery, coworking space
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:
en
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:
us
max_dates (Maximum extraction limit)
- Type:
number
- Description: The maximum number of places to extract from search results.
- Default:
100
🚀 Execution Method (Recommended)
The Agent should implement "one command for results" by executing the following independent script:
# Call example
python ./scripts/google_maps_search_api.py "KeyWords" "language" "country" max_dates
📊 Data Output Description
After successful execution, the script will directly parse and print the results from the API response. Results include:
name: Business namefull address: Business addressrating: Average star ratingreview count: Number of reviewsprice range: Price levelcuisine type: Business categoryamenity tags: Features like Wi-Fi, outdoor seatingreview snippet: Highlighted short reviewservice options: 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:
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.
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.
1---2name: google-maps-search-api3description: This skill is designed to help users automatically extract business data from Google Maps search results. When a user asks to "find coffee shops in New York," "search for dental clinics," or "extract business leads from Google Maps," the agent should proactively apply this skill.4---56# Google Maps Search Automation Skill78## ✨ Platform Compatibility910**✅ Works Powerfully & Reliably On All Major AI Assistants**1112| Platform | Status | How to Install |13|----------|--------|----------------|14| **OpenCode** | ✅ Fully Supported | Copy skill folder to `~/.opencode/skills/` |15| **Claude Code** | ✅ Fully Supported | Native skill support |16| **Cursor** | ✅ Fully Supported | Copy to `~/.cursor/skills/` |17| **OpenClaw** | ✅ Fully Supported | Compatible |1819**Why Choose BrowserAct Skills?**20- 🚀 Stable & crash-free execution21- ⚡ Fast response times22- 🔧 No configuration headaches23- 📦 Plug & play installation24- 💬 Professional support2526## 📖 Introduction27This 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.2829## 🔑 API Key Guidance30Before 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.31**The Agent must inform the user**:32> "Since you haven't configured the BrowserAct API Key, please go to the [BrowserAct Console](https://www.browseract.com/reception/integrations) to get your Key and provide it to me in this chat."3334## 🛠️ Input Parameters Details35The Agent should flexibly configure the following parameters when calling the script based on user needs:36371. **KeyWords (Search Keywords)**38 - **Type**: `string`39 - **Description**: The keywords the user wants to search for on Google Maps.40 - **Example**: `coffee`, `bakery`, `coworking space`41422. **language (UI Language)**43 - **Type**: `string`44 - **Description**: Sets the UI language and the language of the returned text.45 - **Optional Values**: `en`, `de`, `fr`, `it`, `es`, `ja`, `zh-CN`, `zh-TW`46 - **Default**: `en`47483. **country (Country/Region Bias)**49 - **Type**: `string`50 - **Description**: Sets the country or region bias for search results.51 - **Example**: `us`, `gb`, `ca`, `au`, `de`, `fr`, `es`, `it`, `jp`52 - **Default**: `us`53544. **max_dates (Maximum extraction limit)**55 - **Type**: `number`56 - **Description**: The maximum number of places to extract from search results.57 - **Default**: `100`5859## 🚀 Execution Method (Recommended)60The Agent should implement "one command for results" by executing the following independent script:6162```bash63# Call example64python ./scripts/google_maps_search_api.py "KeyWords" "language" "country" max_dates65```6667## 📊 Data Output Description68After successful execution, the script will directly parse and print the results from the API response. Results include:69- `name`: Business name70- `full address`: Business address71- `rating`: Average star rating72- `review count`: Number of reviews73- `price range`: Price level74- `cuisine type`: Business category75- `amenity tags`: Features like Wi-Fi, outdoor seating76- `review snippet`: Highlighted short review77- `service options`: Such as "Order online", "Dine-in"7879## ⚠️ Error Handling & Retry80During script execution, if an error occurs (such as network fluctuations or task failure), the Agent should follow this logic:81821. **Check output content**:83 - 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.84 - 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.85862. **Retry Limit**:87 - Automatic retry is limited to **once**. If the second attempt still fails, stop retrying and report the specific error message to the user.
kbarbel640-del