skills.rest
LeoYeAI
LeoYeAICOMMUNITY
Explore all skills by this author →
Website𝕏@LeoYe_AIGitHub

meta-ads-connect

Pulls Meta Marketing API data to audit Facebook and Instagram ad performance.

1.0k|382|Updated Mar 17, 2026
Search Tags:#paid social#roas#creative fatigue#marketing api#Meta ads#Facebook ads#Instagram Ads
One-click install
npx skills add https://github.com/LeoYeAI/openclaw-marketing-skills --skill meta-ads-connect
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: meta-ads-connect
Source: https://github.com/LeoYeAI/openclaw-marketing-skills/tree/main/skills/meta-ads-connect
Command: npx skills add https://github.com/LeoYeAI/openclaw-marketing-skills --skill meta-ads-connect

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

Auditing Meta ads manually means digging through Ads Manager exports and guessing at causes of declining performance. This Skill connects directly to the Meta Marketing API to pull real campaign, ad set, and creative data, then diagnoses issues like creative fatigue, wasted budget, and Learning Limited ad sets with concrete numbers.

Core Features & Use Cases

  • Live Account Data Pull: Fetches 30 days of campaign performance, ad set breakdowns, creative metrics (CTR, hook rate, hold rate), frequency, and ROAS via the Meta Marketing API.
  • 7-Dimension Health Check: Scores pixel health, attribution, campaign structure, creative health, audience strategy, spend efficiency, and scaling readiness against defined thresholds.
  • Creative Fatigue & Audience Overlap Detection: Flags fatigued creatives (frequency > 3.0, declining CTR) and ad sets competing against each other with >20% audience overlap.
  • Use Case: A marketer notices Facebook ROAS dropping. They run the audit script, get a scorecard showing three fatigued creatives and a Learning Limited ad set, then receive prioritized actions: pause the fatigued ads, broaden the narrow audience, and add a retargeting campaign.

Quick Start

Ask the agent to audit my Meta ads account for the last 30 days and identify fatigued creatives and wasted budget.

Frequently Asked Questions about meta-ads-connect

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I audit my Facebook ads performance with real data?▼

Connect the Meta Marketing API with an access token and ad account ID, then run the audit script to pull 30 days of campaign, ad set, and creative metrics. The output includes a 7-dimension health scorecard and prioritized optimization actions.

How to detect creative fatigue in Meta ads?▼

Creative fatigue is flagged when frequency exceeds 3.0 in the last 7 days, CTR declines week-over-week for 3+ weeks, hook rate drops, or CPM rises without audience changes. The audit reports these signals per creative so you know which ads to pause.

What permissions does the Meta Marketing API token need?▼

The token requires ads_read for pulling performance data, business_management for account access, and ads_management only if you want to apply changes like pausing ads. Generate a System User Token from a Meta for Developers Business app.

Can this skill create new Meta campaigns or ads automatically?▼

No. Automated mutations are intentionally limited to safe, reversible operations: pausing ads or ad sets and updating budgets. Creating campaigns, editing targeting, or uploading creatives is routed to Meta Ads Manager instead.

Why is my Meta ad set stuck in Learning Limited?▼

Learning Limited means the ad set cannot gather roughly 50 optimization events, usually due to an audience that is too narrow, a budget too low for the conversion goal, or fragmented ad sets. Fixes include broadening the audience, raising budget, or merging similar ad sets.

Related Skills

Explore More Marketing & Sales Skills→
dengineproblemdengineproblem

WABA Setup

Guide WhatsApp Business API setup through credential collection and webhook registration.

Community
Intermediate
Synter-Media-AISynter-Media-AI

meta-ads-diagnostics

Diagnose Meta Ads campaign issues like Learning Phase and creative fatigue.

Official
Advanced
cognyaicognyai
90

conversion-debug

Diagnose conversion tracking discrepancies across GTM, GA4, Google Ads, and Meta Pixel.

Official
Advanced
DeliciousHouseDeliciousHouse
2

meta-ads-publisher

Automates Meta Ads Manager publishing of campaigns, ad sets, and ads via Marketing API with paused status for review.

Community
Advanced