meta-ads-audit
Free, open-source Claude Code plugin for read-only Meta (Facebook/Instagram) ad account audits: reports, recommendations, AI context pack and a visual HTML report.
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Check it deeper on your machine
It has changed since its scan on 21 Nov 2026.
As a Claude Code plugin, install it and then ask Claude Code:
/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/bertugbodur/meta-ads-audit with scanskillsafety
Or from a terminal, clone it and run it:
git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/bertugbodur/meta-ads-audit'
It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.
Badge for your README
Markdown
[](/listings/bertugbodur--meta-ads-audit)HTML
<a href="/listings/bertugbodur--meta-ads-audit"><img src="/api/listings/bertugbodur--meta-ads-audit/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
In Claude Code:
/plugin marketplace add bertugbodur/meta-ads-audit /plugin install meta-ads-audit@meta-ads-audit
Then connect your ad account:
/mcp → meta-ads → Authenticate
Sign in with Facebook and pick the ad accounts you want Claude to see. Then just ask:
Audit my Meta ad account
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
.claude-plugin/marketplace.json · Manifest · 11 lines
- {
- "name": "meta-ads-audit",
- "owner": { "name": "bertugbodur" },
- "plugins": [
- {
- "name": "meta-ads-audit",
- "source": "./",
- "description": "Read-only Meta ad account audit with reports, recommendations and a visual HTML report."
- }
- ]
- }
README.md · README · 80 lines
- # meta-ads-audit
- A free, open-source **Claude Code plugin** that audits your Meta (Facebook / Instagram) ad account, **read-only**, and writes five files: an account report, prioritized recommendations, an AI context pack, technical tasks and a visual HTML report.
- No server, no developer app, no API keys. Data comes from Meta's own ads MCP server (`https://mcp.facebook.com/ads`) after you sign in with your own Facebook account. Your own Claude does the analysis.
- <p align="center">
- <img src="examples/screenshots/desktop-1280.png" alt="Visual HTML report on desktop" width="720">
- <img src="examples/screenshots/mobile-390.png" alt="Visual HTML report on mobile" width="220">
- </p>
- _Screenshots use the fully fictional demo in [`examples/demo-output/`](examples/demo-output/). Open [`report.html`](examples/demo-output/report.html) in any browser to try it; it has an EN / TR switch._
- ## Install
- In Claude Code:
- ```
- /plugin marketplace add bertugbodur/meta-ads-audit
- /plugin install meta-ads-audit@meta-ads-audit
- ```
- Then connect your ad account:
- ```
- /mcp → meta-ads → Authenticate
- ```
- Sign in with Facebook and pick the ad accounts you want Claude to see. Then just ask:
- ```
- Audit my Meta ad account
- ```
- ## What you get
- Everything is written to `reports/<account>-<YYYY-MM-DD>/`, in the language you write in, with numbers in your account's currency.
- | File | What it is |
- |---|---|
- | `01-account-report.md` | Summary, KPI table (last 30 days vs previous 30), campaigns, top and bottom ads, breakdown outliers, trends, data gaps |
- | `02-recommendations.md` | Up to 10 actions, ordered by priority, each with the finding (and its number), action, impact and effort |
- | `03-ai-context.md` / `.json` | A self-contained context pack to paste into any AI assistant for creative ideas or a budget plan |
- | `04-technical-tasks.md` | Checklist for Pixel / Conversions API (with `event_id` deduplication), UTMs and other tracking fixes tied to the findings |
- | `report.html` | One offline file you open in a browser: heat map, KPIs, campaign cards, recommendations, checklist, segments, "Copy AI context" button, print to PDF |
- Raw API responses are saved under `data/` so every number can be traced back.
- ## Read-only and private
- - The skill **never** calls tools that create, update, delete, pause or change budgets, bids or targeting. If you ask for a change, Claude spells out exactly what would change and waits for your explicit confirmation.
- - **Your data stays between Meta and your own Claude.** The plugin has no server, no analytics and no telemetry. `report.html` makes no network requests.
- - Every finding comes with a number from your data. Missing data is marked "No data"; nothing is estimated.
- ## About the rules
- The thresholds (for example "frequency above 3 and CTR down more than 20% means creative fatigue") are **generic heuristics**, not industry facts. Claude always compares them with your account's own baseline and labels them as heuristics in the report. See [`skills/meta-ads-audit/SKILL.md`](skills/meta-ads-audit/SKILL.md) for the full list.
- ## Repository layout
- ```
- .claude-plugin/ plugin.json, marketplace.json
- .mcp.json Meta's ads MCP server
- skills/meta-ads-audit/
- SKILL.md the audit workflow
- templates/report.html the visual report template (schema documented at the top)
- examples/demo-output/ fictional example of all 5 outputs
- ```
- ## Contributing
- Issues and pull requests are welcome: new heuristics, better report sections, more interface languages (add a block to `I18N` in `report.html`). Please keep the plugin read-only and never commit real account data.
- ## Disclaimer
- Not affiliated with, endorsed or sponsored by Meta Platforms, Inc. "Meta", "Facebook" and "Instagram" are trademarks of Meta Platforms, Inc. and are used here only to describe what the plugin works with.
- ## License
- [MIT](LICENSE)
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.