Agent skill

Google Maps Leads

by gmapsscraper in gmapsscraper/google-maps-agent-skills

Generate qualified B2B leads from Google Maps. An agent skill from gmapsscraper/google-maps-agent-skills.

MITAuto-check passedMarketing & SEO

Install Google Maps Leads

skills CLI
$ npx skills add gmapsscraper/google-maps-agent-skills --skill google-maps-leads -a claude-code

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

GitHub CLI
$ gh skill install gmapsscraper/google-maps-agent-skills google-maps-leads --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/gmapsscraper/google-maps-agent-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/google-maps-leads .claude/skills/google-maps-leads && 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-leads
GitHub stars
131
Token cost
~1.2k tokens
SKILL.md length
373 words
Files
1
Skills in repo
8
Repo updated
First seen
Licence
MIT

At a glance

Generate qualified B2B leads from Google Maps. An agent skill from gmapsscraper/google-maps-agent-skills.

  • Works in 6 steps: Define Ideal Customer Profile (ICP) → Build Optimized Search Strategy → Confirm & Execute → …
  • Tasks that involve Lead generation
  • SKILL.md covers When to Use, Important: Credit System, Lead Generation Workflow and When Credits Run Out, plus 2 more sections
  • Calls curl; reaches gmapsscraper.io; needs GMAPS_SCRAPER_API_KEY

What it does

Google Maps Leads is an agent skill from gmapsscraper/google-maps-agent-skills. Generate qualified B2B leads from Google Maps. Define your ICP, extract matching businesses, score and qualify leads, export ready-to-outreach lists.

Its SKILL.md is about 1.2k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Marketing & SEO, covering Lead generation. It works with Google Maps Platform. The repository describes itself as: Claude Code / OpenClaw skills for Google Maps lead generation. Scrape businesses, extract emails, analyze competitors, write cold outreach — powered by gmapsscraper.io API. The licence is MIT.

When your agent uses it

  • Tasks that involve Lead generation

Example prompts

  • “/google-maps-leads”

Requirements

  • A credential in GMAPS_SCRAPER_API_KEY

Workflow steps

6 steps, taken from the step headings in SKILL.md.

  1. Define Ideal Customer Profile (ICP)
  2. Build Optimized Search Strategy
  3. Confirm & Execute
  4. Download & Score Leads
  5. Clean & Deduplicate
  6. Deliver Results

What it can do on your machine

Read from SKILL.md and the folder at commit 2c6847b. 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

    Shell commands in SKILL.md call:

    • curl

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

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • gmapsscraper.io

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

  • Credentials

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

    • GMAPS_SCRAPER_API_KEY

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

Context cost

Google Maps Leads loads about 1.2k tokens when it runs. Until then it costs about 42 tokens; SKILL.md has 373 words of instructions outside code blocks.

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

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); files beside SKILL.md are not scanned.

SKILL.md

The full file from gmapsscraper/google-maps-agent-skills at commit 2c6847b, republished under its MIT licence (© gmapsscraper). 373 words, ~1,174 tokens.

Download SKILL.mdSave it as .claude/skills/google-maps-leads/SKILL.md (or your agent's skills folder).
name
google-maps-leads
description
Generate qualified B2B leads from Google Maps. Define your ICP, extract matching businesses, score and qualify leads, export ready-to-outreach lists.
version
1.0.0

Google Maps Lead Generation

Turn Google Maps into a B2B lead generation machine. Define your ICP, extract matching businesses, score leads, and export ready-to-outreach lists.

When to Use

  • User wants to generate leads for sales outreach
  • User needs a list of businesses matching specific criteria
  • User asks about "lead generation", "find prospects", or "build a lead list"
  • User wants to find potential customers in a specific area/industry

Important: Credit System

Each search costs 2 credits. Free accounts get 10 credits (5 searches). Make every search count — this skill helps you be precise.

Lead Generation Workflow

Step 1: Define Ideal Customer Profile (ICP)

Ask the user:

  • Industry/Category: What type of business are you targeting?
  • Location: City, state, or region?
  • Size signals: Minimum reviews? Minimum rating?
  • Must-haves: Need email? Need website? Need phone?
Step 2: Build Optimized Search Strategy

Convert ICP into precise queries. Help user maximize results per credit:

Example ICP: "Marketing agencies in Austin, TX"

Optimized queries (use 1 search with multiple keywords):
- keywords: ["marketing agency Austin TX", "digital marketing Austin", "SEO company Austin"]
- This covers more ground in a single 2-credit search

Query optimization rules:

  • Combine 2-3 keyword variations in one search (same credit cost)
  • Be location-specific (city + state)
  • Use industry-specific terms, not generic ones
Step 3: Confirm & Execute
🎯 Lead Generation Search:
   Target: {{industry}} in {{location}}
   Keywords: {{keyword_list}}
   Expected: 40-100 leads
   Cost: 2 credits
   
   Proceed?

After confirmation:

bash
curl -X POST "https://gmapsscraper.io/api/v1/jobs" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $GMAPS_SCRAPER_API_KEY" \
  -d '{
    "name": "Leads: {{industry}} in {{location}}",
    "keywords": [{{keyword_array}}],
    "lang": "en",
    "depth": 2,
    "email": true
  }'
