Google Maps Lead Scraper
gosom/google-maps-scraper
Turns a plain request such as finding dentists in a city into a local Google Maps crawl run with Docker, then monitors it and helps you work with the results.
This skill helps users automatically scrape business data from Google Maps using the BrowserAct Google Maps API.
Install Google Maps API Skill
$ npx skills add browser-act/skills --skill google-maps-api-skill -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install browser-act/skills google-maps-api-skill --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ 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-api-skill .claude/skills/google-maps-api-skill && rm -rf skills-srcUse ~/.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/
Install the "google-maps-api-skill" agent skill from https://github.com/browser-act/skills/tree/main/solutions/lead-generation/google-maps-api-skill into .claude/skills/google-maps-api-skill/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "google-maps-api-skill", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/browser-act/skills/tree/main/solutions/lead-generation/google-maps-api-skillType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add browser-act/skills --skill google-maps-api-skill -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install browser-act/skills google-maps-api-skill --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/browser-act/skills.git skills-src && mkdir -p .agents/skills && cp -r skills-src/solutions/lead-generation/google-maps-api-skill .agents/skills/google-maps-api-skill && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "google-maps-api-skill" agent skill from https://github.com/browser-act/skills/tree/main/solutions/lead-generation/google-maps-api-skill into .agents/skills/google-maps-api-skill/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "google-maps-api-skill", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add browser-act/skills --skill google-maps-api-skill -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install browser-act/skills google-maps-api-skill --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/browser-act/skills.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/solutions/lead-generation/google-maps-api-skill .cursor/skills/google-maps-api-skill && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "google-maps-api-skill" agent skill from https://github.com/browser-act/skills/tree/main/solutions/lead-generation/google-maps-api-skill into .cursor/skills/google-maps-api-skill/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "google-maps-api-skill", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/browser-act/skills.git --path solutions/lead-generation/google-maps-api-skill--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add browser-act/skills --skill google-maps-api-skill -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install browser-act/skills google-maps-api-skill --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/browser-act/skills.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/solutions/lead-generation/google-maps-api-skill .gemini/skills/google-maps-api-skill && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "google-maps-api-skill" agent skill from https://github.com/browser-act/skills/tree/main/solutions/lead-generation/google-maps-api-skill into .gemini/skills/google-maps-api-skill/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "google-maps-api-skill", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install browser-act/skills google-maps-api-skillInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add browser-act/skills --skill google-maps-api-skill -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/browser-act/skills.git skills-src && mkdir -p .github/skills && cp -r skills-src/solutions/lead-generation/google-maps-api-skill .github/skills/google-maps-api-skill && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "google-maps-api-skill" agent skill from https://github.com/browser-act/skills/tree/main/solutions/lead-generation/google-maps-api-skill into .github/skills/google-maps-api-skill/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "google-maps-api-skill", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add browser-act/skills --skill google-maps-api-skill -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install browser-act/skills google-maps-api-skill --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/browser-act/skills.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/solutions/lead-generation/google-maps-api-skill .opencode/skills/google-maps-api-skill && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "google-maps-api-skill" agent skill from https://github.com/browser-act/skills/tree/main/solutions/lead-generation/google-maps-api-skill into .opencode/skills/google-maps-api-skill/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "google-maps-api-skill", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
google-maps-api-skill- GitHub stars
- 6.1k
- Used in
- 1 other repo
- Token cost
- ~1.4k tokens
- SKILL.md length
- 624 words
- Files
- 2 (incl. scripts)
- Skills in repo
- 87
- Repo updated
- First seen
- Licence
- MIT
At a glance
This skill helps users automatically scrape business data from Google Maps using the BrowserAct Google Maps API.
- Works in 5 steps: No Hallucinations: Pre-set workflows… → No Captcha Issues: No need to handle… → No IP Restrictions: No need to handle… → …
- This skill for needs like finding restaurants 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 API Skill is an agent skill from browser-act/skills. This skill helps users automatically scrape business data from Google Maps using the BrowserAct Google Maps API. Agent should proactively trigger this skill for needs like finding restaurants in a specific city, extracting contact info of dental clinics, researching local competitors, collecting addresses of coffee shops, generating lead lists for specific industries, monitoring business ratings and reviews, getting opening hours of local services, finding specialized stores (e.g., Turkish-style restaurants)…
Its SKILL.md is about 1.4k 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_api.py`).
It sits in Marketing & SEO, covering Web scraping, 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
- This skill for needs like finding restaurants in a specific city
- Extracting contact info of dental clinics
- Researching local competitors
- Collecting addresses of coffee shops
Example prompts
- “/google-maps-api-skill”
Requirements
- Python 3
- A credential in BROWSERACT_API_KEY
Workflow steps
5 steps, taken from the first numbered list in SKILL.md.
- No Hallucinations: Pre-set workflows avoid AI generative hallucinations, ensuring stable and precise data extraction.
- No Captcha Issues: No need to handle reCAPTCHA or other verification challenges.
- No IP Restrictions: No need to handle regional IP restrictions or geofencing.
- Faster Execution: Tasks execute faster compared to pure AI-driven browser automation solutions.
- 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 API Skill loads about 1.4k tokens when it runs. Until then it costs about 181 tokens; SKILL.md has 624 words of instructions outside code blocks.
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). 624 words, ~1,398 tokens.
Download SKILL.mdSave it as
.claude/skills/google-maps-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-api-skill
- description
- This skill helps users automatically scrape business data from Google Maps using the BrowserAct Google Maps API. Agent should proactively trigger this skill for needs like finding restaurants in a specific city, extracting contact info of dental clinics, researching local competitors, collecting addresses of coffee shops, generating lead lists for specific industries, monitoring business ratings and reviews, getting opening hours of local services, finding specialized stores (e.g., Turkish-style restaurants), analyzing business categories in a region, extracting website links from local businesses, gathering phone numbers for sales outreach, mapping out service providers in a specific country.
Google Maps Automation Scraper Skill
📖 Introduction
This skill leverages BrowserAct's Google Maps API template to provide a one-stop business data collection service. It extracts structured details directly from Google Maps, including business names, categories, contact info, ratings, and more. Simply provide the search keywords and location bias to get clean, actionable data.
✨ Features
- No Hallucinations: Pre-set workflows avoid AI generative hallucinations, ensuring stable and precise data extraction.
- No Captcha Issues: No need to handle reCAPTCHA or other verification challenges.
- No IP Restrictions: No need to handle regional IP restrictions or geofencing.
- Faster Execution: Tasks execute faster compared to pure AI-driven browser automation solutions.
- 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
Configure the following parameters based on user requirements:
keywords (Search Keywords)
- Type:
string - Description: The query you would search for on Google Maps.
- Example:
coffee shop,dental clinic,Turkish-style restaurant
- Type:
language (UI Language)
- Type:
string - Description: Defines the UI language and returned text language (e.g., en, zh-CN).
- Default:
en
- Type:
country (Country Bias)
- Type:
string - Description: Specifies the country or region bias (e.g., us, gb, ca).
- Default:
us
- Type:
🚀 Usage
Execute the following script to get results in one command:
# Example call
python -u ./scripts/google_maps_api.py "keywords" "language" "country"⏳ 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.
📊 Data Output
Upon success, the script parses and prints the following fields from the API:
Title Name: Official business nameCategory_primary: Main business categoryAddress: Full street addressPhone number: Contact phone numberWebsite link: Official URLRating: Average star ratingreviews_count: Total number of reviewsbusiness_status: Operational status (e.g., operational)
Show full SKILL.md (229 more words)Show less
⚠️ Error Handling & Retry
If an error occurs during script execution (e.g., network fluctuations or task failure), the Agent should follow this logic:
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 withError:or returns empty results), the Agent should automatically try to re-execute the script once.
- If the output contains
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
- Lead Generation: Find "SaaS companies" in "us" for sales outreach.
- Competitor Research: Extract data on "coffee shops" in a specific neighborhood.
- Market Analysis: Identify the density of "dental clinics" in a region.
- Contact Info Retrieval: Get phone numbers and websites for "real estate agencies".
- Local Service Discovery: Find "Turkish-style restaurants" with high ratings.
- Business Status Monitoring: Check if specific stores are "operational".
- Directory Building: Gather addresses and categories for a local business directory.
- Rating Benchmarking: Compare ratings of various "luxury hotels".
- Global Scouting: Research "tech startups" in different countries like "gb" or "au".
- Automated Data Sync: Periodically pull local business data into a CRM.
© 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-api-skill of browser-act/skills.
- SKILL.md
- scripts/google_maps_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 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.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Google Maps API Skill this skillbrowser-act/skills | 6.1k | 1 repos | ~1.4k | Automated safety check: Pass | MIT | |
| Google Maps Lead Scrapergosom/google-maps-scraper | 6.3k | — | ~1.8k | Automated safety check: Warn | MIT | |
| Apify Multi-Platform Scraperapify/agent-skills | 2.4k | 2 repos | ~1.4k | Automated safety check: Notes | None | |
| Apify Buying Signal Detectionapify/awesome-skills | 262 | — | ~5.1k | Automated safety check: Notes | Apache-2.0 | |
| Google Maps List Buildergrowthenginenowoslawski/coldoutboundskills | 740 | — | ~6.2k | Automated safety check: Notes | MIT | |
| Apify Local Business Leads Osmapify/awesome-skills | 262 | — | ~3.8k | Automated safety check: Pass | Apache-2.0 |
Similar skills
- Official
Apify Multi-Platform Scraper
apify/agent-skills
Scrapes public data from social, maps, search and review platforms by choosing from about a hundred Apify Actors and running them through the Apify CLI.
- Official
Apify Buying Signal Detection
apify/awesome-skills
Set up a recurring buying-signal detection pipeline that finds companies showing buying intent across three signal types — job postings (hiring for the persona), fundraising events (recent raises)…
Google Maps List Builder
growthenginenowoslawski/coldoutboundskills
Scrape Google Maps for local businesses by category and location, output CSV ready for cold email enrichment.
- Official
Apify Local Business Leads Osm
apify/awesome-skills
Build a local-business lead list without scraping Google Maps.
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.
More from browser-act/skills
All 87 skills in this repoAmazon 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.
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.
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.
Amazon Listing Competitor Analysis
browser-act/skills
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.
Amazon Product Search Extractor
browser-act/skills
Pulls structured Amazon search results (titles, ASINs, prices, ratings, specifications) for a keyword and brand through BrowserAct's Amazon Product API template.
Amazon Product Search Extractor
browser-act/skills
Collects structured product data from Amazon search results for a keyword and optional brand, using a BrowserAct script, for market and competitor research.
Related
Works with
Questions about Google Maps API Skill
What does Google Maps API Skill do?
This skill helps users automatically scrape business data from Google Maps using the BrowserAct Google Maps API. Google Maps API Skill is an agent skill from browser-act/skills. This skill helps users automatically scrape business data from Google Maps using the BrowserAct Google Maps API.
When should I use Google Maps API Skill?
Google Maps API Skill fits situations like: this skill for needs like finding restaurants in a specific city; extracting contact info of dental clinics; researching local competitors; collecting addresses of coffee shops.
How do I install Google Maps API Skill in Claude Code?
Run `npx skills add browser-act/skills --skill google-maps-api-skill -a claude-code`. Or copy the skill folder (solutions/lead-generation/google-maps-api-skill in browser-act/skills) into .claude/skills/google-maps-api-skill in your project. Claude Code loads it when a task matches its description.
How do I install Google Maps API Skill in Codex?
Run `npx skills add browser-act/skills --skill google-maps-api-skill -a codex`. Or copy the skill folder (solutions/lead-generation/google-maps-api-skill in browser-act/skills) into .agents/skills/google-maps-api-skill in your project. Codex loads it when a task matches its description.
Can I use Google Maps 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-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-api-skill, .gemini/skills/google-maps-api-skill, .github/skills/google-maps-api-skill and .opencode/skills/google-maps-api-skill in your project.
What does Google Maps API Skill need to run?
Going by SKILL.md and its folder, Google Maps 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 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 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 API Skill use?
Google Maps 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 API Skill use?
About 1.4k tokens (SKILL.md is roughly 5.6k 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 API Skill?
Skills that share tags, products or a category with Google Maps API Skill: Google Maps Lead Scraper (gosom/google-maps-scraper, 6.3k stars), Apify Multi-Platform Scraper (apify/agent-skills, 2.4k stars), Apify Buying Signal Detection (apify/awesome-skills, 262 stars) and Google Maps List Builder (growthenginenowoslawski/coldoutboundskills, 740 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Google Maps 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.