采集卡片

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。 同一张卡片,从编程 Agent 里调用——MCP 服务器上的 argus_run_scraper,或者本地 APIPOST http://127.0.0.1:39219/v1/scrapers/run。旁边有一个什么都不写入的示例调用。

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

作为工作流里的一个步骤。 Run scraper 步骤把这个采集器放进一条自动化流程的中间——先采、再筛、再发信——整棵流程照样一个窗口都不开。它也是唯一能推翻「一次运行一张表」规则的调用方:指定一张你命名的表,它会在表不存在时按上面的列建好,之后每次运行都写进这张表,追加或者按你指定的匹配列就地更新。这个步骤会把表名、表 id 和行数交给下一步。

它到哪里为止

它不会去驱动页面。凡是需要真实浏览器的事——背后没有列表接口的网站,或者任何操作你自己账号的事——都该交给自动化流程。那是另一件工具,而不是这件工具的劣化版。

它不登录任何地方。未登录读取公开页面是已成定论的做法——Bright Data 未登录采集 Meta 并且胜诉,hiQ 登录后采集 LinkedIn 则败诉——所以这张卡片不要账号,也不持有账号。

Google 的其余卡片

一张卡片对应一件事,而不是对应一个服务——主页、帖子和它们周围的人,是三种集合、三套字段。