Skip to content
Back to search

meta-ads-audit

MarketplaceWorks with Claude CodeGitHub

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.

Checked today

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
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/bertugbodur--meta-ads-audit/badge.svg)](/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
  1. {
  2. "name": "meta-ads-audit",
  3. "owner": { "name": "bertugbodur" },
  4. "plugins": [
  5. {
  6. "name": "meta-ads-audit",
  7. "source": "./",
  8. "description": "Read-only Meta ad account audit with reports, recommendations and a visual HTML report."
  9. }
  10. ]
  11. }
README.md · README · 80 lines
  1. # meta-ads-audit
  2. 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.
  3. 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.
  4. <p align="center">
  5. <img src="examples/screenshots/desktop-1280.png" alt="Visual HTML report on desktop" width="720">
  6. <img src="examples/screenshots/mobile-390.png" alt="Visual HTML report on mobile" width="220">
  7. </p>
  8. _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._
  9. ## Install
  10. In Claude Code:
  11. ```
  12. /plugin marketplace add bertugbodur/meta-ads-audit
  13. /plugin install meta-ads-audit@meta-ads-audit
  14. ```
  15. Then connect your ad account:
  16. ```
  17. /mcp → meta-ads → Authenticate
  18. ```
  19. Sign in with Facebook and pick the ad accounts you want Claude to see. Then just ask:
  20. ```
  21. Audit my Meta ad account
  22. ```
  23. ## What you get
  24. Everything is written to `reports/<account>-<YYYY-MM-DD>/`, in the language you write in, with numbers in your account's currency.
  25. | File | What it is |
  26. |---|---|
  27. | `01-account-report.md` | Summary, KPI table (last 30 days vs previous 30), campaigns, top and bottom ads, breakdown outliers, trends, data gaps |
  28. | `02-recommendations.md` | Up to 10 actions, ordered by priority, each with the finding (and its number), action, impact and effort |
  29. | `03-ai-context.md` / `.json` | A self-contained context pack to paste into any AI assistant for creative ideas or a budget plan |
  30. | `04-technical-tasks.md` | Checklist for Pixel / Conversions API (with `event_id` deduplication), UTMs and other tracking fixes tied to the findings |
  31. | `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 |
  32. Raw API responses are saved under `data/` so every number can be traced back.
  33. ## Read-only and private
  34. - 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.
  35. - **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.
  36. - Every finding comes with a number from your data. Missing data is marked "No data"; nothing is estimated.
  37. ## About the rules
  38. 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.
  39. ## Repository layout
  40. ```
  41. .claude-plugin/ plugin.json, marketplace.json
  42. .mcp.json Meta's ads MCP server
  43. skills/meta-ads-audit/
  44. SKILL.md the audit workflow
  45. templates/report.html the visual report template (schema documented at the top)
  46. examples/demo-output/ fictional example of all 5 outputs
  47. ```
  48. ## Contributing
  49. 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.
  50. ## Disclaimer
  51. 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.
  52. ## License
  53. [MIT](LICENSE)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.