mcpField
M
meta-ads-scraper

meta-ads-scraper

github.com/cold-iqマーケティング・グロース348 回インストール2 週間前に更新
リポジトリ

meta-ads-scraper について

ColdIQ の非同期エンドポイントで Meta Ad Library を検索するエージェントスキルです。段階別の検索語を使い、DTC や E コマース向けに動画広告を出稿中のブランドを探します。

主な機能

  1. 01Meta 広告の検索ジョブを送信
  2. 02非同期ジョブを確認して結果を取得
  3. 034段階の検索語でブランドを検索
  4. 04発見したブランドの集約と重複排除
  5. 05後続のリード補完とスコアリングを案内

活用シーン

  1. 01DTC クライアント向けの広告主探し
  2. 02業種や地域別の広告主検索
  3. 03ブランドの選別と見込み客情報の補完

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/cold-iq/coldiq-marketplace-skills --skill meta-ads-scraper

インストール後、Claude Code で/meta-ads-scraperを入力して読み込まれたか確認します。

同梱ファイルresources/async-job-pattern.md

詳細

Meta広告ライブラリ検索

Metaで動画広告を積極的に配信しているブランドを見つけます。これはマーケティング予算とデジタル成熟度の強い指標であり、DTC/Eコマースクライアントの新規アカウントにつなげます。

ローカルのPlaywright/SQLite Metaスクレーパーを、ColdIQの非同期Meta Adsエンドポイントに置き換えます。ローカルブラウザーも、メンテナンスが必要なデータベースも不要です。価値ある部分である135語の検索戦略は、送信するクエリーセットとして以下に維持されています。

ColdIQ Marketplaceエンドポイント

タスクメソッドパスクレジットエンドポイントID備考
Meta Ads検索を開始POST/v1/meta-ads/search一律meta_ads.search.create非同期。jobIdを返します
検索結果を取得GET/v1/meta-ads/search/{jobId}無料meta_ads.search.result実行中は202、完了時は200

実行方法

検索語ごとにジョブを送信し、結果をポーリングします(resources/async-job-pattern.mdを参照)。

  1. キーワード/検索語(またはURL)を1つ送信します。 → POST /v1/meta-ads/search · 一律 · meta_ads.search.create
    { "query": "shop now free shipping", "country": "US" }
    
  2. 完了するまでポーリングしてから、広告を読み取ります。 → GET /v1/meta-ads/search/{jobId} · 無料 · meta_ads.search.result

以下の検索語セットを順に処理し(検索語ごとに1ジョブ)、ブランドを集約してから重複を除去します。

検索戦略 — 4フェーズで135語

重要な知見:**汎用的なDTC広告の表現は、ニッチな商品キーワードよりも効果的です。**ジュエリー、ベビー用品、サプリメントのブランドはいずれも「今すぐ購入、送料無料」という広告を配信します。動画広告が10件以上あるブランドは、本格的な広告運用(予算+クリエイティブチーム+パフォーマンスマーケティングのリーダーシップ)を行っています。

  • フェーズ1 — 汎用DTC動画広告フック(米国、35語):「今すぐ購入 送料無料」、「コードを使って割引」、「定期購入でお得」、「期間限定オファー」、「使用前と使用後の結果」、「実際のお客様の本当の結果」、「リスクなしでお試し」、「シャークタンクで紹介」、「ベストセラー」、「臨床的に証明された結果」、「何が起きるか見てください」、「これを試してみた」、「正直なレビュー」、「画期的な商品」、「なぜ皆が乗り換えているのか」、「無料サンプルをお申し込みください」、「本日限りの特別オファー」、「20%割引」、「初回注文無料」、「セット購入でお得」、「すぐに売り切れ」…
  • **フェーズ2 — 手薄な業種(米国、47語):**ベビー・育児(ベビー用品の必需品、必須のベビールーム用品、幼児向けスナック、おむつの定期購入、産後用品、マタニティウェア、オーガニック離乳食、子ども向けビタミングミ…);ジュエリー・アクセサリー(ファインジュエリー、婚約指輪、パーソナライズジュエリー、繊細なジュエリー、誕生石、メンズジュエリー…);ワイン・スピリッツ(ワインの宅配、クラフトスピリッツ、テキーラ、ワインクラブ、ナチュラルワイン、メスカル、ハードセルツァー、ノンアルコールスピリッツ…);乳製品・代替乳製品(オーツミルク、植物性ミルク、ギリシャヨーグルト、チーズの定期購入、牧草飼育牛のバター、プロバイオティクス入りケフィア…)。
  • **フェーズ3 — ブランド周辺のシグナル(米国、33語):**定期購入ボックス、厳選サブスクリプション、自動配送、会員限定;新ブランドをローンチしたばかり、DTCブランドのローンチ、創業者ストーリー、小ロットの職人製品;返品無料、1つ買うともう1つ無料、フラッシュセール、新着商品、今話題;バレンタインデー/母の日/父の日/ホリデーギフトガイド/夏の必需品。
  • **フェーズ4 — カナダ(20語、CA):**フェーズ1〜3の上位検索語をカナダを対象に再実行します。

スクレイピング後 — 次のステップ

  1. 重複を除去します(list-dedupを参照)。
  2. 各ブランドの解決とエンリッチメントを行います。ドメイン → 企業のLinkedIn → 企業属性情報 (coldiq-search-enrich、contact-enrichmentを参照)。
  3. クライアントのICPに照らしてスコアリングします(tam-scoringを参照)。
  4. 条件を満たす企業の連絡先を取得し、キャンペーンに登録します(instantly-apiを参照)。

品質に関する注意事項

  • 本格的な広告運用を行うブランドに絞るには、動画広告が10件以上あることを条件にします。規模の小さい業種では、しきい値を下げて(5件以上)ください。
  • エンリッチメントの前に、Metaの広告主名を整理する必要があります(「LLC」、絵文字、ストアの接尾辞を削除)。
  • 広告数は多いのに解決可能なドメインがないブランドは、通常マーケットプレイスの販売業者です。優先度を下げてください。

コメント