meta-ads-scraper について
ColdIQ の非同期エンドポイントで Meta Ad Library を検索するエージェントスキルです。段階別の検索語を使い、DTC や E コマース向けに動画広告を出稿中のブランドを探します。
主な機能
- 01Meta 広告の検索ジョブを送信
- 02非同期ジョブを確認して結果を取得
- 034段階の検索語でブランドを検索
- 04発見したブランドの集約と重複排除
- 05後続のリード補完とスコアリングを案内
活用シーン
- 01DTC クライアント向けの広告主探し
- 02業種や地域別の広告主検索
- 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を参照)。
- キーワード/検索語(またはURL)を1つ送信します。
→ POST
/v1/meta-ads/search· 一律 ·meta_ads.search.create{ "query": "shop now free shipping", "country": "US" } - 完了するまでポーリングしてから、広告を読み取ります。
→ 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の上位検索語をカナダを対象に再実行します。
スクレイピング後 — 次のステップ
- 重複を除去します(list-dedupを参照)。
- 各ブランドの解決とエンリッチメントを行います。ドメイン → 企業のLinkedIn → 企業属性情報 (coldiq-search-enrich、contact-enrichmentを参照)。
- クライアントのICPに照らしてスコアリングします(tam-scoringを参照)。
- 条件を満たす企業の連絡先を取得し、キャンペーンに登録します(instantly-apiを参照)。
品質に関する注意事項
- 本格的な広告運用を行うブランドに絞るには、動画広告が10件以上あることを条件にします。規模の小さい業種では、しきい値を下げて(5件以上)ください。
- エンリッチメントの前に、Metaの広告主名を整理する必要があります(「LLC」、絵文字、ストアの接尾辞を削除)。
- 広告数は多いのに解決可能なドメインがないブランドは、通常マーケットプレイスの販売業者です。優先度を下げてください。
コメント
Markdown 対応