Community研究＆データ分析github.com

Meta広告Connect

Meta Marketing APIに接続し、FacebookやInstagramの実際の広告データ（キャンペーン効果、クリエイティブ疲れ、オーディエンス飽和、広告セット別ROAS、フリークエンシー分析、学習段階ステータス）を取得します。ユーザーがMeta広告の監査、クリエイティブ疲れの診断、無駄な予算の発見、データに基づく最適化を望む場合に使用します。

Meta広告Connect とは？

このスキルは、Meta Marketing APIを通じてユーザーの実際のFacebook・Instagram広告データを取得し、パフォーマンス問題を診断・改善するためのデータ駆動型アシスタントです。汎用的なアドバイスではなく、キャンペーン・広告セット・クリエイティブの実際の指標（CPM、CTR、フリークエンシー、ROAS、学習段階など）を分析し、具体的なアクション（疲れたクリエイティブの一時停止、学習制限の修正、リターゲティングキャンペーンの追加など）を提案します。主なプラットフォームはClaude Code、Cursor、CodexなどのAIエージェント環境に対応しており、設定ファイル（.agents/meta-ads-credentials.json）を用いて認証情報を管理します。このスキルは、paid-adsやad-creativeといった他のスキルと連携することで、より精度の高い広告運用を支援します。また、変更は安全で可逆的な操作に限定されており、実行前に必ずユーザー確認を求めます。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/LeoYeAI/openclaw-marketing-skills/tree/main/skills/meta-ads-connect

Installed? Explore more 研究＆データ分析 skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

オリジナルを見る→すべてのスキルを見る

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

OpenAIChatGPTClaudeClaudeGeminiGeminiGrokGrokPerplexityPerplexityDeepSeekDeepSeek

ドキュメント

Meta広告Connect は何をしますか？

あなたは、ユーザーのMeta広告アカウントに直接アクセスできる有料ソーシャルアナリストです。実際のキャンペーン、広告セット、クリエイティブデータを取得し、パフォーマンス問題を診断し、具体的なアクション（一般的なMetaのアドバイスではありません）を推奨します。

セットアップ（初回）

.agents/meta-ads-credentials.jsonの有無を確認します。存在しない場合：

ステップ1：Metaアクセストークンを取得する

  1. Meta for Developersにアクセス
  2. アプリ（Businessタイプ）作成
  3. Marketing APIプロダクトを追加
  4. 以下の権限を持つシステムユーザートークンを生成：
    • ads_read
    • ads_management（ユーザーが変更を適用したい場合のみ）
    • business_management
  5. Meta広告マネージャーから広告アカウントIDを取得（形式：act_XXXXXXXXXX）

ステップ2：認証情報を保存する

.agents/meta-ads-credentials.jsonに保存：

{
  "access_token": "EAAxxxxxxxxxx...",
  "ad_account_id": "act_XXXXXXXXXX",
  "app_id": "...",
  "app_secret": "..."
}

トークン更新

Metaトークンは期限切れになります。長期間使用する場合：

python skills/meta-ads-connect/scripts/refresh_token.py

データ取得

python skills/meta-ads-connect/scripts/audit.py \
  --account act_XXXXXXXXXX \
  --days 30 \
  --output .agents/meta-ads-data.json

取得するデータ（デフォルトは過去30日間）：

  • キャンペーンパフォーマンス：支出、リーチ、インプレッション、クリック、購入、ROAS、CPM、CPC、CPP
  • 広告セット内訳：オーディエンス、プレースメント、最適化目標ごとのパフォーマンス
  • 広告・クリエイティブパフォーマンス：クリエイティブごとのCTR、フック率、保持率、サムストップ比率
  • フリークエンシー：各ユーザーが各広告を見た平均回数（疲れの指標）
  • 学習段階ステータス：学習中/学習制限中の広告セット
  • オーディエンス重複：同じユーザーをターゲットにしている広告セット（予算競合）
  • ピクセル状態：イベントが正しく発火しているか、マッチ品質スコア

分析フレームワーク

7次元ヘルスチェック（Meta調整済み）

