How creaofc/google-map-scrapper-kit works
Google Maps Scraper Kit is a local wrapper and set of interfaces for the upstream scraper, not the scraper engine itself. Users provide a business query and location; an interface geocodes it when needed, creates and polls a scraper job, downloads and cleans the results, and saves or displays a lead list. Optional website-based social enrichment is available in the Python CLI. The graph separates the documented Claude workflow, Python clients, and web interfaces. Some UI behavior is only partially excerpted; unsampled links are omitted or marked unverified.
Main entry points: scrape.py Python CLI · gui_server.py Dashboard Server · SKILL.md Scraper Skill · easy_scrape.py Easy CLI
Components 21
User Interfaces
- Slash Commands
.claude/commands - Scraper Skill
.claude/skills/google-maps-scraper/SKILL.md - Python CLI
scripts/scrape.py - Easy CLI
scripts/easy_scrape.py - Dashboard Page
scripts/gui.html - Dashboard Server
scripts/gui_server.py - Lead Scraper UI
scripts/ui_server.py
Scrape Workflow
- Location Geocoding
scripts/easy_scrape.py - Job API Client
scripts/scrape.py - Dashboard Job Handler
scripts/gui_server.py - UI API Proxy
scripts/ui_server.py
Lead Results
- Lead Cleanup
scripts/scrape.py - Social Enrichment
scripts/scrape.py - Lead Files
- Dashboard Results
scripts/gui_server.py - UI Results
scripts/ui_server.py
External Services
- Upstream Scraper API
- Nominatim
- Business Websites
Other components
- User
- Claude Code
Connections 26
- User → Python CLI: runs query
README.md - User → Easy CLI: runs query
README.md - User → Dashboard Page: enters search
README.md - Dashboard Page → Dashboard Server: sends requests
- User → Lead Scraper UI: uses interface
README.md - Claude Code → Scraper Skill: invokes
README.md - Scraper Skill → Slash Commands: uses workflow
- Scraper Skill → Upstream Scraper API: drives jobs
README.md - Easy CLI → Location Geocoding: geocodes location
scripts/easy_scrape.py - Location Geocoding → Nominatim: queries
scripts/easy_scrape.py - Easy CLI → Upstream Scraper API: creates and polls
scripts/easy_scrape.py - Python CLI → Nominatim: geocodes location
scripts/scrape.py - Python CLI → Upstream Scraper API: creates and polls
scripts/scrape.py - Python CLI → Lead Cleanup: selects fields
scripts/scrape.py - Python CLI → Social Enrichment: optionally enriches
scripts/scrape.py - Social Enrichment → Business Websites: fetches pages
scripts/scrape.py - Lead Cleanup → Lead Files: writes CSV or JSON
scripts/scrape.py - Social Enrichment → Lead Files: adds social fields
scripts/scrape.py - Dashboard Server → Dashboard Page: serves page
scripts/gui_server.py - Dashboard Server → Nominatim: geocodes location
scripts/gui_server.py - Dashboard Server → Upstream Scraper API: creates and checks jobs
scripts/gui_server.py - Dashboard Server → Dashboard Results: returns cleaned rows
scripts/gui_server.py - Lead Scraper UI → UI API Proxy: sends requests
scripts/ui_server.py - UI API Proxy → Nominatim: geocodes location
scripts/ui_server.py - UI API Proxy → Upstream Scraper API: proxies job requests
scripts/ui_server.py - Lead Scraper UI → UI Results: renders and exports
scripts/ui_server.py