Agent skill

Google Maps Search API Skill

by browser-act in browser-act/skills

This skill is designed to help users automatically extract business data from Google Maps search results.

MITAuto-check passedSales & Support

Install Google Maps Search API Skill

skills CLI
$ npx skills add browser-act/skills --skill google-maps-search-api-skill -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install browser-act/skills google-maps-search-api-skill --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/browser-act/skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/solutions/lead-generation/google-maps-search-api-skill .claude/skills/google-maps-search-api-skill && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
google-maps-search-api-skill
GitHub stars
6.1k
Used in
1 other repo
Token cost
~1.6k tokens
SKILL.md length
695 words
Files
2 (incl. scripts)
Skills in repo
87
Repo updated
First seen
Licence
MIT

At a glance

This skill is designed to help users automatically extract business data from Google Maps search results.

  • Works in 5 steps: No Hallucinations: Pre-set workflows… → No Captcha Issues: No need to handle… → No IP Restrictions: No need to handle… → …
  • Makes the following requests searching for coffee shops in a specific city
  • SKILL.md covers 📖 Introduction, ✨ Features, 🔑 API Key Setup and 🛠️ Input Parameters, plus 4 more sections
  • Runs Python scripts from its folder; calls python; needs BROWSERACT_API_KEY

What it does

Google Maps Search API Skill is an agent skill from browser-act/skills. This skill is designed to help users automatically extract business data from Google Maps search results. The Agent should proactively apply this skill when the user makes the following requests searching for coffee shops in a specific city, finding dentists or medical clinics nearby, tracking competitors' locations in a certain area, extracting business leads from Google Maps lists, gathering restaurant data for market research, finding hotels or accommodation options in a region, locating specific services like…

Its SKILL.md is about 1.6k tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files, including scripts (for example `scripts/google_maps_search_api.py`).

It sits in Sales & Support, covering Market research, Cold outreach and Lead generation. It works with Google Maps Platform. The repository describes itself as: Browser automation CLI built for AI agents. Break through anti-bot walls, hand off to humans across platforms when stuck. Parallel multi-task execution, independent multi-session… The licence is MIT.

When your agent uses it

  • Makes the following requests searching for coffee shops in a specific city
  • Finding dentists
  • Medical clinics nearby
  • Tracking competitors locations in a certain area

Example prompts

  • “/google-maps-search-api-skill”

Requirements

  • Python 3
  • A credential in BROWSERACT_API_KEY

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. No Hallucinations: Pre-set workflows avoid AI generative hallucinations, ensuring stable and precise data extraction.
  2. No Captcha Issues: No need to handle reCAPTCHA or other verification challenges.
  3. No IP Restrictions: No need to handle regional IP restrictions or geofencing.
  4. Faster Execution: Tasks execute faster compared to pure AI-driven browser automation solutions.
  5. Cost-Effective: Significantly lowers data acquisition costs compared to high-token-consuming AI solutions.

What it can do on your machine

Read from SKILL.md and the folder at commit 11c057b. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 1 file in scripts/ (Python), which the agent can run.

    Shell commands in SKILL.md call:

    • python

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • browseract.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • BROWSERACT_API_KEY

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Google Maps Search API Skill loads about 1.6k tokens when it runs. Until then it costs about 216 tokens; SKILL.md has 695 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~216
When it runs · the whole SKILL.md, loaded when a task matches
~1.6k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from browser-act/skills at commit 11c057b, republished under its MIT licence (© browser-act). 695 words, ~1,561 tokens.

Download SKILL.mdSave it as .claude/skills/google-maps-search-api-skill/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
google-maps-search-api-skill
description
This skill is designed to help users automatically extract business data from Google Maps search results. The Agent should proactively apply this skill when the user makes the following requests searching for coffee shops in a specific city, finding dentists or medical clinics nearby, tracking competitors' locations in a certain area, extracting business leads from Google Maps lists, gathering restaurant data for market research, finding hotels or accommodation options in a region, locating specific services like coworking spaces or gyms, monitoring new business openings in a neighborhood, collecting contact information and addresses for sales prospecting, analyzing price ranges and cuisines of local eateries, getting ratings and review counts for a list of businesses, exporting local business data into a CRM or database.

