google-maps-search-api

⚠Review·Scanned 2/18/2026

This skill automates extracting business listings from Google Maps via BrowserAct using google_maps_search_api.py. It directs executing python ./scripts/google_maps_search_api.py "KeyWords" "language" "country" max_dates, reads the BROWSERACT_API_KEY environment variable, and calls https://api.browseract.com/v2/workflow.

from clawhub.ai·vfb46ae8·7.2 KB·0 installs
Scanned from 0.1.0 at fb46ae8 · Transparency log ↗
$ vett add clawhub.ai/phheng/google-maps-search-apiReview findings below

Google Maps Search Automation Skill

✨ Platform Compatibility

✅ Works Powerfully & Reliably On All Major AI Assistants

PlatformStatusHow to Install
OpenCode✅ Fully SupportedCopy skill folder to ~/.opencode/skills/
Claude Code✅ Fully SupportedNative skill support
Cursor✅ Fully SupportedCopy to ~/.cursor/skills/
OpenClaw✅ Fully SupportedCompatible

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.