google-maps-list-builder

Scrape Google Maps business listings by category and location into CSV files.

Updated May 28, 2025
One-click install
npx skills add https://github.com/meloShaya/insteltech --skill google-maps-list-builder-meloshaya
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: google-maps-list-builder
Source: https://github.com/meloShaya/insteltech/tree/main/crm/library/skills/google-maps-list-builder
Command: npx skills add https://github.com/meloShaya/insteltech --skill google-maps-list-builder-meloshaya

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires typescript, bottleneck, tsx.

What problem does it solve? Building targeted prospect lists for cold outreach requires manually collecting local business data from Google Maps, which is slow and error-prone. This Skill automates scraping businesses by category and location (zip code, city, or state) and outputs a deduplicated CSV ready for enrichment. ## Core Features & Use Cases - Bulk Location Scraping: Search any business category across thousands of US zip codes using the bundled 42,734-entry zip database, filtered by state, city, or minimum population. - Rate-Limited API Client: TypeScript client for the RapidAPI Maps Data API with 2 req/sec throttling, exponential backoff retries, and automatic deduplication by place_id. - Cold Email Pipeline Integration: Output CSV feeds directly into downstream skills like /blitz-list-builder for owner discovery and /email-waterfall for email enrichment. - Use Case: A sales team targeting dentists in Texas runs the scraper with --state=TX --min-pop=5000, gets a CSV of practices with phone, website, and ratings, then qualifies the list before paying for contact enrichment. ## Quick Start Scrape Google Maps for pizza restaurants in zip codes 10014, 10013, and 10012 and save the results to a CSV file.

Frequently Asked Questions about google-maps-list-builder

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I scrape Google Maps for local business leads?

Use the RapidAPI Maps Data API with a search query and location, such as "dentist in 10014". This Skill's TypeScript client handles rate limiting, retries, and deduplication, then exports results to CSV with name, address, phone, website, and ratings.

How to scrape all businesses in an entire US state?

Pass the --state flag with a two-letter code, optionally adding --min-pop to filter zip codes by population. The bundled database of 42,734 US zip codes lets you cover an entire state without manually listing locations.

Does Google Maps scraping return business owner emails?

No, Google Maps returns business data only: name, address, phone, website, rating, and category. To find owner contacts, run a downstream enrichment step like /blitz-list-builder, then /email-waterfall to fill missing emails.

What are the rate limits for the RapidAPI Maps Data API?

The client is hard-coded to 2 requests per second with automatic retries on 429 and 5xx errors using exponential backoff. Free tier limits depend on your RapidAPI plan; adjust requestsPerSecond if your plan allows more.

Why do I get duplicate businesses when scraping multiple zip codes?

The same business often appears in adjacent zip code searches because results overlap geographically. The scraper deduplicates by place_id after collecting all results, so the final CSV contains only unique businesses.

What is the maximum number of results per Google Maps search?

The API returns a maximum of 20 results per search. To get broader coverage, run searches across multiple overlapping zip codes or cities and rely on place_id deduplication to merge them.