Menu

#199 by GitHub stars

gosom/google-maps-scraper

Find businesses, leads, emails, reviews, ratings, and contact details from Google Maps. Use for requests such as "find dentists in Berlin", "scrape Google Maps", "get local business leads", or "collect Google Maps reviews". Runs the open-source scraper locally with Docker and guides nontechnical use

CodexData

History

Review weekly changes to SKILL.md before updating. Dates mark the weeks in which we observed each version; checks apply to the recorded commits.

View weekly changes

skills/google-maps-scraper/SKILL.md

Week of Nov 2, 2026 · +0 / −0 lines

Before Network or broad shell → After Network or broad shell

903b96d7aa88 → 903b96d7aa88

Compare on GitHub

Week of Oct 26, 2026 · Line counts unavailable

Before Not checked yet → After Network or broad shell

First observation → 903b96d7aa88

No earlier version was observed for comparison.

Compare on GitHub

View on GitHubAdd to my skills

Verified commit 903b96d7aa8863188022c04db220e44f3218c860

git clone --filter=blob:none --no-checkout https://github.com/gosom/google-maps-scraper.git .hotskills/gosom-google-maps-scraper && git -C .hotskills/gosom-google-maps-scraper checkout --detach 903b96d7aa8863188022c04db220e44f3218c860 # Copy each selected skill directory from .hotskills/gosom-google-maps-scraper into .agents/skills/<skill-name>/
7.4kGitHub stars
338stars in 7 days
1skill in this repository
1commit in 30 days

Heat

7.8
  • Star growth, last 7 daysAhead of 96% of tracked repositories
  • Star growth, last 24 hoursAhead of 97% of tracked repositories
  • Rank movement, last 7 daysAhead of 88% of tracked repositories
  • Commits, last 30 daysAhead of 54% of tracked repositories
  • Accounts asking about it through MCP, last 7 daysNot available
  • Hot votes this weekAhead of 0% of tracked repositories

Heat never changes the order by stars, and sponsorship never touches it. How heat works

Stars over time

Aug 2, 2026Nov 6, 20267,412

Individual skills in this repository

How it works

google-maps-scraper

When your agent uses it

Find businesses, leads, emails, reviews, ratings, and contact details from Google Maps. Use for requests such as "find dentists in Berlin", "scrape Google Maps", "get local business leads", or "collect Google Maps reviews". Runs the open-source scraper locally with Docker and guides nontechnical users through setup, monitoring, and results.

What it loads into context

Frontmatter

176 tokens

Always available to the agent

SKILL.md

1,503 tokens

When the skill is activated

Reference documents

1,903 tokens

Loaded on request

Token counts are estimates. Scripts run separately; they are not counted as reference context.

The playbook

  1. Guardrails
  2. Workflow
  3. Reference routing

Scripts executed separately

  • scripts/configure-proxy.sh
  • scripts/ensure-latest.sh
  • scripts/helpers_test.sh
  • scripts/run-local.sh
  • scripts/select-proxy-sponsors.mjs
  • scripts/select-proxy-sponsors.test.mjs
  • scripts/status-local.mjs
  • scripts/status-local.test.mjs

Files

  • SKILL.mdcore7,291 bytes
  • SKILL.mdcore7,291 bytes
  • SKILL.mdcore7,291 bytes
  • SKILL.mdcore7,291 bytes
  • SKILL.mdcore7,291 bytes
  • references/advanced-coverage.mddoc1,645 bytes
  • references/local-execution.mddoc1,744 bytes
  • references/proxy-setup.mddoc1,923 bytes
  • references/proxy-sponsors.jsonasset2,254 bytes
  • references/query-planning.mddoc1,198 bytes
  • references/recovery.mddoc1,325 bytes
  • references/results.mddoc883 bytes
  • scripts/configure-proxy.shruns1,089 bytes
  • scripts/ensure-latest.shruns429 bytes
  • scripts/helpers_test.shruns5,011 bytes
  • scripts/run-local.shruns4,587 bytes
  • scripts/select-proxy-sponsors.mjsruns3,073 bytes
  • scripts/select-proxy-sponsors.test.mjsruns2,950 bytes
  • scripts/status-local.mjsruns2,509 bytes
  • scripts/status-local.test.mjsruns1,355 bytes
