मैंने एक Claude स्किल बनाई जो मेरे Facebook विज्ञापन चलाती है — यहाँ है कोड

विषय-सूची

जून 2026 में अपडेट।

TL;DR: मैंने एक Claude स्किल बनाई जो Graph API के माध्यम से मेरे Meta Ads अकाउंट को पढ़ती है, कम प्रदर्शन वाले विज्ञापनों की पहचान करती है, मेरी ब्रांड वॉयस में विज्ञापन कॉपी फिर से लिखती है, और बिना Ads Manager को छुए नए विज्ञापन सेट बनाती है। पूरी चीज़ 300 लाइनों से कम TypeScript में है। ROI तुरंत आया: मैंने साप्ताहिक विज्ञापन प्रबंधन का समय ~3 घंटे से घटाकर लगभग 20 मिनट कर दिया।

[ऑपरेटर की नज़र] मैं Pickleland और अपने कंसल्टिंग ब्रांड के लिए विज्ञापन चलाता हूँ। दो अकाउंट, अलग-अलग ऑडियंस, लगातार क्रिएटिव थकान। मैं रविवार की दोपहरें Ads Manager में ऐसी चीजें करते हुए बिता रहा था जो एक मॉडल को करनी चाहिए। तो मैंने इसे ऑटोमेट कर दिया।

मैंने Facebook विज्ञापन मैन्युअली प्रबंधित करना क्यों बंद किया

Facebook विज्ञापन चलाने का असली काम तीन हिस्सों में बंटता है:

1. मॉनिटरिंग — यह जाँचना कि कौन से विज्ञापन सेट पैसे जला रहे हैं बनाम कमा रहे हैं
2. डायग्नोसिस — यह पता लगाना कि क्यों कुछ कम प्रदर्शन कर रहा है (क्रिएटिव थकान? खराब टार्गेटिंग? लैंडिंग पेज?)
3. इटरेशन — नई कॉपी लिखना, नए विज्ञापन सेट बनाना, बजट एडजस्ट करना

काम 1 यांत्रिक है। काम 3 ज्यादातर यांत्रिक है (वॉयस की सीमा के साथ)। काम 2 को निर्णय की जरूरत है — और यह एकमात्र ऐसा है जिसमें लूप में इंसान का होना फायदेमंद है।

एक Claude स्किल 1 और 3 कर सकती है। मैं काम 2 के आउटपुट की समीक्षा करता हूँ इससे पहले कि कुछ भी पब्लिश हो। यही वह आर्किटेक्चर है जिस पर मैं टिका।

Meta Graph API सेटअप (यह परेशान करने वाला हिस्सा है)

किसी भी कोड से पहले: आपको Meta Business अकाउंट, एक सिस्टम यूज़र और एक स्थायी एक्सेस टोकन चाहिए। Facebook का डेव पोर्टल असुविधाजनक है लेकिन रास्ता यह है:

1. developers.facebook.com पर Meta App बनाएँ (प्रकार: Business)
2. Marketing API प्रोडक्ट जोड़ें
3. अपने Business Portfolio → Settings → Users → System Users में, एक सिस्टम यूज़र बनाएँ और उसे अपने विज्ञापन अकाउंट पर ADVERTISER रोल दें
4. इन परमिशन के साथ टोकन जनरेट करें: ads_read, ads_management, business_management

टोकन को META_ACCESS_TOKEN के रूप में और अपने विज्ञापन अकाउंट ID (फॉर्मेट: act_XXXXXXXX) को META_AD_ACCOUNT_ID के रूप में अपनी .env में सेव करें।

स्किल फ़ाइल संरचना

.claude/skills/fb-ads/
  SKILL.md          ← निर्देश जो Claude पढ़ता है
  index.ts          ← असली टूल इम्प्लीमेंटेशन
  types.ts          ← साझा टाइप्स

