meta-ads — a Claude skill for running Meta (Facebook/Instagram) ads

Launch and manage real Meta ad campaigns by talking to Claude — through Meta's official Ads MCP server (mcp.facebook.com/ads). No developer app, no token wrangling, no Ads Manager spelunking. Born from a real production launch in Tbilisi 🇬🇪 and battle-tested against every wall Meta put up along the way.

ქართული ვერსია ქვემოთ ⬇

What it gives Claude

• The verified tool contracts of the Ads MCP (they differ from the Graph API in call-breaking ways — parameter names, JSON-string params, field lists)
• An end-to-end launch playbook: account checks → campaign → ad set → creatives → ads → previews → activation, with the two mandatory user-confirmation pauses
• Georgia-ready recipes: Tbilisi radius targeting without city-key lookups, country targeting, Georgian-language ad copy, currency/cents traps
• A troubleshooting playbook for the real errors: socket drops, INTERNAL create failures, dev-mode walls, "prohibited from advertising" appeals, token-permission dead ends

Install

1. The skill — copy this folder into your Claude Code skills directory:

   copy

   git clone https://github.com/sepivip/meta-ads-skill ~/.claude/skills/meta-ads
   

   (Windows: git clone https://github.com/sepivip/meta-ads-skill "$env:USERPROFILE\.claude\skills\meta-ads")

2. The MCP server — register and authenticate (one time, interactive):

   copy

   claude mcp add --transport http meta-ads https://mcp.facebook.com/ads
   

   Then in Claude Code type /mcp, pick meta-ads, and log in with the Facebook account that administers your business.

3. Ask Claude to launch a campaign. It will build everything paused, show you previews, and activate only when you say go.

Safety model

• Everything is created PAUSED; nothing spends until you explicitly approve activation.
• Prefer lifetime budgets for tests — a structural spend cap, not a promise.
• Claude checks your account has a payment method and MCP access before building anything.

Requirements

• Claude Code (or any MCP-capable agent) · a Facebook Page · a Meta ad account with a payment method · admin access to the business portfolio

---

ქართულად

ეს არის Claude-ის სკილი Meta-ს (Facebook/Instagram) რეკლამების სამართავად — Meta-ს ოფიციალური Ads MCP სერვერით (mcp.facebook.com/ads). არ გჭირდება დეველოპერული აპლიკაცია, ტოკენების გენერაცია ან Ads Manager-ში ხეტიალი: კამპანიას Claude-თან საუბრით უშვებ.

შექმნილია თბილისში რეალური კამპანიის გაშვების გამოცდილებაზე — ყველა კედელი, რომელსაც Meta ახალ რეკლამდამკვეთს უღობავს (ბიზნესის შეზღუდვის მოხსნა, ნებართვები, dev-mode-ის შეცდომები), აქ უკვე გავლილი და დოკუმენტირებულია.

რას შეძლებ:

• კამპანიის სრული გაშვება: ბიუჯეტი, თბილისის (ან მთელი საქართველოს) თარგეთინგი, ქართულენოვანი კრეატივები, გააქტიურება — ყველაფერი Claude-ის საშუალებით
• შედეგების მონიტორინგი: რომელი კრეატივი მუშაობს, CTR, კლიკის ფასი, დახარჯული თანხა
• პრობლემების მოგვარება: „prohibited from advertising", „development mode", გადახდის მეთოდი და სხვა ტიპური კედლები

უსაფრთხოება: ყველაფერი იქმნება გაჩერებულ (PAUSED) მდგომარეობაში — თანხა არ იხარჯება, სანამ თავად არ დაადასტურებ გაშვებას. სატესტო კამპანიებზე გამოიყენე lifetime ბიუჯეტი — ის ხარჯვის სტრუქტურული ჭერია.

ინსტალაცია: იხილე ინგლისური ინსტრუქცია ზემოთ (Install) — ორი ნაბიჯია: სკილის დაკოპირება და MCP სერვერის დამატება /mcp ავტორიზაციით.

---

MIT License. Built with Claude Code. PRs welcome — especially more Georgian targeting recipes and error signatures.