Google Maps Scraper for Openclaw

A powerful lead generation skill that extracts business names, websites, emails, phone numbers, and reviews directly from Google Maps into organized CSV files.

gmapsscraper
v1.0.0
Jun 12, 2026
0
596
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install google-maps-scraper

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install google-maps-scraper using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).

Prefer to download?

Get the raw skill files in a ZIP archive.

What is Google Maps Scraper?

The Google Maps Scraper skill enables developers and digital marketers to leverage Openclaw Skills to harvest high-quality B2B leads from Google Maps. By interfacing directly with the gmapsscraper.io API, this skill extracts rich business intelligence including contact information, geographic coordinates, social proof (ratings and review counts), and even deep-crawled email addresses.

Designed to run seamlessly within your AI agent workflows, this skill prioritizes credit efficiency and data precision. It provides a structured mechanism to target specific business niches within local geographic regions, converting raw map results into actionable, structured data schemas.

Google Maps Scraper Use Cases

  • Building targeted lead lists for local email outreach or cold-calling campaigns.
  • Executing local competitor analysis by monitoring business ratings, review counts, and physical footprints.
  • Aggregating local business directories with complete metadata, including websites, geo-coordinates, and operational hours.
  • Syncing localized business data directly with CRMs like HubSpot or Pipedrive for immediate sales pipeline integration.

How Google Maps Scraper Works

  1. Parameters Definition: The AI agent prompts you to define highly specific keywords, targeted locations, and desired result quantities to avoid wasting API credits.
  2. Credit Optimization Confirmation: The agent calculates the estimated credit cost (typically 2 credits per search) and displays a summary for your explicit confirmation before launching the scrape.
  3. Initiating Scrape Execution: Upon validation, the skill triggers a POST request to the gmapsscraper.io API, utilizing your configured API key and starting the scraping process with parameters like depth and custom radius.
  4. Asynchronous Status Polling: The skill continuously polls the scraping job status every 10 seconds until the API returns a status of completed.
  5. CSV Retrieval & Download: Once completed, the raw scraped CSV payload is downloaded directly to your local workspace.
  6. Lead Analysis & Enrichment: The agent cleans up the data, organizes the top-tier leads based on review count and rating, and suggests integrated downstream steps like crafting cold emails.

Google Maps Scraper Setup

To get started with this scrape integration, make sure you have the required CLI tools installed and an active API key.

1. Requirements

  • curl CLI tool
  • An account on gmapsscraper.io (free signup includes 5 searches)

2. Configure Environment Variable

Export your API key to your system environment to allow the agent to authorize requests:

export GMAPS_SCRAPER_API_KEY='your_gmaps_scraper_api_key_here'

3. Verification

Once configured, the agent will automatically detect the presence of the environment variable when utilizing this workflow within Openclaw Skills.

Google Maps Scraper Data Schema & Taxonomy

This skill downloads business data structured in CSV format containing the following fields:

Field Name Description Type Example
title The official business name String Austin Dental Care
address Full physical address String 123 Main St, Austin, TX 78701
phone Direct contact phone number String +1-512-555-0199
website Business URL String https://austindental.com
email Scraped email address (when available) String [email protected]
rating Google Maps rating (1.0 to 5.0) Float 4.8
reviews_count Total number of reviews on Google Maps Integer 124
category Primary business classification category String Dentist
latitude Geographic latitude coordinate Float 30.2672
longitude Geographic longitude coordinate Float -97.7431
google_maps_url Direct link to the Google Maps listing String https://maps.google.com/?cid=...
opening_hours Structured weekly business hours String Monday: 8:00 AM – 5:00 PM

Google Maps Scraper Advanced Features

  • Deep Email Harvesting: Set email: true with a scraping depth of 2 to discover contact details hidden within target websites.
  • Adjustable Spatial Radius: Fine-tune target coordinates using the radius (in meters) and zoom parameters to target specific neighborhood blocks.
  • Language Localization: Pass the lang ISO code parameter (e.g., 'es') to retrieve localized reviews and business names in foreign markets.
  • Fast Mode Scrape: Disable deep email extraction using fast_mode: true to accelerate lead generation speed when contact info is not required.
  • Downstream Automation Hooks: Seamless integration with downstream templates such as local competitor analysis or cold emailing campaigns based on extracted CSV structures.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*