Google Maps Search Automation Skill

📖 Introduction

This skill utilizes the BrowserAct Google Maps Search API template to provide a one-stop business data collection service. It extracts structured business results directly from Google Maps search lists. Simply provide search keywords, language, and country filters to get clean, usable business data.

✨ Features

  1. No Hallucinations: Pre-set workflows avoid AI generative hallucinations, ensuring stable and precise data extraction.
  2. No Captcha Issues: No need to handle reCAPTCHA or other verification challenges.
  3. No IP Restrictions: No need to handle regional IP restrictions or geofencing.
  4. Faster Execution: Tasks execute faster compared to pure AI-driven browser automation solutions.
  5. Cost-Effective: Significantly lowers data acquisition costs compared to high-token-consuming AI solutions.

🔑 API Key Setup

Before running, check the BROWSERACT_API_KEY environment variable. If not set, do not take other measures; ask and wait for the user to provide it. Agent must inform the user:

"Since you haven't configured the BrowserAct API Key, please visit the BrowserAct Console to get your Key."

🛠️ Input Parameters

When calling the script, the Agent should flexibly configure the following parameters based on user needs:

  1. KeyWords

    • Type: string
    • Description: The content you want to search on Google Maps. Can be business names, categories, or specific keywords.
    • Example: coffee shop, dental clinic, coworking space
  2. language

    • Type: string
    • Description: Sets the UI language and the language of returned text fields.
    • Common Values: en, de, fr, it, es, ja, zh-CN, zh-TW
    • Default: en
  3. country

    • Type: string
    • Description: Sets the country or region bias for search results.
    • Example: us, gb, ca, au, de, fr, jp
    • Default: us
  4. max_dates

    • Type: number
    • Description: The maximum number of places to extract from the search results list.
    • Default: 100

🚀 Usage

The Agent should execute the following independent script to achieve "one-line command result":

bash
# Example call
python -u ./scripts/google_maps_search_api.py "search keywords" "language" "country" count
⏳ Execution Monitoring

Since this task involves automated browser operations, it may take some time (several minutes). The script will continuously output status logs with timestamps (e.g., [14:30:05] Task Status: running). Agent Instructions:

  • While waiting for the script result, keep monitoring the terminal output.
  • As long as the terminal is outputting new status logs, the task is running normally; do not mistake it for a deadlock or unresponsiveness.
  • Only if the status remains unchanged for a long time or the script stops outputting without returning a result should you consider triggering the retry mechanism.
Show full SKILL.md (305 more words)Show less

📊 Data Output

After successful execution, the script parses and prints results directly from the API response. Fields include:

  • name: Business name
  • full address: Full address
  • rating: Star rating
  • review count: Number of reviews
  • price range: Price level
  • cuisine type: Business category
  • amenity tags: Features like Wi-Fi
  • review snippet: Short review text
  • service options: Service indicators (e.g., "Order online")

⚠️ Error Handling & Retry

If an error occurs during script execution (e.g., network fluctuations or task failure), the Agent should follow this logic:

  1. Check Output Content:

    • If the output contains "Invalid authorization", it means the API Key is invalid or expired. Do not retry; guide the user to re-check and provide the correct API Key.
    • If the output does not contain "Invalid authorization" but the task failed (e.g., output starts with Error: or returns empty results), the Agent should automatically try to re-execute the script once.
  2. Retry Limit:

    • Automatic retry is limited to one time. If the second attempt fails, stop retrying and report the specific error information to the user.

