google-ad-scraper

Google Ads Scraper

Apify の burbn/google-ads-search アクターを使用して、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. 広告のスクレイピング：Apify の burbn/google-ads-search アクターを {"domain": "...", "maxResults": N} で呼び出します
4. 出力：広告を JSON または人が読みやすい要約形式で返します

入力仕様： maxResults はアクターで定義されている上限フィールドです（公式スキーマ）。この代替手段は暫定的な調査用であり、保存済みの GooseWorks 広告ライブラリソースは作成しません。保存が必要な場合は、competitor-ad-intelligence にある、確認済みの永続的な Google ワークフローを優先してください。

CLI リファレンス

フラグ	デフォルト	説明
--domain	なし	企業のドメイン（例：hubspot.com）— 推奨
--company	なし	企業名（Transparency Center 経由でドメインに解決）
--max-ads	50	返す広告の最大数
--output	json	出力形式：json または summary
--token	環境変数	Apify トークン（APIFY_API_TOKEN 環境変数の使用を推奨）
--timeout	300	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"
}

出力フィールド：

フィールド	説明
advertiserId	Google Ads の広告主 ID
advertiserName	企業／広告主の表示名
creativeId	広告クリエイティブの一意の ID
originalUrl	広告のリンク先 URL
imageUrl	広告画像の URL（該当する場合）
variantFormat	広告フォーマット（TEXT、IMAGE、VIDEO など）
variantContent	広告コピー／テキストの内容
variants	広告バリエーションの配列
variantCount	このクリエイティブのバリエーション数
startDate	広告が初めて表示された日付

費用

• 広告のスクレイピング：アクターの料金によって異なります。通常、ドメインあたり数セントです
• 企業名の解決（任意）：約 $0.05（ウェブスクレーパーのページ 1 件分）

よくあるワークフロー

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

制限事項

• 企業名の解決では、Google の SPA を Puppeteer ベースでウェブスクレイピングします。まれに失敗する場合があるため、最良の結果を得るには --domain を使用してください。
• 広告の網羅性：Google に表示されるのは、認証済みの広告主の広告のみです。規模の小さい広告主は表示されないことがあります。
• 過去のデータ：主に最近配信された広告が表示されます。