meta-ad-scraper

Meta 広告ライブラリ スクレーパー

Apify の apify/facebook-ads-scraper アクターを使って、Meta の広告ライブラリから広告をスクレイピングします。Facebook、Instagram、Messenger、Threads、WhatsApp に対応しています。

クイックスタート

APIFY_API_TOKEN 環境変数（または --token フラグ）が必要です。依存関係をインストールします：pip install requests。

# Search ads by company name
python3 skills/meta-ad-scraper/scripts/search_meta_ads.py \
  --company "Nike"

# Search with country filter
python3 skills/meta-ad-scraper/scripts/search_meta_ads.py \
  --company "Shopify" --country US

# Search by keyword (broader than company name)
python3 skills/meta-ad-scraper/scripts/search_meta_ads.py \
  --company "project management software"

# Limit results
python3 skills/meta-ad-scraper/scripts/search_meta_ads.py \
  --company "HubSpot" --max-ads 20

# Search by Facebook Page URL directly
python3 skills/meta-ad-scraper/scripts/search_meta_ads.py \
  --page-url "https://www.facebook.com/nike"

# Only active ads (default), or all ads
python3 skills/meta-ad-scraper/scripts/search_meta_ads.py \
  --company "Salesforce" --ad-status all

# Human-readable summary
python3 skills/meta-ad-scraper/scripts/search_meta_ads.py \
  --company "Stripe" --output summary

仕組み

1. 企業名、キーワード、または Facebook ページの URL を指定します
2. 検索クエリとフィルターを含む Meta 広告ライブラリの URL を作成します
3. REST API 経由で Apify の apify/facebook-ads-scraper アクターを呼び出します
4. 実行が完了するまでポーリングし、その後データセットを取得します
5. 広告データを解析し、JSON または人が読みやすい要約として出力します

企業名から広告を検索

このスクリプトは広告主の検索を自動で処理します：

• 企業名：facebook.com/ads/library/?q=CompanyName のような検索 URL を作成します。Apify アクターが Meta の広告ライブラリを検索し、一致する広告主を探します
• ページ URL：Facebook ページの URL がある場合は、--page-url で指定すると正確に一致させられます
• ドメイン：ドメインを指定して検索することもできます

ページ ID を手動で探す必要はありません。Apify アクターが内部で検索を処理します。

CLI リファレンス

フラグ	デフォルト	説明
--company	必須*	検索する企業名またはキーワード
--page-url	なし	広告主を正確に一致させるための Facebook ページ URL
--country	ALL	2 文字の国コード（US、GB、DE など）、または ALL
--ad-status	active	active または all（非アクティブな広告を含む）
--max-ads	50	返す広告の最大数
--output	json	出力形式：json または summary
--token	env var	Apify トークン（APIFY_API_TOKEN 環境変数の使用を推奨）
--timeout	300	Apify の実行を待つ最大秒数

*--company または --page-url のいずれかが必要です。

出力フィールド

出力に含まれる各広告の情報：

{
  "ad_id": "123456789",
  "page_name": "Nike",
  "page_id": "123456789",
  "ad_text": "Just Do It. Shop the latest...",
  "ad_creative_link_title": "Nike.com",
  "ad_creative_link_description": "Free shipping on orders...",
  "ad_creative_link_url": "https://nike.com/...",
  "image_url": "https://...",
  "video_url": "https://...",
  "ad_delivery_start_time": "2026-01-15",
  "ad_delivery_stop_time": null,
  "currency": "USD",
  "spend_lower": 100,
  "spend_upper": 499,
  "impressions_lower": 1000,
  "impressions_upper": 4999,
  "platforms": ["facebook", "instagram"],
  "status": "ACTIVE"
}

コスト

Apify の無料プランでは、広告 1,000 件のスクレイピングあたり約 $5 です。有料プランではさらに安くなります（1,000 件あたり $3.40～$5）。

よくあるワークフロー

1. 競合広告の調査

python3 skills/meta-ad-scraper/scripts/search_meta_ads.py \
  --company "Competitor Name" --country US --max-ads 100 --output summary

2. 業界の広告動向

# Search by keyword to see all advertisers in a space
python3 skills/meta-ad-scraper/scripts/search_meta_ads.py \
  --company "CRM software" --max-ads 50

3. 複数の競合を比較

競合ごとにスクリプトを実行し、クリエイティブのアプローチ、メッセージ、支出額の範囲を比較します。

重要な注意事項

• EU／UK の広告が最も網羅的です：Meta は EU／UK で表示されたすべての広告をアーカイブしています。米国のみの広告は、政治広告や社会問題に関する広告に限られる場合があります。
• アクティブとすべて：デフォルトではアクティブな広告のみが返されます。過去の広告を含めるには --ad-status all を使います。
• レート制限：Apify が内部でレート制限を処理します。大量にスクレイピングする場合は、--timeout を長くしてください。

設定

API の詳細設定、トークンの設定、レート制限については、references/apify-config.md を参照してください。