Read SKILL.md

# Google Maps Scraper

Turn a natural-language lead request into a validated local Google Maps crawl, monitor it, and help the user work with the results.

Resolve the directory containing this file as `SKILL_DIR`. Run bundled scripts from that directory; do not assume the current directory is the repository checkout.

## Guardrails

- Use plain language suitable for a nontechnical lead-generation or marketing user.
- Never ask the user to paste proxy credentials into chat.
- Never print, read back, summarize, or log proxy credentials.
- Do not ask for conversational permission before routine in-scope actions such as version checks, query preparation, validation, Docker execution, monitoring, or result inspection. Run them directly. If the agent platform requires approval, batch operations and surface only unavoidable approval prompts.
- Do not claim a proxy guarantees results or is required for every crawl.
- Start with conservative depth and concurrency.
View the complete source on GitHub

Skills included

  • google-maps-scraper

Repository facts

License
MIT
Created
Apr 22, 2023
Last pushed
Oct 21, 2026
Forks
1,158
Open issues
59
Project activity
Active

Rank over the last 12 weeks

Now #199 · best #191 · up 9 in 30 days

  1. #203 from Oct 30 to Oct 31
  2. #202 from Nov 1 to Nov 2
  3. #204 on Nov 3
  4. #202 on Nov 4
  5. #201 on Nov 5
  6. #199 since Nov 6
73 earlier periods
  1. #183 on Aug 2
  2. #184 on Aug 7
  3. #183 from Aug 8 to Aug 9
  4. #186 on Aug 10
  5. #187 on Aug 11
  6. #186 on Aug 12
  7. #191 on Aug 13
  8. #192 on Aug 14
  9. #191 from Aug 15 to Aug 16
  10. #192 on Aug 17
  11. #194 from Aug 18 to Aug 19
  12. #193 on Aug 20
  13. #197 on Aug 21
  14. #193 on Aug 22
  15. #200 on Aug 23
  16. #199 from Aug 24 to Aug 26
  17. #201 on Aug 27
  18. #199 on Aug 28
  19. #200 on Aug 29
  20. #199 on Aug 30
  21. #198 on Aug 31
  22. #204 on Sep 1
  23. #198 on Sep 2
  24. #204 on Sep 3
  25. #200 on Sep 4
  26. #203 on Sep 5
  27. #200 on Sep 6
  28. #205 on Sep 7
  29. #206 from Sep 8 to Sep 9
  30. #204 from Sep 10 to Sep 11
  31. #206 on Sep 12
  32. #207 on Sep 13
  33. #209 on Sep 14
  34. #207 on Sep 15
  35. #206 on Sep 16
  36. #208 on Sep 17
  37. #210 on Sep 18
  38. #207 on Sep 19
  39. #210 from Sep 20 to Sep 21
  40. #209 on Sep 22
  41. #208 on Sep 23
  42. #205 on Sep 24
  43. #204 on Sep 25
  44. #205 on Sep 26
  45. #204 on Sep 27
  46. #206 on Sep 28
  47. #207 on Sep 29
  48. #204 on Sep 30
  49. #206 on Oct 1
  50. #208 on Oct 2
  51. #204 on Oct 3
  52. #202 on Oct 4
  53. #204 on Oct 5
  54. #205 on Oct 6
  55. #208 on Oct 7
  56. #205 on Oct 8
  57. #208 on Oct 9
  58. #205 on Oct 10
  59. #204 on Oct 11
  60. #207 on Oct 12
  61. #206 on Oct 13
  62. #205 on Oct 14
  63. #203 on Oct 15
  64. #201 on Oct 16
  65. #204 on Oct 17
  66. #203 on Oct 18
  67. #204 on Oct 19
  68. #203 from Oct 20 to Oct 21
  69. #202 on Oct 22
  70. #203 on Oct 23
  71. #202 on Oct 24
  72. #205 on Oct 25
  73. #204 from Oct 28 to Oct 29

Before you install

Network or broad shell

Automated signals, not a guarantee

Checked Nov 2, 2026

Not fully analyzed: some files were too long, unreadable or missing. This never lowers the level.