次元良好警告重大
ピクセル+CAPI状態全イベント発火、EMQ > 7一部イベント欠落ピクセル異常
アトリビューション明確なアトリビューションウィンドウ設定ウィンドウ混在アトリビューション未設定
キャンペーン構造明確なCBOまたはABOの意図構造混在予算の断片化
クリエイティブ状態CTR > 1%、3週未満の新鮮さCTR低下、3〜6週間疲れ、CTR < 0.5%
オーディエンス戦略ブロード + LAL + リターゲティングリターゲティング欠如1種類のオーディエンスのみ
支出効率ROAS ≥ 目標、CPP減少傾向ROASが目標値近傍ROASが目標値を下回る、CPP上昇
拡張準備状態学習完了、安定CPA学習中学習制限

クリエイティブ疲れ診断

以下の場合にクリエイティブ疲れをフラグ付け：

  • フリークエンシー > 3.0 過去7日間（同じ人が同じ広告を何度も見ている）
  • CTRが週ごとに低下している同じクリエイティブ（3週間以上継続）
  • フック率低下（3秒以上視聴する人が減少）
  • CPM上昇（オーディエンスサイズの変化なし、アルゴリズムが広告を優先しなくなった）

フック率 = 3秒動画再生数 / インプレッション数 保持率 = ThruPlay / 3秒再生数 サムストップ比率 = 3秒再生数 / インプレッション数

健全なベンチマーク：

指標目標
CTR（リンク）> 1.0%
フック率> 25%
保持率> 40%
フリークエンシー（7日）< 3.0
CPMニッチによる、トレンドを追跡

学習段階トリアージ

  • 学習中：正常 — 広告セットが50件未満の最適化イベント。触らない。
  • 学習制限：問題 — 最適化に十分なイベントを取得できない。修正オプション：
    • オーディエンスを広くする（狭すぎる）
    • 予算を増やす（イベント発生に低すぎる）
    • 最適化目標を簡素化する
    • 類似した広告セットを統合する
  • アクティブ：良好 — 十分なデータ、アルゴリズムが最適化中

オーディエンス重複検出

2つの広告セットが20%以上のオーディエンス重複を持つ場合：

  • オークションで互いに競合する
  • 自分自身に対して入札している = より高いCPM
  • 修正：広告セット間でオーディエンスを除外するか、1つの広告セットに統合する

出力形式

アカウントスコアカード

アカウント：[名前] | 広告アカウント：act_XXXXXXXXXX
期間：過去30日間 | 支出：$X,XXX | 購入：XX | ROAS：X.Xx | CPP：$XX

スコアカード：
┌──────────────────────┬──────────┬──────────────────────────────┐
│ 次元                 │ ステータス│ サマリー                      │
├──────────────────────┼──────────┼──────────────────────────────┤
│ ピクセル+CAPI状態    │ ✅ OK    │ Xイベント、EMQスコア X.X      │
│ アトリビューション   │ ✅ OK    │ 7日間クリック設定             │
│ キャンペーン構造     │ ⚠️ 警告  │ CBO/ABO混在、Xキャンペーン     │
│ クリエイティブ状態   │ 🔴 重大  │ Xクリエイティブ疲れ（>3回）   │
│ オーディエンス戦略   │ ⚠️ 警告  │ リターゲティング層欠落         │
│ 支出効率             │ ✅ OK    │ ROAS X.Xx vs 目標 X.Xx       │
│ 拡張準備状態         │ ⚠️ 警告  │ X広告セットが学習制限中        │
└──────────────────────┴──────────┴──────────────────────────────┘

トップ3アクション

常に以下を出力：

  1. 疲れたクリエイティブを一時停止 — [広告名一覧]、フリークエンシーX.X、CTRが3週間でXX%低下

    • 影響：CPM低減、関連性スコア向上
    • 次に：新しいクリエイティブバリエーションをX件依頼（ad-creativeスキルを使用）

  2. 学習制限を修正 — [広告セット名]がX日間学習制限中

    • 原因：オーディエンスが狭すぎる（XX,XXX人）/ 予算が低すぎる（$XX/日でXコンバージョン目標）
    • 修正：[具体的なオーディエンス拡大 または 予算増額]

  3. リターゲティングキャンペーンを追加 — リターゲティングが検出されません。ウェブサイト訪問者が再獲得されていません。

    • セットアップ：3つの広告セット — 7日間訪問者、30日間訪問者、カート放棄者
    • 推定ROAS：3〜5倍（リターゲティングは通常プロスペクティングを上回る）

実行（オプション）

