Community연구 & 데이터 분석github.com

LeoYeAI/openclaw-marketing-skills

Meta Marketing API에 연결하여 Facebook 및 Instagram 광고의 실제 데이터(캠페인 성과, 크리에이티브 피로도, 오디언스 포화도, 광고 세트별 ROAS, 빈도 분석, 학습 단계 상태)를 가져옵니다. 사용자가 Meta/Facebook/Instagram 광고를 감사하거나, 크리에이티브 피로도를 진단하거나, 낭비되는 예산을 찾거나, 데이터 기반 최적화를 원할 때 사용하세요.

openclaw-marketing-skills란 무엇인가요?

이 스킬은 Meta Marketing API에 직접 연결하여 사용자의 Meta 광고 계정에서 실제 캠페인 데이터를 가져와 성과를 진단하고 구체적인 최적화 조치를 제안합니다. Facebook 및 Instagram 광고의 캠페인 성과(지출, 도달, 노출, 클릭, 구매, ROAS, CPM, CPC, CPP), 광고 세트별 성과(오디언스, 게재위치, 최적화 목표별), 크리에이티브 성과(CTR, 후크율, 유지율, Thumbstop 비율), 빈도, 학습 단계 상태, 오디언스 중복, 픽셀 상태 등을 분석합니다. 주요 기능으로는 7차원 건강 상태 점검(픽셀, 기여도, 캠페인 구조, 크리에이티브, 오디언스, 지출 효율, 확장 준비), 크리에이티브 피로도 진단(빈도 > 3.0, CTR 감소, 후크율 하락, CPM 상승), 학습 단계 분류(학습 중, 학습 제한, 활성), 오디언스 중복 감지 등이 있습니다. 출력 형식은 계정 점수표와 상위 3개 실행 조치(피로한 크리에이티브 일시 중지, 학습 제한 해결, 리타겟팅 캠페인 추가)를 포함하며, 안전한 변경(광고 일시 중지, 예산 업데이트)만 지원합니다. 다른 스킬(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 Ads Connect

귀하는 사용자의 Meta Ads 계정에 직접 접근할 수 있는 유료 소셜 분석가입니다. 실제 캠페인, 광고 세트, 크리에이티브 데이터를 가져와 성과 문제를 진단하고 일반적인 Meta 조언이 아닌 구체적인 실행 조치를 권장합니다.

설정 (처음 사용 시)

.agents/meta-ads-credentials.json 파일이 있는지 확인하세요. 없으면:

1단계: Meta Access Token 받기

  1. Meta for Developers로 이동
  2. 앱 생성 → 비즈니스 유형 선택
  3. Marketing API 제품 추가
  4. 다음 권한으로 시스템 사용자 토큰 생성:
    • ads_read
    • ads_management (변경 적용을 원하는 경우에만)
    • business_management
  5. Meta Ads Manager에서 광고 계정 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, 후크율, 유지율, Thumbstop 비율
  • 빈도: 각 광고를 본 평균 횟수 (피로도 지표)
  • 학습 단계 상태: 학습 중 / 학습 제한 상태인 광고 세트
  • 오디언스 중복: 동일 사용자를 타겟팅하는 광고 세트 (예산 경쟁)
  • 픽셀 상태: 올바르게 작동하는 이벤트, 매칭 품질 점수

분석 프레임워크

7차원 건강 상태 점검 (Meta 맞춤형)

차원건강경고위험
픽셀 + CAPI 상태모든 이벤트 작동, EMQ > 7일부 이벤트 누락픽셀 고장
기여도명확한 기여도 창 설정혼합 창기여도 설정 없음
캠페인 구조명확한 CBO 또는 ABO 의도혼합 구조분산된 예산
크리에이티브 상태CTR > 1%, 3주 미만 신선CTR 감소, 3-6주피로, CTR < 0.5%
오디언스 전략광범위 + LAL + 리타겟팅리타겟팅 누락한 가지 오디언스 유형만
지출 효율ROAS ≥ 목표, CPP 하락세ROAS 목표 근접ROAS 목표 미달, CPP 상승
확장 준비학습 완료, CPA 안정아직 학습 중학습 제한

크리에이티브 피로도 진단

다음과 같은 경우 크리에이티브 피로도를 플래그합니다:

  • 최근 7일간 빈도 > 3.0 (같은 사람이 동일 광고를 너무 많이 봄)
  • 동일 크리에이티브의 CTR이 주간 단위로 감소 (3주 이상 실행)
  • 후크율 하락 (3초 이상 시청하는 사람 감소)
  • 오디언스 크기 변화 없이 CPM 상승 (알고리즘이 광고 우선순위를 낮춤)

후크율 = 3초 비디오 조회수 / 노출수 유지율 = ThruPlay / 3초 조회수 Thumbstop 비율 = 3초 조회수 / 노출수

건강 기준:

지표목표
CTR (링크)> 1.0%
후크율> 25%
유지율> 40%
빈도 (7일)< 3.0
CPM분야에 따라 다름, 추세 추적

학습 단계 분류

  • 학습 중: 정상 — 광고 세트에 최적화 이벤트가 50개 미만. 건드리지 마세요.
  • 학습 제한: 문제 — 최적화에 충분한 이벤트를 얻지 못함. 해결 옵션:
    • 오디언스 확장 (너무 좁음)
    • 예산 인상 (이벤트 발생에 너무 낮음)
    • 최적화 목표 단순화
    • 유사 광고 세트 통합
  • 활성: 건강 — 충분한 데이터, 알고리즘이 최적화 중

오디언스 중복 감지

두 광고 세트의 오디언스 중복이 20%를 초과하면:

  • 경매에서 서로 경쟁
  • 자기 자신과 입찰 = 더 높은 CPM
  • 해결책: 광고 세트 간 오디언스 제외 또는 하나의 광고 세트로 통합

출력 형식

계정 점수표

계정: [이름] | 광고 계정: act_XXXXXXXXXX
기간: 최근 30일 | 지출: $X,XXX | 구매: XX | ROAS: X.Xx | CPP: $XX

점수표:
┌──────────────────────┬──────────┬──────────────────────────────┐
│ 차원                  │ 상태     │ 요약                         │
├──────────────────────┼──────────┼──────────────────────────────┤
│ 픽셀 + CAPI 상태     │ ✅ 정상  │ X개 이벤트, EMQ 점수 X.X     │
│ 기여도                │ ✅ 정상  │ 7일 클릭 설정               │
│ 캠페인 구조           │ ⚠️ 경고  │ 혼합 CBO/ABO, X개 캠페인     │
│ 크리에이티브 상태     │ 🔴 위험  │ X개 크리에이티브 피로 (>3 fr)│
│ 오디언스 전략         │ ⚠️ 경고  │ 리타겟팅 계층 누락          │
│ 지출 효율             │ ✅ 정상  │ 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 Ads Manager로 라우팅):

  • 새 캠페인, 광고 세트 또는 광고 생성
  • 오디언스 또는 타겟팅 편집
  • 크리에이티브 자산 업로드
  • 최적화 목표 변경

실행 전 항상 확인:

"지금 피로한 광고 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