用途
该技能用于通过 Google 搜索发现数字营销机构、创意工作室和网页设计公司。它基于 apidojo 的 Google Search Scraper(运行在 Apify 平台上),把搜索关键词或 Google 搜索 URL 转换为结构化的搜索结果,便于后续筛选和整理潜在客户名单。
主要能力
- 支持通过
searchTerms传入关键词,或通过startUrls传入 Google 搜索 URL。 - 可指定搜索国家(
countryCode,如 US、GB、TR)和语言(languageCode,如 en)。 - 可限制返回结果总数(
maxItems)和每个查询的最大结果页数(maxPagesPerQuery)。 - 可选择抓取移动端 SERP 布局(
mobileResults)。 - 支持通过
customMapFunction传入 JavaScript 函数,对每个输出对象进行转换。 - 提供评分与分级方法,用于判断搜索结果是否为机构类潜在客户。
使用方式
推荐使用 run_actor.js 脚本运行。示例:
# Quick answer (table)
node scripts/run_actor.js --actor "apidojo~google-search-scraper" --input '{"searchTerms": ["digital marketing agency NYC"], "countryCode": "US", "maxPagesPerQuery": 3}'
# Save as CSV
node scripts/run_actor.js --actor "apidojo~google-search-scraper" --input '{"searchTerms": ["digital marketing agency NYC"], "countryCode": "US", "maxPagesPerQuery": 3}' --output results.csv --format csv
# Save as JSON
node scripts/run_actor.js --actor "apidojo~google-search-scraper" --input '{"searchTerms": ["digital marketing agency NYC"], "countryCode": "US", "maxPagesPerQuery": 3}' --output results.json --format json
也可使用 REST API 作为备选方式:
curl -X POST "https://api.apify.com/v2/acts/apidojo~google-search-scraper/runs" \
-H "Authorization: Bearer $APIFY_TOKEN" \
-H "Content-Type: application/json" \
-d '{"searchTerms": ["digital marketing agency NYC"], "countryCode": "US", "maxPagesPerQuery": 3}'
如果可用 Apify MCP,可使用 Apify MCP 的 call_actor 工具,actor 为 apidojo~google-search-scraper,输入同上。
输入参数
startUrls(数组,可选,默认[]):Google 搜索 URL。searchTerms(数组,可选,默认[]):在 Google 上搜索的关键词。countryCode(字符串,可选,默认 US):Google 搜索的国家,例如 US、GB、TR。languageCode(字符串,可选,默认未提供):结果语言,例如 en。maxItems(数字,可选,默认不限):所有查询合计返回的最大结果数。maxPagesPerQuery(整数,可选,默认 1):每个查询的最大结果页数。mobileResults(布尔,可选,默认 false):是否抓取移动端 SERP 布局。customMapFunction(字符串,可选,默认未提供):用于转换每个输出对象的 JavaScript 函数。
评分与分级
对每个结果按以下方式评分:
snippet_has_agency_signals(摘要包含 agency、studio、services、clients、marketing、SEO 等信号)→ 权重 0.50is_agency_domain(不是 .gov、.edu、.wikipedia、.youtube)→ 权重 0.30position→ 得分 = 1 - (position / total_results),权重 0.20
计算公式:
score = 0.50 * int(agency_signals) + 0.30 * int(valid_domain) + 0.20 * (1 - position/total)
分级:
- 得分 ≥ 0.70:A 级,PRIME_PROSPECT
- 得分 0.40–0.69:B 级,WARM_LEAD
- 得分 < 0.40:C 级,LOW_PRIORITY
适用场景
- 按城市或地区搜索本地数字营销机构、创意工作室、网页设计公司。
- 将 Google 搜索结果整理为潜在客户名单,用于人工外联。
- 通过评分与分级快速区分高优先级线索和低优先级线索。
限制与边界情况
- 目录类网站(如 Clutch、Yelp、Upwork 列表)不是机构本身,可通过检查域名是否与摘要匹配来过滤。
- 维基百科或新闻类结果(如 wikipedia.org、bbc.com)应跳过。
- SERP 只返回标题、URL 和摘要,不包含电话或邮箱,因此结果只能作为人工外联的起始名单。
- 同一机构可能因多个搜索词重复出现,应按域名去重。
- 如需本地结果,应使用包含城市的关键词。