変更可能範囲は意図的に狭く、安全で可逆的な操作のみ：

python skills/meta-ads-connect/scripts/mutate.py \
  --pause-ad "ad_id_1,ad_id_2" \
  --pause-adset "adset_id" \
  --update-adset-budget "adset_id:50" \
  --update-campaign-budget "campaign_id:200"

自動化されていません（代わりにMeta広告マネージャーにルーティング）：

  • 新しいキャンペーン、広告セット、広告の作成
  • オーディエンスやターゲティングの編集
  • クリエイティブアセットのアップロード
  • 最適化目標の変更

実行前に必ず確認：

"2つの疲れた広告を一時停止し、1つの学習制限広告セットの予算を増額しようとしています。確認しますか？"

すべての変更は.agents/meta-ads-changes.jsonに記録されます。

他のスキルとの統合

  • paid-ads：一般的なMeta戦略をアカウント固有のデータに置き換え
  • ad-creative：実際のフック率/CTRデータを使用して、より優れたクリエイティブのブリーフィングを作成 — 何が機能しているかを把握
  • ab-test-setup：実際のパフォーマンスギャップに基づいて構造化されたクリエイティブテストを設計
  • analytics-tracking：MetaコンバージョンをGA4と相互参照し、アトリビューションの健全性チェックを実行

参考文献

関連スキル

  • paid-ads：全プラットフォームにおける有料広告戦略全体
  • google-ads-connect：有料検索＋有料ソーシャルの完全なビューを得るために対
  • ad-creative：クリエイティブ疲れが検出された際に新しいクリエイティブを生成するため
  • analytics-tracking：ピクセル設定とコンバージョンイベント設定のため
  • ab-test-setup：構造化されたクリエイティブおよびオーディエンステストのため

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

LeoYeAI/openclaw-marketing-skills

When the user wants to plan, design, or implement an A/B test or experiment. Also use when the user mentions "A/B test," "split test," "experiment," "test this change," "variant copy," "multivariate test," "hypothesis," "should I test this," "which version is better," "test two versions," "statistical significance," or "how long should I run this test." Use this whenever someone is comparing two approaches and wants to measure which performs better. For tracking implementation, see analytics-tra

LeoYeAI/openclaw-marketing-skills

When the user wants to generate, iterate, or scale ad creative — headlines, descriptions, primary text, or full ad variations — for any paid advertising platform. Also use when the user mentions 'ad copy variations,' 'ad creative,' 'generate headlines,' 'RSA headlines,' 'bulk ad copy,' 'ad iterations,' 'creative testing,' 'ad performance optimization,' 'write me some ads,' 'Facebook ad copy,' 'Google ad headlines,' 'LinkedIn ad text,' or 'I need more ad variations.' Use this whenever someone needs to produce ad copy at scale or iterate on existing ads. For campaign strategy and targeting, see paid-ads. For landing page copy, see copywriting.

LeoYeAI/openclaw-marketing-skills

When the user wants to optimize content for AI search engines, get cited by LLMs, or appear in AI-generated answers. Also use when the user mentions 'AI SEO,' 'AEO,' 'GEO,' 'LLMO,' 'answer engine optimization,' 'generative engine optimization,' 'LLM optimization,' 'AI Overviews,' 'optimize for ChatGPT,' 'optimize for Perplexity,' 'AI citations,' 'AI visibility,' 'zero-click search,' 'how do I show up in AI answers,' 'LLM mentions,' or 'optimize for Claude/Gemini.' Use this whenever someone wants their content to be cited or surfaced by AI assistants and AI search engines. For traditional technical and on-page SEO audits, see seo-audit. For structured data implementation, see schema-markup.

LeoYeAI/openclaw-marketing-skills

When the user wants to set up, improve, or audit analytics tracking and measurement. Also use when the user mentions "set up tracking," "GA4," "Google Analytics," "conversion tracking," "event tracking," "UTM parameters," "tag manager," "GTM," "analytics implementation," "tracking plan," "how do I measure this," "track conversions," "attribution," "Mixpanel," "Segment," "are my events firing," or "analytics isn't working." Use this whenever someone asks how to know if something is working or wan

LeoYeAI/openclaw-marketing-skills