SKILL.md वह है जो Claude को बताता है कि स्किल का उपयोग कब और कैसे करना है। मेरी कहती है:

# Facebook Ads Manager Skill

Use this skill when the user says "check my ads", "run ads report",
"pause underperformers", or "write new ad copy". Never run this
without explicit user instruction — it touches live ad spend.

## What it can do
- Pull performance data for all active ad sets (last 7 or 30 days)
- Flag ad sets with ROAS < 1.5 or CTR < 0.8% as underperformers
- Rewrite ad copy for flagged creatives in Ale's voice
- Create new ad sets with revised copy (PAUSED by default — you approve before activating)

## What it will NOT do
- Change budgets on live ad sets without explicit confirmation
- Activate new ad sets automatically
- Delete anything

“कभी भी स्वचालित रूप से सक्रिय न करें” की बाधा गैर-परक्राम्य है। यह स्किल चीज़ें PAUSED स्थिति में बनाती है। मैं समीक्षा करता हूँ और मैन्युअली सक्रिय करता हूँ। लाइव विज्ञापन खर्च को छूने वाली किसी भी चीज़ को इंसानी चेकपॉइंट की जरूरत है।

मुख्य TypeScript कोड

(कोड ब्लॉक अंग्रेजी में रहते हैं — केवल आसपास का टेक्स्ट अनुवादित है।)

मैं इसे रोज़ाना कैसे उपयोग करता हूँ

स्किल Claude Code से इनवोक होती है (मेरा डेली टूल)। एक विशिष्ट सोमवार सुबह का सेशन:

> check my ads from the last 7 days

Claude runAdsReport(7) चलाता है, परिणामों को टेबल के रूप में फॉर्मेट करता है, कम प्रदर्शन वालों को फ्लैग करता है, और पूछता है कि क्या मैं रीराइट चाहता हूँ। मैं हाँ कहता हूँ। यह नई कॉपी जनरेट करता है, मुझे दोनों वर्शन साइड-बाय-साइड दिखाता है, और नए क्रिएटिव के साथ PAUSED विज्ञापन सेट बनाता है। मैं उन्हें Ads Manager में समीक्षा करता हूँ, जो मुझे पसंद हैं उन्हें एक्टिवेट करता हूँ, और हारे हुओं को आर्काइव करता हूँ।

कुल समय: 20 मिनट। Ads Manager में रविवार की दोपहरें: शून्य।

यह किसे रिप्लेस नहीं करती

स्किल मुझे यह नहीं बता सकती कि प्रोडक्ट-मार्केट फिट की समस्या कॉपी की समस्या के रूप में छुपी है या नहीं। अगर ROAS हर जगह खराब है, तो यह फनल या ऑफर की समस्या है, हेडलाइन की नहीं। Claude टूटे हुए फनल पर ईमानदारी से कॉपी रीराइट करेगा — और रीराइट्स इसे नहीं बचाएँगी।

डायग्नोसिस का चरण अभी भी मेरा है। मैं रिपोर्ट पढ़ता हूँ, फनल डेटा देखता हूँ, और तय करता हूँ कि क्या हम क्रिएटिव को इटरेट कर रहे हैं या ऊपरी स्तर पर कुछ हल कर रहे हैं। एजेंट उस निर्णय के अलावा सब कुछ में तेज़ है।

ऑपरेटर का निष्कर्ष

अगर आप मैन्युअली विज्ञापन प्रबंधित कर रहे हैं और हफ्ते में दो बार से ज़्यादा Ads Manager को छू रहे हैं, तो आप वे ऑपरेशन कर रहे हैं जो एक स्क्रिप्ट को करने चाहिए। Graph API अच्छी तरह से डॉक्युमेंटेड है और Meta परमिशन फ्लो, हालाँकि परेशान करने वाला है, एक बार का सेटअप है। एक दोपहर में स्किल बनाएँ। पुनः प्राप्त समय का फायदा पहले हफ्ते में दिखता है।