Сборщик

Скрапер 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

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.

city
City · text

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.

state
State or province · text
postalCode
Postcode · text
countryCode
Country · text

A country name or code, added to the search text.

language
Language · text

The language Maps answers in. Results still come from wherever the proxy puts the request.

maxCrawledPlacesPerSearch
Places per search · number

Google stops a single search near 120 however far you page. Search a neighbourhood rather than a city when the count matters.

categoryFilterWords
Only these categories · list

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.

placeMinimumStars
Minimum rating · select

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.

website
Website · select

Places with a website are reachable by email; places without one are often the better cold call.

skipClosedPlaces
Skip closed places · boolean

Drops the listings Maps shows as permanently closed — they carry no opening status at all, which is how this can tell.

scrapeContacts
Find email addresses · boolean

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

КлючКолонкаТип
titleNametext
categoryNameCategorytext
categoriesAll categoriestext
phonePhonephone
phoneUnformattedPhone (dialable)text
websiteWebsiteurl
domainDomaintext
addressAddresstext
streetStreettext
cityCitytext
postalCodePostcodetext
countryCodeCountrytext
neighborhoodNeighbourhoodtext
totalScoreRatingnumber
reviewsCountReviewsnumber
claimedClaimedselect
hoursTodayOpen todaytext
hoursStatusStatustext
imageUrlPhotourl
bookingUrlBooking linkurl
menuMenuurl
placeUrlListingurl
placeIdPlace IDtext
cidCIDtext
fidFeature IDtext
kgmidKnowledge Graph IDtext
latitudeLatitudenumber
longitudeLongitudenumber
timezoneTimezonetext
attributesAttributeslongText
searchTermFound viatext

Из прохода обогащения — колонок: 12

Включите обогащение — и запуск сделает по одному дополнительному запросу на строку: он зайдёт на сайт из колонки website и поищет там адрес, имя контактного лица и ссылки на соцсети. Это и есть шаг, который превращает справочную запись в лид, и именно на него уходит бо́льшая часть времени запуска, когда вы его просите.

КлючКолонкаТип
emailEmailemail
contact_emailDirect emailemail
contact_nameContacttext
contact_roleRoletext
emailsAll emailslongText
contact_source_urlFound onurl
linkedinLinkedInurl
facebookFacebookurl
instagramInstagramurl
twitterX / Twitterurl
youtubeYouTubeurl
tiktokTikTokurl

Пишет каждый скрапер — колонок: 4

Одни и те же четыре на каждой карточке, чтобы таблица и через несколько месяцев могла ответить, откуда взялись её строки: из какого сервиса, когда, с личностью какого профиля уходили запросы и был ли выполнен вход.

КлючКолонкаТип
platformPlatformtext
collected_atCollected atdatetime
profileCollected byprofile
logged_inSigned inselect

Четыре способа запустить

Вкладка «Скраперы». Выберите карточку, заполните форму, нажмите «Старт». Каждый запуск отсюда создаёт новую таблицу, названную по тому, что вы искали, и по времени запуска. Хотите — сначала проверьте: скрапер соберёт одну страницу, ничего не запишет и покажет, какие колонки вернулись заполненными.

Попросите ассистента. У него есть весь каталог, поэтому эта карточка — фраза, а не форма. Он заполнит параметры выше из того, что вы сказали, и покажет их вам до запуска.

Через MCP или локальный API. Та же карточка, но из кодового агента: argus_run_scraper на MCP-сервере или POST http://127.0.0.1:39219/v1/scrapers/run в локальном API. Рядом лежит пример вызова, который ничего не записывает.

argus_run_scraper — Google Maps
{
  "kind": "google_maps",
  "inputs": {
    "searchStringsArray": [
      "…"
    ]
  }
}

Шагом внутри сценария. Шаг Run scraper ставит этот сборщик в середину автоматизации — собрать, отфильтровать, разослать — и дерево всё так же не открывает при этом ни одного окна. Это ещё и единственный вызывающий, который может отменить правило «таблица на запуск»: если указать ему таблицу по имени, он создаст её с колонками выше, когда её нет, и дальше будет складывать туда каждый запуск — дописывая строки или обновляя их на месте по колонке, которую вы выбрали для сопоставления. Следующему шагу он передаёт имя таблицы, её идентификатор и число строк.

Где он останавливается

Управлять страницей он не станет. Всё, чему нужен настоящий браузер — сайт без списочной точки под капотом или любая работа с вашим собственным аккаунтом, — это автоматизация, и это другой инструмент, а не худшая версия этого.

Он никуда не входит. Чтение публичной страницы без входа — устоявшаяся позиция: Bright Data собирала данные Meta без входа и выиграла, hiQ собирала LinkedIn со входом и проиграла. Поэтому эта карточка не просит аккаунта и не держит его.

Остальные карточки Google

Карточка на задачу, а не на сервис: профили, посты и люди вокруг них — три коллекции с тремя схемами.