When the user wants to reduce churn, build cancellation flows, set up save offers, recover failed payments, or implement retention strategies. Also use when the user mentions 'churn,' 'cancel flow,' 'offboarding,' 'save offer,' 'dunning,' 'failed payment recovery,' 'win-back,' 'retention,' 'exit survey,' 'pause subscription,' 'involuntary churn,' 'people keep canceling,' 'churn rate is too high,' 'how do I keep users,' or 'customers are leaving.' Use this whenever someone is losing subscribers o

LeoYeAI/openclaw-marketing-skills

Write B2B cold emails and follow-up sequences that get replies. Use when the user wants to write cold outreach emails, prospecting emails, cold email campaigns, sales development emails, or SDR emails. Also use when the user mentions "cold outreach," "prospecting email," "outbound email," "email to leads," "reach out to prospects," "sales email," "follow-up email sequence," "nobody's replying to my emails," or "how do I write a cold email." Covers subject lines, opening lines, body copy, CTAs, p

LeoYeAI/openclaw-marketing-skills

When the user wants to create competitor comparison or alternative pages for SEO and sales enablement. Also use when the user mentions 'alternative page,' 'vs page,' 'competitor comparison,' 'comparison page,' '[Product] vs [Product],' '[Product] alternative,' 'competitive landing pages,' 'how do we compare to X,' 'battle card,' or 'competitor teardown.' Use this for any content that positions your product against competitors. Covers four formats: singular alternative, plural alternatives, you v

LeoYeAI/openclaw-marketing-skills

When the user wants to plan a content strategy, decide what content to create, or figure out what topics to cover. Also use when the user mentions "content strategy," "what should I write about," "content ideas," "blog strategy," "topic clusters," "content planning," "editorial calendar," "content marketing," "content roadmap," "what content should I create," "blog topics," "content pillars," or "I don't know what to write." Use this whenever someone needs help deciding what content to produce,

LeoYeAI/openclaw-marketing-skills

When the user wants to edit, review, or improve existing marketing copy. Also use when the user mentions 'edit this copy,' 'review my copy,' 'copy feedback,' 'proofread,' 'polish this,' 'make this better,' 'copy sweep,' 'tighten this up,' 'this reads awkwardly,' 'clean up this text,' 'too wordy,' or 'sharpen the messaging.' Use this when the user already has copy and wants it improved rather than rewritten from scratch. For writing new copy, see copywriting.

LeoYeAI/openclaw-marketing-skills

When the user wants to write, rewrite, or improve marketing copy for any page — including homepage, landing pages, pricing pages, feature pages, about pages, or product pages. Also use when the user says "write copy for," "improve this copy," "rewrite this page," "marketing copy," "headline help," "CTA copy," "value proposition," "tagline," "subheadline," "hero section copy," "above the fold," "this copy is weak," "make this more compelling," or "help me describe my product." Use this whenever s

LeoYeAI/openclaw-marketing-skills

When the user wants to create or optimize an email sequence, drip campaign, automated email flow, or lifecycle email program. Also use when the user mentions "email sequence," "drip campaign," "nurture sequence," "onboarding emails," "welcome sequence," "re-engagement emails," "email automation," "lifecycle emails," "trigger-based emails," "email funnel," "email workflow," "what emails should I send," "welcome series," or "email cadence." Use this for any multi-email automated flow. For cold out

LeoYeAI/openclaw-marketing-skills

When the user wants to optimize any form that is NOT signup/registration — including lead capture forms, contact forms, demo request forms, application forms, survey forms, or checkout forms. Also use when the user mentions "form optimization," "lead form conversions," "form friction," "form fields," "form completion rate," "contact form," "nobody fills out our form," "form abandonment," "too many fields," "demo request form," or "lead form isn't converting." Use this for any non-signup form tha

LeoYeAI/openclaw-marketing-skills

When the user wants to plan, evaluate, or build a free tool for marketing purposes — lead generation, SEO value, or brand awareness. Also use when the user mentions "engineering as marketing," "free tool," "marketing tool," "calculator," "generator," "interactive tool," "lead gen tool," "build a tool for leads," "free resource," "ROI calculator," "grader tool," "audit tool," "should I build a free tool," or "tools for lead gen." Use this whenever someone wants to build something useful and give

LeoYeAI/openclaw-marketing-skills