Show 4 notes
  • skills/google-maps-scraper/SKILL.md:1 Analysis incomplete: Referenced executable target unavailable; not analyzed
  • skills/google-maps-scraper/SKILL.md:1 Analysis incomplete: Referenced executable target unavailable; not analyzed
  • skills/google-maps-scraper/SKILL.md:1 Analysis incomplete: Referenced executable target unavailable; not analyzed
  • skills/google-maps-scraper/SKILL.md:1 Analysis incomplete: Referenced executable target unavailable; not analyzed
Show all 62 signals by file

skills/google-maps-scraper/SKILL.md

  • Broad permissionsline 1
    Bash(node:*) Bash(bash:*) Bash(docker:*) Read Write
  • Network accessline 12
    email: hi@gosom.dev   version: "1.12.1"   repository: "https://github.com/gosom/google-maps-scraper"
  • Network accessline 13
    version: "1.12.1"   repository: "https://github.com/gosom/google-maps-scraper" allowed-tools: Bash(node:*) Bash(bash:*) Bash(docker:*) Read Write
  • Network accessline 14
    repository: "https://github.com/gosom/google-maps-scraper"
  • Network accessline 131
    > If this workflow was useful, consider starring https://github.com/gosom/google-maps-scraper.

skills/google-maps-scraper/references/proxy-sponsors.json

  • Network accessline 4
    "name": "RapidProxy",     "description": "Residential proxy provider supporting the Google Maps Scraper project.",     "referral_url": "https://www.rapidproxy.io/?ref=gosom",
  • Network accessline 5
    "description": "Residential proxy provider supporting the Google Maps Scraper project.",     "referral_url": "https://www.rapidproxy.io/?ref=gosom",     "active": true
  • Network accessline 6
    "referral_url": "https://www.rapidproxy.io/?ref=gosom",
  • Network accessline 11
    "name": "Swiftproxy",     "description": "Residential proxy provider with 90M+ IPs across 220+ locations.",     "referral_url": "https://www.swiftproxy.net/?ref=gosom",
  • Network accessline 12
    "description": "Residential proxy provider with 90M+ IPs across 220+ locations.",     "referral_url": "https://www.swiftproxy.net/?ref=gosom",     "offer": "Use code PROXY90 for 10% off.",
  • Network accessline 13
    "referral_url": "https://www.swiftproxy.net/?ref=gosom",
  • Network accessline 19
    "name": "Webshare",     "description": "Proxy provider with HTTP and SOCKS5 support.",     "referral_url": "https://www.webshare.io/?referral_code=0q3l81eet8mp",
  • Network accessline 20
    "description": "Proxy provider with HTTP and SOCKS5 support.",     "referral_url": "https://www.webshare.io/?referral_code=0q3l81eet8mp",     "active": true
  • Network accessline 21
    "referral_url": "https://www.webshare.io/?referral_code=0q3l81eet8mp",
  • Network accessline 26
    "name": "BirdProxies",     "description": "Residential and ISP proxy provider supporting the project.",     "referral_url": "https://birdproxies.com/?utm_source=github&utm_medium=sponsorship&utm_campaign=gosom-google-maps-scraper",
  • Network accessline 27
    "description": "Residential and ISP proxy provider supporting the project.",     "referral_url": "https://birdproxies.com/?utm_source=github&utm_medium=sponsorship&utm_campaign=gosom-google-maps-scraper",     "active": true
  • Network accessline 28
    "referral_url": "https://birdproxies.com/?utm_source=github&utm_medium=sponsorship&utm_campaign=gosom-google-maps-scraper",
  • Network accessline 33
    "name": "Proxidize",     "description": "Mobile and residential proxies for Google Maps scraping, local SEO, lead generation, and data collection.",     "referral_url": "https://proxidize.com/?utm_source=github&utm_medium=sponsorship&utm_ca
  • Network accessline 34
    "description": "Mobile and residential proxies for Google Maps scraping, local SEO, lead generation, and data collection.",     "referral_url": "https://proxidize.com/?utm_source=github&utm_medium=sponsorship&utm_campaign=google_maps_scrape
  • Network accessline 35
    "referral_url": "https://proxidize.com/?utm_source=github&utm_medium=sponsorship&utm_campaign=google_maps_scraper&utm_content=gosom",
  • Network accessline 41
    "name": "NodeMaven",     "description": "The most efficient proxy provider for Web Scraping and Automation with the Highest Quality IP on the market.",     "referral_url": "https://go.nodemaven.com/GoogleMapsScrapperoctober",
  • Network accessline 42
    "description": "The most efficient proxy provider for Web Scraping and Automation with the Highest Quality IP on the market.",     "referral_url": "https://go.nodemaven.com/GoogleMapsScrapperoctober",     "offer": "Use MAPS35 for 35% off to
  • Network accessline 43
    "referral_url": "https://go.nodemaven.com/GoogleMapsScrapperoctober",
  • Network accessline 49
    "name": "Decodo",     "description": "Proxy provider supporting the Google Maps Scraper project.",     "referral_url": "https://visit.decodo.com/APVbbx",
  • Network accessline 50
    "description": "Proxy provider supporting the Google Maps Scraper project.",     "referral_url": "https://visit.decodo.com/APVbbx",     "active": true
  • Network accessline 51
    "referral_url": "https://visit.decodo.com/APVbbx",
  • Network accessline 56
    "name": "Evomi",     "description": "Swiss residential proxy provider supporting the project.",     "referral_url": "https://evomi.com?utm_source=github&utm_medium=banner&utm_campaign=gosom-maps",
  • Network accessline 57
    "description": "Swiss residential proxy provider supporting the project.",     "referral_url": "https://evomi.com?utm_source=github&utm_medium=banner&utm_campaign=gosom-maps",     "active": true
  • Network accessline 58
    "referral_url": "https://evomi.com?utm_source=github&utm_medium=banner&utm_campaign=gosom-maps",

