An AI-agent skill utilizing Apify to scrape rich local business data, reviews, images, and website contacts directly from Google Maps.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install google-maps-scraper-apify
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install google-maps-scraper-apify 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 (Apify)?
The Google Maps Scraper Apify skill allows AI agents to easily extract deep business listings, location data, and reviews directly from Google Maps via the Apify platform. By leveraging the power of Openclaw Skills, developers can integrate autonomous lead generation, market research, and regional data collection workflows into their coding agents. It automates the generation of complex payloads for the Apify Google Maps Scraper actor (x_guru/google-maps-scraper), enabling precise query targeting, location boundaries, and budget guards.
This skill goes beyond basic map searches. It supports advanced features like website contact extraction (emails, phones, and social links), review filtering, and custom coordinate tracking. It provides a standardized execution framework that is ideal for automating CRM population, feeding analytics dashboards, or powering marketing automation workflows with structured real-time data.
Google Maps Scraper (Apify) Use Cases
- Automate local B2B lead generation by extracting business names, websites, emails, and phone numbers via Openclaw Skills.
- Build regional market research reports containing coordinates, ratings, and physical addresses of specific business categories.
- Conduct brand reputation analysis by fetching and filtering historic or newest Google Maps reviews for targeted locations.
- Fuel directory sites, maps integrations, or CRM pipelines with clean, structured JSON datasets directly fetched by an autonomous agent.
How Google Maps Scraper (Apify) Works
- Intent Interpretation: The AI agent detects a request for local business data, Google Map coordinates, or competitor reviews.
- Payload Construction: The agent designs an optimized search payload using structured fields such as searchStringsArray, locationQuery, and custom location filters built with Openclaw Skills integration.
- Budget Safeguarding: The skill applies budget controls (maxTotalChargeUsd) and limits to prevent unexpected API consumption.
- Actor Execution: The skill runs the Apify actor via a Python script execution (scripts/google_maps_scraper_actor.py) using the stored APIFY_TOKEN credential.
- Data Enrichment & Structuring: The agent receives the final JSON dataset, processes contact or review details, and delivers structured rows to the user or downstream workflow.
Google Maps Scraper (Apify) Setup
To get started with this skill from Openclaw Skills, you need to configure your Apify credentials and run the target script.
1. Set Environment Variables
Ensure you have your Apify API Token set in your environment:
export APIFY_TOKEN='your_apify_api_token_here'
2. Install Requirements
Install the required Python dependencies:
pip install -r requirements.txt
3. Run a Quick Search
Verify the installation by running a simple lead-generation search:
APIFY_TOKEN=$APIFY_TOKEN \
python3 scripts/google_maps_scraper_actor.py quick-search \
--query "bike repair shop" \
--location "Portland, Oregon, USA" \
--limit 25 \
--budget-usd 1
Google Maps Scraper (Apify) Data Schema & Taxonomy
The actor output is returned as structured JSON containing high-fidelity business listing fields:
| Data Category | Key Fields |
|---|---|
| Core Identity | title, subTitle, description, price, categoryName, categories, rank |
| Address & Geo | address, neighborhood, street, city, state, postalCode, countryCode, location |
| Contact & Web | website, phone, emails, additionalPhones, facebooks, instagrams, linkedIns, twitters |
| Ratings & Media | totalScore, reviewsCount, reviewsDistribution, imageUrl, imagesCount |
| Details & IDs | openingHours, menu, reserveTableUrl, placeId, fid, cid, url |
All successful runs return an output envelope with ok, actorId, fetchedAt, itemCount, and rows[] keys.
Google Maps Scraper (Apify) Advanced Features
- Website Contact Scraping: Use scrapeCompanyContacts to crawl the target business's public website for emails, social links, and extra phones.
- Review Filtering & Analysis: Retrieve and sort reviews (by newest, mostRelevant, highestRanking, or lowestRanking) and filter by specific keyword strings.
- Location-Bound Controls: Define strict search limits using coordinates, bounding boxes, or precise zip codes instead of loose text queries.
- Budget Management: Safely run tasks with built-in --budget-usd parameters to control Apify consumption on large search batches in Openclaw Skills.
SKILL.md
Loading
Related Openclaw Skills
Google Maps Reviews Scraper (Apify)
An AI agent skill to scrape detailed Google Maps reviews, ratings, owner replies, and reviewer profiles from exact place URLs, CIDs, or Place IDs using Apify.
ENSO Tracker
Track global temperatures, analyze El Niño/La Niña cycles, and generate publication-quality climate charts using the Imperial Modernity color system.
Book Learning Assistant
An AI-powered reading assistant that transforms books and EPUB files into structured study guides complete with kid-friendly analogies and temporal validity checks.
huo15-openclaw-plan-form
An automated Python-based CLI skill to normalize diverse client Excel planning sheets into standardized templates and perform precise cell-by-cell version diffing.
China Technical Analysis
Generate high-precision technical indicators, buy/sell signals, and chart trend descriptions for Chinese commodity and financial futures.
China Options Pricing
An analytical toolkit for calculating European and American option pricing, Greeks, and implied volatility tailored to the Chinese derivatives market.
Featured*