Connect GetXAPI to pull public X/Twitter marketing signals into OpenClaw workflows. Use when the user wants social listening, tweet search, reply search, user lookup, or monitor setup driven by a Bearer-auth search backend. Enhances social-content, paid-ads, ad-creative, content-strategy, launch-strategy, and competitor-alternatives with real public conversation data.

LeoYeAI/openclaw-marketing-skills

Connect to Google Ads API to pull real account data — campaign performance, keyword health, wasted spend, search terms, impression share. Use when the user wants to audit their Google Ads account, find wasted budget, optimize keywords, or get data-driven recommendations. Enhances paid-ads and ad-creative skills with real numbers instead of guesswork. Triggers on: 'audit my Google Ads', 'find wasted spend', 'why are my ads not converting', 'Google Ads performance', 'which keywords to pause', 'Goo

LeoYeAI/openclaw-marketing-skills

When the user wants to plan a product launch, feature announcement, or release strategy. Also use when the user mentions 'launch,' 'Product Hunt,' 'feature release,' 'announcement,' 'go-to-market,' 'beta launch,' 'early access,' 'waitlist,' 'product update,' 'how do I launch this,' 'launch checklist,' 'GTM plan,' or 'we're about to ship.' Use this whenever someone is preparing to release something publicly. For ongoing marketing after launch, see marketing-ideas.

LeoYeAI/openclaw-marketing-skills

When the user wants to create, plan, or optimize a lead magnet for email capture or lead generation. Also use when the user mentions "lead magnet," "gated content," "content upgrade," "downloadable," "ebook," "cheat sheet," "checklist," "template download," "opt-in," "freebie," "PDF download," "resource library," "content offer," "email capture content," "Notion template," "spreadsheet template," or "what should I give away for emails." Use this for planning what to create and how to distribute

LeoYeAI/openclaw-marketing-skills

When the user needs marketing ideas, inspiration, or strategies for their SaaS or software product. Also use when the user asks for 'marketing ideas,' 'growth ideas,' 'how to market,' 'marketing strategies,' 'marketing tactics,' 'ways to promote,' 'ideas to grow,' 'what else can I try,' 'I don't know how to market this,' 'brainstorm marketing,' or 'what marketing should I do.' Use this as a starting point whenever someone is stuck or looking for inspiration on how to grow. For specific channel execution, see the relevant skill (paid-ads, social-content, email-sequence, etc.).

LeoYeAI/openclaw-marketing-skills

When the user wants to apply psychological principles, mental models, or behavioral science to marketing. Also use when the user mentions 'psychology,' 'mental models,' 'cognitive bias,' 'persuasion,' 'behavioral science,' 'why people buy,' 'decision-making,' 'consumer behavior,' 'anchoring,' 'social proof,' 'scarcity,' 'loss aversion,' 'framing,' or 'nudge.' Use this whenever someone wants to understand or leverage how people think and make decisions in a marketing context.

LeoYeAI/openclaw-marketing-skills

When the user wants to optimize post-signup onboarding, user activation, first-run experience, or time-to-value. Also use when the user mentions "onboarding flow," "activation rate," "user activation," "first-run experience," "empty states," "onboarding checklist," "aha moment," "new user experience," "users aren't activating," "nobody completes setup," "low activation rate," "users sign up but don't use the product," "time to value," or "first session experience." Use this whenever users are si

関連スキル

affaan-m/uspto-database

USPTO patent and trademark data workflow for official record lookup, PatentSearch queries, TSDR checks, assignment data, and reproducible IP research logs.

community

affaan-m/scholar-evaluation

Structured scholarly-work evaluation for papers, proposals, literature reviews, methods sections, evidence quality, citation support, and research-writing feedback.

community

affaan-m/literature-review

Systematic literature-review workflow for academic, biomedical, technical, and scientific topics, including search planning, source screening, synthesis, citation checks, and evidence logging.

community

affaan-m/everything-claude-code

The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.

community

forrestchang/andrej-karpathy-skills

Agent skill repository discovered by 10x-chat research.

community

langgenius/backend-code-review

Review backend code for quality, security, maintainability, and best practices based on established checklist rules. Use when the user requests a review, analysis, or improvement of backend files (e.g., `.py`) under the `api/` directory. Do NOT use for frontend files (e.g., `.tsx`, `.ts`, `.js`). Supports pending-change review, code snippets review, and file-focused review.

community
← More 研究＆データ分析 skills