About

Imported from Synero/meta-ads-analyzer (SKILL.md). Install upstream with npx skills add Synero/meta-ads-analyzer. Copyright stays with the author.

Meta Ads Analyzer

Name: meta-ads-analyzer
Author: Synero

Use this skill when a user asks an AI agent to inspect Facebook/Instagram Ads campaign performance, active campaigns, spend, CTR, CPC, CPM, leads, or messaging conversations.

The project is read-only. It does not create, edit, pause, or delete campaigns.

Setup

git clone https://github.com/Synero/meta-ads-analyzer.git
cd meta-ads-analyzer

export META_ACCESS_TOKEN="your_meta_access_token"
export META_ACCOUNT_ID="act_123456789"

bash setup.sh

Required Meta permissions usually include:

ads_read
ads_management if the user's Meta app/account flow requires it

Commands

./meta-ads.sh test
./meta-ads.sh campaigns
./meta-ads.sh insights
./meta-ads.sh insights --datePreset=last_7d

All commands return JSON.

Intent mapping

User intent	Command	Analysis focus
“How are my campaigns doing?”	`./meta-ads.sh insights`	Spend, CTR, CPC, CPM, conversions
“Which campaigns are active?”	`./meta-ads.sh campaigns`	`status === ACTIVE`
“Which campaign is cheapest?”	`./meta-ads.sh insights`	Compare CPC/CPM against objective
“How many leads/conversations?”	`./meta-ads.sh insights`	Inspect `actions` array
“Is my API connected?”	`./meta-ads.sh test`	Token and account connectivity

Output handling

When summarizing results:

State the date preset used.
Compare campaigns by objective-relevant metrics.
Mention Meta's reporting delay.
Do not expose raw access tokens or private account IDs in logs.
If the CLI returns status: error, report the error and suggest the smallest fix.

Metrics reference

spend: amount spent in the selected period.
impressions: total ad impressions.
reach: unique accounts reached.
clicks: click/interactions count from Meta.
ctr: click-through rate.
cpc: cost per click.
cpm: cost per thousand impressions.
actions: conversion events such as leads or messaging conversations.

Basic heuristics:

CTR below 1%: review creative, audience, or offer.
CTR above 2%: usually healthy, depending on vertical.
Frequency above 3: watch for fatigue if available.
CPC/CPM must be interpreted relative to objective and market.

Troubleshooting

META_ACCESS_TOKEN is required: set the token in the environment.
Permission denied: the app/token probably lacks ads permissions or account access.
Account not found: check that META_ACCOUNT_ID starts with act_ and belongs to the token's accessible accounts.
Empty insights: check date preset, campaign delivery, attribution windows, and Meta reporting delays.

Files

meta-ads.sh: shell wrapper for agents.
meta-ads-cli.js: zero-dependency Node.js CLI.
setup.sh: local setup and syntax checks.
.env.example: credential template.

Use it

Copy one of these into your project. Installing also returns the manifest and these snippets.

yaml

targets:
  - https://api.opensmartroute.ai/api/v1/registry/synero-meta-ads-analyzer-meta-ads-analyzer/manifest   # or paste the manifest below

Manifest

An Open Capability Manifest: the router reads it to know what this does, what it costs and when to pick it.

synero-meta-ads-analyzer-meta-ads-analyzer.ocm.jsonjson

{
  "ocm": "1",
  "id": "synero-meta-ads-analyzer-meta-ads-analyzer",
  "kind": "skill",
  "name": "meta-ads-analyzer",
  "description": "Analyze Facebook/Instagram Ads campaigns via the Meta Marketing API from any AI agent or shell automation.",
  "publisher": "Synero",
  "version": "1.0.0",
  "capabilities": {
    "domains": [
      "coding"
    ],
    "tags": [
      "skill-md",
      "meta",
      "ads",
      "facebook",
      "instagram",
      "analytics",
      "marketing",
      "agents",
      "github"
    ],
    "languages": [
      "en"
    ]
  },
  "quality_prior": 0.6,
  "examples": [
    "Analyze Facebook/Instagram Ads campaigns via the Meta Marketing API from any AI agent or shell automation."
  ],
  "primary": false,
  "metadata": {
    "source": {
      "provider": "github",
      "repository": "https://github.com/Synero/meta-ads-analyzer",
      "path": "SKILL.md",
      "ref": "66a6f5709b4f46a9580aa0f490478e4126e1d12f",
      "url": "https://github.com/Synero/meta-ads-analyzer/blob/66a6f5709b4f46a9580aa0f490478e4126e1d12f/SKILL.md",
      "key": "Synero/meta-ads-analyzer/SKILL.md"
    }
  },
  "instructions": "# Meta Ads Analyzer\n\nUse this skill when a user asks an AI agent to inspect Facebook/Instagram Ads campaign performance, active campaigns, spend, CTR, CPC, CPM, leads, or messaging conversations.\n\nThe project is read-only. It does not create, edit, pause, or delete campaigns.\n\n## Setup\n\n```bash\ngit clone https://github.com/Synero/meta-ads-analyzer.git\ncd meta-ads-analyzer\n\nexport META_ACCESS_TOKEN=\"your_meta_access_token\"\nexport META_ACCOUNT_ID=\"act_123456789\"\n\nbash setup.sh\n```\n\nRequired Meta permissions usually include:\n\n- `ads_read`\n- `ads_management` if the user's Meta app/account flow req",
  "cost": {
    "context_tokens": 703
  }
}

Fetch it by URL: GET /api/v1/registry/synero-meta-ads-analyzer-meta-ads-analyzer/manifest?version=1.0.0

Reviews

Star ratings from people who tried it. One review per account; edit yours any time.

No reviews yet. Install it, try it, and be the first to rate it.