mcpField
G
google-ad-scraper

google-ad-scraper

github.com/gooseworks-ai营销与增长1.3k51 次安装3 天前更新
代码仓库

关于 google-ad-scraper

这款命令行 Skill 可按公司域名或名称获取 Google Ads，供营销团队查看广告创意、格式、目标网址及其他活动信息，并以 JSON 或易读摘要输出。

主要功能

  1. 01按公司域名搜索广告
  2. 02将公司名称解析为广告主信息
  3. 03获取创意、格式和活动字段
  4. 04输出 JSON 或易读摘要

适用场景

  1. 01查看竞争对手的 Google 广告
  2. 02比较多个公司域名的广告

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/gooseworks-ai/goose-skills --skill google-ad-scraper

安装后在 Claude Code 中输入/google-ad-scraper确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

skill.meta.json
scripts/
search_google_ads.py
tests/
actor-input-contract.json
test_search_contract.py

详细介绍

Google Ads Scraper

使用 Apify burbn/google-ads-search actor 抓取 Google Ads 广告。按域名搜索，获取广告创意、格式和广告系列详情。

快速开始

需要设置 APIFY_API_TOKEN 环境变量（或使用 --token 标志）。

# Search by domain (recommended)
python3 skills/google-ad-scraper/scripts/search_google_ads.py \
  --domain "hubspot.com"

# Search by company name (resolves to domain via transparency center)
python3 skills/google-ad-scraper/scripts/search_google_ads.py \
  --company "Nike"

# Limit results
python3 skills/google-ad-scraper/scripts/search_google_ads.py \
  --domain "hubspot.com" --max-ads 30

# Human-readable summary
python3 skills/google-ad-scraper/scripts/search_google_ads.py \
  --domain "stripe.com" --output summary

工作原理

  1. 域名输入：通过 --domain 直接传入目标公司的域名
  2. 公司名称解析（可选）：如果只提供 --company，脚本会使用 Apify 的网页抓取工具（Puppeteer）搜索 Google Ads Transparency Center，将公司名称解析为广告主信息
  3. 广告抓取：使用 {"domain": "...", "maxResults": N} 调用 Apify burbn/google-ads-search actor
  4. 输出：以 JSON 或易读摘要的形式返回广告

输入约定： maxResults 是 actor 文档中指定的限制字段（官方 schema）。此备用方案仍属于临时研究，不会创建已保存的 GooseWorks 广告库来源。需要保存时，优先使用 competitor-ad-intelligence 中已确认的持久化 Google 工作流。

CLI 参考

标志默认值说明
--domain无公司域名（例如 hubspot.com）——推荐
--company无公司名称（通过 Transparency Center 解析为域名）
--max-ads50返回的广告数量上限
--outputjson输出格式：json 或 summary
--token环境变量Apify token（优先使用 APIFY_API_TOKEN 环境变量）
--timeout300等待 Apify 运行的最长时间（秒）

--company 和 --domain 至少需要提供一个。

输出字段

输出中的每条广告都包含：

{
  "advertiserId": "AR13129532367502835713",
  "advertiserName": "Nike, Inc.",
  "creativeId": "CR12345678901234567890",
  "originalUrl": "https://www.nike.com/",
  "imageUrl": "https://...",
  "variantFormat": "TEXT",
  "variantContent": "Shop the latest Nike shoes...",
  "variants": [...],
  "variantCount": 3,
  "startDate": "2026-01-15"
}

输出字段：

字段说明
advertiserIdGoogle Ads 广告主 ID
advertiserName公司/广告主显示名称
creativeId广告创意的唯一 ID
originalUrl广告链接指向的目标 URL
imageUrl广告图片的 URL（如适用）
variantFormat广告格式（TEXT、IMAGE、VIDEO 等）
variantContent广告文案/文本内容
variants广告变体数组
variantCount此创意的变体数量
startDate广告首次展示的日期

费用

  • 广告抓取：费用因 actor 定价而异，通常每个域名只需几美分
  • 公司名称解析（可选）：约 $0.05（抓取一个网页）

常见工作流

1. 竞品广告调研
python3 skills/google-ad-scraper/scripts/search_google_ads.py \
  --domain "competitor.com" --max-ads 100 --output summary
2. 对比多个竞品
# Run for each competitor domain
for domain in "competitor1.com" "competitor2.com" "competitor3.com"; do
  python3 skills/google-ad-scraper/scripts/search_google_ads.py \
    --domain "$domain" --max-ads 50
done

限制

  • 公司名称解析使用基于 Puppeteer 的网页抓取来处理 Google 的 SPA，偶尔可能失败——为获得最佳效果，请使用 --domain。
  • 广告覆盖范围：Google 仅展示已验证广告主的广告。一些规模较小的广告主可能不会出现。
  • 历史数据：主要展示近期活跃的广告。

评论

支持 Markdown