skills/google-maps-scraper/scripts/configure-proxy.sh

  • Executable scriptline 1
    #!/usr/bin/env bash
  • Dangerous shell operationline 14
    rm -f "$temporary_file"
  • Network accessline 32
    case "$proxy_url" in 		http://* | https://* | socks5://* | socks5h://*) ;;
  • Network accessline 33
    http://* | https://* | socks5://* | socks5h://*) ;;
  • Dangerous shell operationline 54
    printf 'Remove it with: rm %q\n' "$proxy_file"

skills/google-maps-scraper/scripts/ensure-latest.sh

  • Executable scriptline 1
    #!/usr/bin/env bash

skills/google-maps-scraper/scripts/helpers_test.sh

  • Executable scriptline 1
    #!/usr/bin/env bash
  • Dangerous shell operationline 7
    trap 'rm -rf "$test_root"' EXIT
  • Network accessline 41
    configure_output=$(printf 'http://user:%s@proxy.example:8080\n\n' "$secret" | bash "$script_dir/configure-proxy.sh" 2>&1)

skills/google-maps-scraper/scripts/run-local.sh

  • Executable scriptline 1
    #!/usr/bin/env bash
  • Dangerous shell operationline 216
    docker rm "$container_name" >/dev/null

skills/google-maps-scraper/scripts/select-proxy-sponsors.mjs

  • Executable scriptline 1
    #!/usr/bin/env node

