Сборщик
Скрапер Google Maps
Все места, которые возвращает поиск по Картам, разложенные по строкам без единого окна браузера: название, категория, полный почтовый адрес, телефон, сайт, рейтинг, отзывы и — если попросите — адрес электронной почты с сайта самой компании.
Содержание
Что он собирает
Все места, которые возвращает поиск по Картам, разложенные по строкам без единого окна браузера: название, категория, полный почтовый адрес, телефон, сайт, рейтинг, отзывы и — если попросите — адрес электронной почты с сайта самой компании. Это скрапер, а значит весь договор такой: заполните форму — и вернётся одна таблица. Окно браузера не открывается, слоты автоматизаций вашего тарифа не тратятся, а запросы уходят по обычному HTTP с TLS-отпечатком настоящего браузера.
Он прекрасно работает и с вашего собственного адреса: прокси можно выбрать при запуске, но этому источнику он не нужен. Как бы ни ушёл запрос, каждая строка это фиксирует — см. служебные колонки ниже.
Что вы даёте — 13
Форма, которую рисует приложение, прочитанная из самой карточки. Каждая подсказка ниже — та же, что стоит рядом с этим полем в диалоге запуска, так что здесь нет описания продукта, написанного отдельно от него.
Один ответ, без которого запуск не начнётся
- searchStringsArray
- What to find · list · обязательное
One search term at a time — type it and press Enter. Each term is searched separately and the results are pooled into one table, so "dentists" and "orthodontists" is two searches, not one longer one.
Всё остальное — по желанию
- locationQuery
- Place · text
- city
- City · text
- state
- State or province · text
- postalCode
- Postcode · text
- countryCode
- Country · text
- language
- Language · text
- maxCrawledPlacesPerSearch
- Places per search · number
- categoryFilterWords
- Only these categories · list
- placeMinimumStars
- Minimum rating · select
- website
- Website · select
- skipClosedPlaces
- Skip closed places · boolean
- scrapeContacts
- Find email addresses · boolean
A city, a neighbourhood or a postcode, said the way you would say it. Left blank, Google answers from wherever it thinks this request is — which is the proxy’s country, not yours.
The four fields here are joined into one sentence and handed to Maps exactly as if you had typed it. Fill in as many as you know.
A country name or code, added to the search text.
The language Maps answers in. Results still come from wherever the proxy puts the request.
Google stops a single search near 120 however far you page. Search a neighbourhood rather than a city when the count matters.
A search for "dentists" also returns clinics, hospitals and cosmetic surgeries. Add a word here and a place is kept only when one of the categories Maps gave it contains that word. Costs no extra requests — the reply already carried the categories.
Places with no rating at all fail this — a new listing nobody has reviewed is not a place rated zero, and it is not a place rated four either.
Places with a website are reachable by email; places without one are often the better cold call.
Drops the listings Maps shows as permanently closed — they carry no opening status at all, which is how this can tell.
Opens each place’s own website looking for an address, a named contact and social links. This is the slow half: without it a search takes about six seconds, with it about two minutes per hundred places.
Что вернётся — колонок: 47
Один датасет на запуск — типизированная таблица, которая принадлежит вашему рабочему пространству: её можно сортировать, фильтровать, править прямо в сетке, выгружать целиком или читать через локальный API. Вот колонки, с которыми она создаётся.
Из Google Maps — колонок: 31
| Ключ | Колонка | Тип |
|---|---|---|
| title | Name | text |
| categoryName | Category | text |
| categories | All categories | text |
| phone | Phone | phone |
| phoneUnformatted | Phone (dialable) | text |
| website | Website | url |
| domain | Domain | text |
| address | Address | text |
| street | Street | text |
| city | City | text |
| postalCode | Postcode | text |
| countryCode | Country | text |
| neighborhood | Neighbourhood | text |
| totalScore | Rating | number |
| reviewsCount | Reviews | number |
| claimed | Claimed | select |
| hoursToday | Open today | text |
| hoursStatus | Status | text |
| imageUrl | Photo | url |
| bookingUrl | Booking link | url |
| menu | Menu | url |
| placeUrl | Listing | url |
| placeId | Place ID | text |
| cid | CID | text |
| fid | Feature ID | text |
| kgmid | Knowledge Graph ID | text |
| latitude | Latitude | number |
| longitude | Longitude | number |
| timezone | Timezone | text |
| attributes | Attributes | longText |
| searchTerm | Found via | text |
Из прохода обогащения — колонок: 12
Включите обогащение — и запуск сделает по одному дополнительному запросу на строку: он зайдёт на сайт из колонки website и поищет там адрес, имя контактного лица и ссылки на соцсети. Это и есть шаг, который превращает справочную запись в лид, и именно на него уходит бо́льшая часть времени запуска, когда вы его просите.
| Ключ | Колонка | Тип |
|---|---|---|
| contact_email | Direct email | |
| contact_name | Contact | text |
| contact_role | Role | text |
| emails | All emails | longText |
| contact_source_url | Found on | url |
| url | ||
| url | ||
| url | ||
| X / Twitter | url | |
| youtube | YouTube | url |
| tiktok | TikTok | url |
Пишет каждый скрапер — колонок: 4
Одни и те же четыре на каждой карточке, чтобы таблица и через несколько месяцев могла ответить, откуда взялись её строки: из какого сервиса, когда, с личностью какого профиля уходили запросы и был ли выполнен вход.
| Ключ | Колонка | Тип |
|---|---|---|
| platform | Platform | text |
| collected_at | Collected at | datetime |
| profile | Collected by | profile |
| logged_in | Signed in | select |
Четыре способа запустить
Вкладка «Скраперы». Выберите карточку, заполните форму, нажмите «Старт». Каждый запуск отсюда создаёт новую таблицу, названную по тому, что вы искали, и по времени запуска. Хотите — сначала проверьте: скрапер соберёт одну страницу, ничего не запишет и покажет, какие колонки вернулись заполненными.
Попросите ассистента. У него есть весь каталог, поэтому эта карточка — фраза, а не форма. Он заполнит параметры выше из того, что вы сказали, и покажет их вам до запуска.
Через MCP или локальный API. Та же карточка, но из кодового агента: argus_run_scraper на MCP-сервере или POST http://127.0.0.1:39219/v1/scrapers/run в локальном API. Рядом лежит пример вызова, который ничего не записывает.
{
"kind": "google_maps",
"inputs": {
"searchStringsArray": [
"…"
]
}
}Шагом внутри сценария. Шаг Run scraper ставит этот сборщик в середину автоматизации — собрать, отфильтровать, разослать — и дерево всё так же не открывает при этом ни одного окна. Это ещё и единственный вызывающий, который может отменить правило «таблица на запуск»: если указать ему таблицу по имени, он создаст её с колонками выше, когда её нет, и дальше будет складывать туда каждый запуск — дописывая строки или обновляя их на месте по колонке, которую вы выбрали для сопоставления. Следующему шагу он передаёт имя таблицы, её идентификатор и число строк.
Где он останавливается
Управлять страницей он не станет. Всё, чему нужен настоящий браузер — сайт без списочной точки под капотом или любая работа с вашим собственным аккаунтом, — это автоматизация, и это другой инструмент, а не худшая версия этого.
Он никуда не входит. Чтение публичной страницы без входа — устоявшаяся позиция: Bright Data собирала данные Meta без входа и выиграла, hiQ собирала LinkedIn со входом и проиграла. Поэтому эта карточка не просит аккаунта и не держит его.
Остальные карточки Google
Карточка на задачу, а не на сервис: профили, посты и люди вокруг них — три коллекции с тремя схемами.