Maps scraper

The Maps scraper is the workhorse of the local-business workflows. The Specter persona's gmaps-leads skill fires it the moment a user asks for businesses in a given category and location; downstream skills enrich and contact the resulting leads. It is the only scraper in the worker set that defaults to residential proxy because Google Maps treats datacentre IPs aggressively.

The crawler is deliberately patient. Each feed scroll waits for the result counter to stabilise before reading the cards, otherwise the actor races Maps' lazy load and undercounts results. Each detail panel click waits for the phone or website field to appear before reading, otherwise the row goes out half-populated.

The crawler ships with a small jitter helper (jitterMs) that adds a random delay between requests inside the same crawl, sized to avoid burst-detection patterns on the maps domain. The proxy pool rotates per request; sticky sessions are not used because the maps frontend re-authenticates the visitor on every navigation anyway.

Google rewrites maps' DOM regularly. Each extractor reads from a list of selector candidates per field, picks the first that returns a non-empty value, and logs the picked variant so a future class-name change is visible in run logs before users start seeing missing fields. The actor is clean-room: it uses only public DOM patterns (aria-labels, role attributes), no proprietary reverse-engineered selectors.