用途:抓取 Google 广告透明度中心里的竞品广告,覆盖搜索、YouTube、展示和 Gmail 广告类型。可按公司名、域名或广告主 ID 检索,输出 JSON 或可读摘要。
必要用法:需要 APIFY_API_TOKEN 环境变量(或 --token),依赖 requests(pip install requests)。基本命令:python3 skills/google-ad-scraper/scripts/search_google_ads.py --company "Nike";按域名更精确:--domain "nike.com";已有广告主 ID 可用 --advertiser-id "AR13129532367502835713" 跳过查询。其他参数:--region(如 US)、--max-ads(默认 50)、--output(json 或 summary)、--timeout(默认 300)。--company、--domain、--advertiser-id 至少提供一个。
主要能力:未给 ID 时会先用 Apify 网页抓取(Puppeteer)自动解析广告主 ID(格式 AR+20 位数字),再调用 actor 抓取广告并轮询取回数据集。输出字段可能包含广告主名称、ID、广告格式、标题、描述、展示 URL、目标 URL、地区、首次/最近展示时间、图片和视频链接,随广告格式而异。
限制:ID 解析依赖对 Google 单页应用的抓取,可能偶尔失败,建议用 --domain 或直接提供 --advertiser-id。Google 仅展示已验证广告主的广告,部分小型广告主可能不出现;透明度中心主要展示近期活跃广告。成本方面,广告主查询约 $0.05,抓取费用视 actor 定价而定,通常每个广告主几美分。配置细节见 references/apify-config.md。