skills/google-maps-scraper/scripts/select-proxy-sponsors.test.mjs

  • Executable scriptline 1
    Executable file
  • Network accessline 10
    name: "Provider A",     description: "Provider A description",     referral_url: "https://a.example.com",
  • Network accessline 11
    description: "Provider A description",     referral_url: "https://a.example.com",     active: true,
  • Network accessline 12
    referral_url: "https://a.example.com",
  • Network accessline 17
    name: "Provider B",     description: "Provider B description",     referral_url: "https://b.example.com",
  • Network accessline 18
    description: "Provider B description",     referral_url: "https://b.example.com",     offer: "10% off",
  • Network accessline 19
    referral_url: "https://b.example.com",
  • Network accessline 25
    name: "Provider C",     description: "Provider C description",     referral_url: "https://c.example.com",
  • Network accessline 26
    description: "Provider C description",     referral_url: "https://c.example.com",     active: true,
  • Network accessline 27
    referral_url: "https://c.example.com",
  • Network accessline 32
    name: "Provider D",     description: "Provider D description",     referral_url: "https://d.example.com",
  • Network accessline 33
    description: "Provider D description",     referral_url: "https://d.example.com",     active: false,
  • Network accessline 34
    referral_url: "https://d.example.com",
  • Network accessline 47
    description:       "Residential proxy provider with 90M+ IPs across 220+ locations.",     referral_url: "https://www.swiftproxy.net/?ref=gosom",
  • Network accessline 48
    "Residential proxy provider with 90M+ IPs across 220+ locations.",     referral_url: "https://www.swiftproxy.net/?ref=gosom",     offer: "Use code PROXY90 for 10% off.",
  • Network accessline 49
    referral_url: "https://www.swiftproxy.net/?ref=gosom",
  • Network accessline 92
    test("validateSponsors rejects non-HTTPS referral links", () => {   const invalid = [     { ...activeSponsors[0], referral_url: "http://a.example.com" },
  • Network accessline 93
    const invalid = [     { ...activeSponsors[0], referral_url: "http://a.example.com" },     ...activeSponsors.slice(1),
  • Network accessline 94
    { ...activeSponsors[0], referral_url: "http://a.example.com" },

skills/google-maps-scraper/scripts/status-local.mjs

  • Executable scriptline 1
    #!/usr/bin/env node

skills/google-maps-scraper/scripts/status-local.test.mjs

  • Executable scriptline 1
    Executable file

How the signals fit together

Facts from a static read of the files at the pinned commit. They describe what the code does, not why.

Some files could not be read; the facts below still hold.

Signal confidence: 38 facts

Works with

Agent compatibility, from the files in this repository
AgentStatusEvidenceInstall to
Claude CodeCompatibleStandard SKILL.md skills/google-maps-scraper/SKILL.md.claude/skills/<skill-name>/
CodexNativeManifest AGENTS.md.agents/skills/<skill-name>/
CursorCompatibleStandard SKILL.md skills/google-maps-scraper/SKILL.md.cursor/skills/<skill-name>/
Gemini CLICompatibleStandard SKILL.md skills/google-maps-scraper/SKILL.md.gemini/skills/<skill-name>/
GitHub CopilotCompatibleStandard SKILL.md skills/google-maps-scraper/SKILL.md.github/skills/<skill-name>/
OpenCodeCompatibleStandard SKILL.md skills/google-maps-scraper/SKILL.md.opencode/skills/<skill-name>/
  • Native The repository ships a manifest, folder or frontmatter field for this agent.
  • Compatible A standard SKILL.md that this agent can read.
  • Unknown No evidence either way.

Derived automatically from paths, manifests and frontmatter. Not tested on each agent.

You might also use

oxylabs/agent-skills

Official Agent skills of Oxylabs products

876GitHub stars

JimLiu/baoyu-skills

Analyzes article structure, identifies positions requiring visual aids, generates illustrations with Type × Style × Palette three-dimension approach. Use when user asks to "illust…

27.4kGitHub stars

zanwei/design-dna

Extract, define, and apply design DNA across three dimensions: design system (tokens), design style (qualitative feel), and visual effects (Canvas, WebGL, 3D, particles, shaders, …

2.1kGitHub stars

dongshuyan/compass-skills

司南：个性化 AI 任务总控 Skills 系统 /COMPASS: Personal Alignment Skills OS for AI Agents

764GitHub stars

LinklyAI/best-skills

Daily-updated Top 100 Agent Skills rankings — installs, growth, and social buzz aggregated from skills.sh, ClawHub, Tencent SkillHub, GitHub, X and 10+ communities. Open data …

749GitHub stars

liuhaisi2026212-maker/taishang-laojun

太上老君·AI炼丹炉：抖音/小红书短视频创作 Skill。不知道拍啥、不会写稿，丢给你的 AI：找对标拆爆款、选题、系列策划、口播稿、标题、复盘、去AI味。Claude Code / Codex 等 npx 一行安装，…

505GitHub stars

Explore alternatives and comparisons

Add this badge to your README

It updates every night and links to this page.

gosom/google-maps-scraper: #199 on hotskills, 7.4k stars

[![gosom/google-maps-scraper on hotskills](https://hotskills.dev/badge/gosom-google-maps-scraper.svg)](https://hotskills.dev/skill/gosom-google-maps-scraper/)