用途：抓取 Google Ads Transparency Center 中的竞品广告，覆盖 Search、YouTube、Display 和 Gmail 广告类型，用于竞品广告研究、多竞品对比和地区投放分析。
主要能力：支持按公司名、域名或广告主 ID 查询；未提供广告主 ID 时自动解析（域名方式最可靠）；可按地区（如 US、GB、DE 或 anywhere）过滤；可限制返回广告数量；输出 JSON 或人类可读摘要。输出字段可能包含广告主名称与 ID、广告格式、标题、描述、展示 URL、目标 URL、地区、首次与最近展示时间、图片和视频链接，具体随广告格式而异。
使用方式：需设置 APIFY_API_TOKEN 环境变量（或使用 --token），并安装依赖 pip install requests。基本命令为 python3 skills/google-ad-scraper/scripts/search_google_ads.py，配合 --company、--domain 或 --advertiser-id 之一使用；其他参数包括 --region、--max-ads（默认 50）、--output（json 或 summary）、--timeout（默认 300 秒）。
限制：广告主 ID 解析基于 Puppeteer 抓取 Google 单页应用，可能偶尔失败，建议用 --domain 或直接提供 --advertiser-id；Google 仅展示已验证广告主的广告，部分小广告主可能不出现；Transparency Center 主要显示近期活跃广告。费用方面，广告主查询约 0.05 美元，广告抓取费用随 actor 定价变化，通常每个广告主几美分。详细 API 配置、令牌设置和速率限制见 references/apify-config.md。