02-apify-maps-discover

Solid

Find local-business (SMB) prospects via Google Maps using the Apify Compass actor. Use for step-02 vertical discovery when the ICP is Maps-addressable - laundromats, salons, HVAC, yoga studios, gyms, clinics - and you need a normalized list of name, domain, address, phone, rating, and review count ready for enrichment. Estimates cost and prompts before any run over $10. Requires APIFY_API_TOKEN.

API & Backend 18 stars 4 forks Updated today MIT

Install

View on GitHub

Quality Score: 81/100

Stars 20%
43
Recency 20%
100
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
80
License 10%
100
Description 5%
100

Skill Content

# Apify Maps Discovery Turn a vertical + a place into a clean prospect list, scraped from Google Maps via the maintained **Apify Compass** actor (`compass~crawler-google-places`). We wrap the best existing actor rather than build our own scraper - Compass already handles proxies, anti-bot, and layout drift, and offers built-in email/contact enrichment. Output is the normalized Zevenue ProspectRecord schema (JSON + CSV). ## Process 1. **Confirm inputs.** Need `search_term` (the vertical) and `geo` (the area). Defaults: `max_results=200`, `min_rating=4.0`. Ask only if missing/ambiguous. 2. **Estimate cost and gate.** The skill prints an estimate before calling the API. If it exceeds **$10**, it requires explicit confirmation (`--yes` or an interactive y/N). Never bypass this silently. 3. **Run the actor.** Calls the Compass sync endpoint with the built input (`searchStringsArray`, `locationQuery`, `maxCrawledPlacesPerSearch`, `placeMinimumStars`). Add enrichment only when asked (see flags). 4. **Normalize.** Each raw place is mapped to the shared 15-field ProspectRecord so it's comparable with the Outscraper / Google Places skills. 5. **Write the run folder.** Writes `runs/<run-id>/` per `_shared/CONVENTIONS.md`: `records.jsonl` (the shared chain format 03+ consume - `company`, `domain`, `person`, plus the firmographic fields), `tracker.json`, `meta.json` (count + spend estimate), `prospects.json` (all 15 ProspectRecord fields), and `records.csv`...

Details

Author
Zevenue
Repository
Zevenue/headless-gtm
Created
3 months ago
Last Updated
today
Language
Python
License
MIT

Similar Skills

Semantically similar based on skill content — not just same category

AI & Automation Solid

01-prospeo-discover

B2B company discovery and list building via the Prospeo search API. Use when the user wants to find companies from an ICP, build a prospect or TAM list, search by ICP, or size a market - e.g. "build a list of B2B SaaS in the US", "how many companies match this ICP", "TAM sizing", "company search", or any mix of industry + location + headcount + funding filters. Handles seed-based "similar to X" requests too by building an ICP from the seeds; 01-prospeo-lookalike is the deeper specialist when you want the matches themselves returned and ranked.

18 Updated today
Zevenue
API & Backend Listed

apify-google-maps-directions-api

Get Google Maps directions as structured JSON with the Apify Google Maps Directions API Actor (johnvc/google-maps-directions-api). Give a start and end point as an address, GPS coordinates, or a Google Maps place ID, pick a travel mode (best, driving, cycling, walking, transit, flight, two-wheeler), and get route options back with formatted_distance, formatted_duration, a via summary, turn-by-turn steps, a per-mode durations summary, resolved place coordinates, and a google_maps_directions_url. Use when the user wants a google maps directions api, route data as JSON, distance and ETA between two addresses, turn-by-turn directions inside a script or agent, or directions without a Google Cloud API key. Pay-per-route billing, MCP-ready for Claude and other AI agents.

0 Updated 1 weeks ago
johnisanerd
AI & Automation Listed

apify-scrape-google-jobs

Scrape Google Jobs listings into structured JSON with the Apify Google Jobs Scraper Actor (johnvc/Google-Jobs-Scraper). Give a job title or search query plus an optional location, and get one row per listing with title, company_name, location, source platform, full description, job_highlights, posted_at, schedule_type, and direct apply_options links. Use when the user wants to scrape google jobs, export Google Jobs results to JSON or CSV, build a job listings dataset, pull openings for a role or city, or asks for a Google Jobs scraper, job scraper, or job scraping workflow. Pay-per-page billing, MCP-ready for Claude and other AI agents.

0 Updated 1 weeks ago
johnisanerd