🌟 Typical Use Cases

  1. Local Business Discovery: Find all "Italian restaurants" in Manhattan.
  2. Sales Lead Generation: Extract a list of "real estate agencies" in London for prospecting.
  3. Competitor Mapping: Locate all "Starbucks" branches in a specific city to map competition.
  4. Market Research: Analyze "boutique hotels" in Paris, including their ratings and price ranges.
  5. Contact Collection: Gather addresses and names of "dental clinics" in Sydney.
  6. Service Search: Find "24-hour pharmacies" or "emergency plumbers" in a certain area.
  7. Neighborhood Monitoring: Track new "gyms" or "yoga studios" opening in a community.
  8. Structured Data Export: Export structured data of "car dealerships" for CRM integration.
  9. Sentiment Analysis Prep: Get review snippets and ratings for "popular tourist attractions".
  10. Global Search Localization: Use different language and country settings to research "tech hubs" globally.

© browser-act, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file (scripts) in solutions/lead-generation/google-maps-search-api-skill of browser-act/skills.

  • SKILL.md
  • scripts/google_maps_search_api.py

Open the folder on GitHubat commit 11c057b

Used in 1 other repository

We found 1 copy of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in browser-act/skills, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Google Maps Search API Skill next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Google Maps Search API Skill compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Google Maps Search API Skill this skillbrowser-act/skills6.1k1 repos~1.6kAutomated safety check: PassMIT
Local Business B2B ProspectingHermes-brasil/hermes-brasil152—~1.1kAutomated safety check: PassMIT
Lead Gen Tool Builderexplorium-ai/gtm-skills160—~1.8kAutomated safety check: NotesMIT
B2B Lead Generationminhnv0807/ai-business-skills608—~1.2kAutomated safety check: PassMIT
Money Outreachiamzifei/show-me-the-money1k—~3kAutomated safety check: PassCustom licence
33 B2b Lead Genminhnv0807/ai-business-skills608—~3.1kAutomated safety check: PassMIT

Similar skills

  • Local Business B2B Prospecting

    Hermes-brasil/hermes-brasil

    Runs a B2B prospecting pipeline for local shops in Brazil: Google Places lead collection, WhatsApp or Instagram filtering, messaging and SQLite logging.

    152 GitHub stars~1.1k tokensUpdated 2 days ago
    Sales & SupportAuto-check passed
  • Lead Gen Tool Builder

    explorium-ai/gtm-skills

    Lead generation tool builder skill for Claude Code and Codex: scaffolds a complete, self-hostable, ZoomInfo-style B2B lead-generation web app — company & contact search UI, firmographic and…

    160 GitHub stars~1.8k tokensUpdated 13 days ago
    Sales & SupportAuto-check: notes
  • B2B Lead Generation

    minhnv0807/ai-business-skills

    Plans B2B pipeline work from ICP definition and prospecting through lead scoring, outbound sequences, sales assets and MQL to SQL handoff, aiming at qualified pipeline.

    608 GitHub stars~1.2k tokensUpdated 25 days ago
    Sales & SupportAuto-check passed
  • Money Outreach

    iamzifei/show-me-the-money

    Automated outreach and sales pipeline — cold email sequences, partnership outreach, lead generation, and prospect management.

    1k GitHub stars~3k tokensUpdated 1 mo ago
    Sales & SupportAuto-check passed
  • 33 B2b Lead Gen

    minhnv0807/ai-business-skills

    Dung khi can tim va tiep can khach hang doanh nghiep — xac dinh ICP, dung danh sach prospect co nguon va ngay verify, cham diem Hot/Warm/Cold, va viet outreach qua Zalo, dien thoai, email.

    608 GitHub stars~3.1k tokensUpdated 25 days ago
    Sales & SupportAuto-check passed
  • Targeted Prospecting

    gooseworks-ai/goose-skills

    Build a prospect list of companies with decision makers, verified contact info, and hiring/intent signals.

    1.2k GitHub starsUsed in 1 repo~7.5k tokens
    Sales & SupportAuto-check passed

More from browser-act/skills

