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:

1. KeyWords (Search Keywords)

   • Type: string
   • Description: The keywords the user wants to search for on Google Maps.
   • Example: coffee, bakery, coworking space

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: en

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: us

4. 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 name
• full address: Business address
• rating: Average star rating
• review count: Number of reviews
• price range: Price level
• cuisine type: Business category
• amenity tags: Features like Wi-Fi, outdoor seating
• review snippet: Highlighted short review
• service 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:

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.