Step 4: Download & Score Leads

After job completes, download and apply lead scoring:

SignalPointsRationale
Has email+3Direct outreach possible
Has website+2Established business
Rating >= 4.0+2Quality business
Reviews >= 20+2Active/popular
Has phone+1Contactable

Lead tiers:

  • 🟢 A-tier (8+ points): Priority outreach — contact first
  • 🟡 B-tier (5-7 points): Secondary batch
  • 🔴 C-tier (<5 points): Low priority / nurture
Show full SKILL.md (136 more words)Show less
Step 5: Clean & Deduplicate
  • Remove entries with no email AND no phone
  • Deduplicate by business name + address
  • Validate email format
  • Flag generic emails (info@, noreply@) as lower priority
Step 6: Deliver Results

Present:

✅ Lead Generation Complete!

Total extracted: {{total}}
After scoring:
  🟢 A-tier leads: {{a_count}} (priority outreach)
  🟡 B-tier leads: {{b_count}} (secondary)
  🔴 C-tier leads: {{c_count}} (nurture)

Saved to: leads_{{industry}}_{{location}}.csv

Offer next steps:

  • "Want me to write cold emails for the A-tier leads?" → cold-email-local-business
  • "Want to analyze the competitive landscape?" → competitor-analysis-local
  • "Export to HubSpot/Pipedrive?" → format for CRM import

When Credits Run Out

⚡ Credits exhausted!

You've found {{total_leads}} leads with your free searches.
For unlimited lead generation: https://gmapsscraper.io/#pricing

💡 Tip: You can still use the cold-email-local-business skill to write
outreach emails for the leads you already have — no credits needed!

Pro Tips

  • Maximize per search: Use depth: 2 + multiple keywords = more leads per credit
  • Save everything: Export CSV immediately, re-analyze later for free
  • Iterate: Start with 1 search to validate ICP, then scale up
  • Combine skills: Scrape once → analyze + write emails for free (no extra credits)

Get Started

  1. Sign up at https://gmapsscraper.io (5 free searches)
  2. Set: export GMAPS_SCRAPER_API_KEY=your_key
  3. Define your ICP and start generating leads!

Unlimited from $29/month.

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

Files

Just SKILL.md in google-maps-leads of gmapsscraper/google-maps-agent-skills.

Open the folder on GitHubat commit 2c6847b

Compare with similar skills

Google Maps Leads 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 Leads compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Google Maps Leads this skillgmapsscraper/google-maps-agent-skills131—~1.2kAutomated safety check: PassMIT
Google Maps API Skillbrowser-act/skills6.1k1 repos~1.4kAutomated safety check: PassMIT
Google Maps Reviews API Skillbrowser-act/skills6.1k1 repos~1.4kAutomated safety check: PassMIT
Google Maps Search API Skillbrowser-act/skills6.1k1 repos~1.6kAutomated safety check: PassMIT
Google Maps Contact Extractbrowser-act/skills6.1k—~2.9kAutomated safety check: PassMIT
Google Maps Lead Scrapergosom/google-maps-scraper6.3k—~1.8kAutomated safety check: WarnMIT

