Do I need a Google Maps API key?
No. leadmaps drives a real Google Chrome browser exactly the way a person would, so there's no API to sign up for, no key to paste, no quota, and no per-request billing. The only thing you need installed is Chrome.
Is this legal?
leadmaps reads the same public business listings any visitor can see — it doesn't bypass logins, solve CAPTCHAs, or touch private data. That said, you're responsible for how you use the output: follow the terms of the services you use, and your local rules on marketing and data protection (GDPR, CAN-SPAM, DPDP and similar) when you contact anyone.
How is this different from Apollo?
Apollo is built for corporate contacts and is thin on neighbourhood businesses. leadmaps targets exactly those local SMBs and returns what Apollo doesn't have for them: phone, Maps URL, geo-coordinates, Place ID, rating and reviews, opening hours, photos, and a lead score. Above all it can filter for businesses with no website — the single best prospect list if you sell websites or marketing.
What does the $99 licence cover?
Everything: both editions (Python and the standalone binary), all five destinations, all 41 fields, and the AI skill file — plus the MCP connector when it launches. It's a one-time payment for use on your own machines, with no subscription and no per-lead cost.
Can an AI assistant run it for me?
Yes, if the assistant can run commands on your own machine — Claude Code and Cursor both can. A skill file ships in the package that teaches the assistant the exact commands and the JSON event stream, and explicitly forbids it from inventing leads if it can't run the tool. A hosted MCP connector for browser-based assistants like claude.ai and ChatGPT is in development and opens in beta soon.
Which operating systems work?
Windows, macOS (Intel and Apple Silicon) and Linux. Two editions with identical commands: a Python package via pipx, or a single self-contained binary that needs no Python at all — just Chrome.
Where do my leads and tokens live?
Leads go directly into your own Notion workspace, your own Google Sheet, or local files. Connection tokens are cached only on your computer at ~/.leadmaps/credentials.json. We never hold your leads — there's no database of ours for them to sit in.
Will re-running create duplicates?
No. Before writing, leadmaps reads what's already in your destination and skips anything it recognises — matching on Google Place ID first, then phone, then name and address. Re-run the same search whenever you like to top up the list.
How long does a run take?
Roughly 5–8 seconds per kept lead, so 30 leads takes about 3–5 minutes and a full 256-lead job takes 30–40 minutes. leadmaps paces itself deliberately to behave like a person browsing rather than hammering the site.
Can I use it outside India?
Yes — any city worldwide works. Pass your country calling code with --cc (for example --cc 971 for the UAE). One honest caveat: the address parser is currently tuned for Indian formats, so the separate state and area columns are less accurate elsewhere. The full street address, coordinates and everything else are still captured correctly.