All 87 skills in this repo
  • Amazon ASIN Lookup

    browser-act/skills

    Fetches structured Amazon product details such as title, price, ratings and availability for a given ASIN through BrowserAct's lookup API template.

    6.1k GitHub starsUsed in 2 repos~1.5k tokens
    Auto-check passed
  • Amazon Best Sellers Finder

    browser-act/skills

    Extracts structured Amazon product data for a keyword and marketplace through the BrowserAct API, including titles, prices, ratings, reviews, sales volume and promotions.

    6.1k GitHub starsUsed in 2 repos~1.5k tokens
    Auto-check passed
  • Amazon Buy Box Monitor

    browser-act/skills

    Pulls Amazon product details, competing seller prices and seller ratings for a given ASIN through the BrowserAct API, without browser automation.

    6.1k GitHub starsUsed in 2 repos~1.6k tokens
    Auto-check passed
  • Analyzes a competitor's Amazon listing by ASIN with BrowserAct data extraction, then reports what it does well, where the market has gaps and opportunity points for your own listing.

    6.1k GitHub starsUsed in 2 repos~3.2k tokens
    Auto-check passed
  • Pulls structured Amazon search results (titles, ASINs, prices, ratings, specifications) for a keyword and brand through BrowserAct's Amazon Product API template.

    6.1k GitHub starsUsed in 2 repos~1.5k tokens
    Auto-check passed
  • Collects structured product data from Amazon search results for a keyword and optional brand, using a BrowserAct script, for market and competitor research.

    6.1k GitHub starsUsed in 2 repos~1.6k tokens
    Auto-check passed

Questions about Google Maps Search API Skill

What does Google Maps Search API Skill do?

This skill is designed to help users automatically extract business data from Google Maps search results. Google Maps Search API Skill is an agent skill from browser-act/skills. This skill is designed to help users automatically extract business data from Google Maps search results.

When should I use Google Maps Search API Skill?

Google Maps Search API Skill fits situations like: makes the following requests searching for coffee shops in a specific city; finding dentists; medical clinics nearby; tracking competitors locations in a certain area.

How do I install Google Maps Search API Skill in Claude Code?

Run `npx skills add browser-act/skills --skill google-maps-search-api-skill -a claude-code`. Or copy the skill folder (solutions/lead-generation/google-maps-search-api-skill in browser-act/skills) into .claude/skills/google-maps-search-api-skill in your project. Claude Code loads it when a task matches its description.

How do I install Google Maps Search API Skill in Codex?

Run `npx skills add browser-act/skills --skill google-maps-search-api-skill -a codex`. Or copy the skill folder (solutions/lead-generation/google-maps-search-api-skill in browser-act/skills) into .agents/skills/google-maps-search-api-skill in your project. Codex loads it when a task matches its description.

Can I use Google Maps Search API Skill in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add browser-act/skills --skill google-maps-search-api-skill -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/google-maps-search-api-skill, .gemini/skills/google-maps-search-api-skill, .github/skills/google-maps-search-api-skill and .opencode/skills/google-maps-search-api-skill in your project.

What does Google Maps Search API Skill need to run?

Going by SKILL.md and its folder, Google Maps Search API Skill needs Python for the scripts in its folder, the command-line tools its instructions call (python) and credentials named BROWSERACT_API_KEY. Our summary lists: Python 3; A credential in BROWSERACT_API_KEY.

Does Google Maps Search API Skill access the network?

SKILL.md names 1 domain. As links in the text: browseract.com. This is read from the text; nothing was executed.

Is Google Maps Search API Skill safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Google Maps Search API Skill use?

Google Maps Search API Skill is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Google Maps Search API Skill use?

About 1.6k tokens (SKILL.md is roughly 6.2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Google Maps Search API Skill?

Skills that share tags, products or a category with Google Maps Search API Skill: Local Business B2B Prospecting (Hermes-brasil/hermes-brasil, 152 stars), Lead Gen Tool Builder (explorium-ai/gtm-skills, 160 stars), B2B Lead Generation (minhnv0807/ai-business-skills, 608 stars) and Money Outreach (iamzifei/show-me-the-money, 1k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Google Maps Search API Skill?

browser-act (a GitHub organization) maintains it in browser-act/skills, which has 6,108 GitHub stars. The repository holds 87 skills in this directory. The repository was last updated on August 24, 2026.

Source: browser-act/skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.