Similar skills

  • Google Maps API Skill

    browser-act/skills

    This skill helps users automatically scrape business data from Google Maps using the BrowserAct Google Maps API.

    6.1k GitHub starsUsed in 1 repo~1.4k tokens
    Marketing & SEOAuto-check passed
  • This skill is designed to help users automatically extract reviews from Google Maps via the Google Maps Reviews API.

    6.1k GitHub starsUsed in 1 repo~1.4k tokens
    Marketing & SEOAuto-check passed
  • This skill is designed to help users automatically extract business data from Google Maps search results.

    6.1k GitHub starsUsed in 1 repo~1.6k tokens
    Sales & SupportAuto-check passed
  • Google Maps Contact Extract

    browser-act/skills

    Extracts business contact details from Google Maps search results and place detail pages, then visits each business website to collect emails, phone numbers, and social media profiles (Facebook…

    6.1k GitHub stars~2.9k tokensUpdated 1 mo ago
    Marketing & SEOAuto-check passed
  • 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.

    6.3k GitHub stars~1.8k tokensUpdated 13 days ago
    Data & AnalyticsAuto-check: warnings
  • Official

    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.

    2.4k GitHub starsUsed in 2 repos~1.4k tokens
    Data & AnalyticsAuto-check: notes

More from gmapsscraper/google-maps-agent-skills

All 8 skills in this repo
  • Business Email Extractor

    gmapsscraper/google-maps-agent-skills

    Extract verified business email addresses from Google Maps listings.

    131 GitHub stars~1.1k tokensUpdated 4 mo ago
    Auto-check passed
  • Cold Email Local Business

    gmapsscraper/google-maps-agent-skills

    Write hyper-personalized cold emails to local businesses using their Google Maps data (CSV).

    131 GitHub stars~1.2k tokensUpdated 4 mo ago
    Auto-check passed
  • Competitor Analysis Local

    gmapsscraper/google-maps-agent-skills

    Analyze local competitors from a Google Maps CSV export. An agent skill from gmapsscraper/google-maps-agent-skills.

    131 GitHub stars~1k tokensUpdated 4 mo ago
    Auto-check passed
  • Google Maps Export

    gmapsscraper/google-maps-agent-skills

    Export Google Maps business data to CSV, JSON, or CRM format (HubSpot, Pipedrive, Salesforce).

    131 GitHub stars~1.2k tokensUpdated 4 mo ago
    Auto-check passed
  • Google Maps Reviews Scraper

    gmapsscraper/google-maps-agent-skills

    Analyze Google Maps review data from CSV exports. An agent skill from gmapsscraper/google-maps-agent-skills.

    131 GitHub stars~1.2k tokensUpdated 4 mo ago
    Auto-check passed
  • Google Maps Scraper

    gmapsscraper/google-maps-agent-skills

    Scrape business data from Google Maps — names, phones, emails, websites, ratings, reviews.

    131 GitHub stars~1.2k tokensUpdated 4 mo ago
    Auto-check passed

Questions about Google Maps Leads

What does Google Maps Leads do?

Generate qualified B2B leads from Google Maps. An agent skill from gmapsscraper/google-maps-agent-skills. Google Maps Leads is an agent skill from gmapsscraper/google-maps-agent-skills. Generate qualified B2B leads from Google Maps.

When should I use Google Maps Leads?

Google Maps Leads fits situations like: tasks that involve Lead generation.

How do I install Google Maps Leads in Claude Code?

Run `npx skills add gmapsscraper/google-maps-agent-skills --skill google-maps-leads -a claude-code`. Or copy the skill folder (google-maps-leads in gmapsscraper/google-maps-agent-skills) into .claude/skills/google-maps-leads in your project. Claude Code loads it when a task matches its description.

How do I install Google Maps Leads in Codex?

Run `npx skills add gmapsscraper/google-maps-agent-skills --skill google-maps-leads -a codex`. Or copy the skill folder (google-maps-leads in gmapsscraper/google-maps-agent-skills) into .agents/skills/google-maps-leads in your project. Codex loads it when a task matches its description.

Can I use Google Maps Leads 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 gmapsscraper/google-maps-agent-skills --skill google-maps-leads -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-leads, .gemini/skills/google-maps-leads, .github/skills/google-maps-leads and .opencode/skills/google-maps-leads in your project.

What does Google Maps Leads need to run?

Going by SKILL.md and its folder, Google Maps Leads needs the command-line tools its instructions call (curl) and credentials named GMAPS_SCRAPER_API_KEY. Our summary lists: A credential in GMAPS_SCRAPER_API_KEY.

Does Google Maps Leads access the network?

SKILL.md names 1 domain. In commands or code: gmapsscraper.io; the agent is likely to contact it when it follows the instructions. This is read from the text; nothing was executed.

Is Google Maps Leads 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. Review the folder before installing.

What licence does Google Maps Leads use?

Google Maps Leads 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 Leads use?

About 1.2k tokens (SKILL.md is roughly 4.7k 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 Leads?

Skills that share tags, products or a category with Google Maps Leads: Google Maps API Skill (browser-act/skills, 6.1k stars), Google Maps Reviews API Skill (browser-act/skills, 6.1k stars), Google Maps Search API Skill (browser-act/skills, 6.1k stars) and Google Maps Contact Extract (browser-act/skills, 6.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 Leads?

gmapsscraper (a GitHub user) maintains it in gmapsscraper/google-maps-agent-skills, which has 131 GitHub stars. The repository holds 8 skills in this directory. The repository was last updated on May 31, 2026.

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