بنيتُ مهارة Claude تُدير إعلاناتي على فيسبوك — وهذا هو الكود

جدول المحتويات

محدَّث يونيو 2026.

TL;DR: بنيتُ مهارة Claude تقرأ حساب Meta Ads الخاص بي عبر Graph API، وتُحدد الإعلانات ضعيفة الأداء، وتُعيد كتابة نصوص الإعلانات بأسلوب علامتي التجارية، وتنشئ مجموعات إعلانية جديدة دون أن أفتح مدير الإعلانات. المشروع بأكمله أقل من 300 سطر من TypeScript. كان العائد فورياً: خفّضتُ وقت إدارة الإعلانات الأسبوعي من نحو 3 ساعات إلى نحو 20 دقيقة.

[قراءة المشغّل] أُدير إعلانات لـ Pickleland ولعلامتي التجارية في الاستشارات. حسابان، جماهير مختلفة، إرهاق إبداعي مستمر. كنتُ أُمضي بعد ظهر الأحد في مدير الإعلانات أفعل أشياء ينبغي للنموذج أن يفعلها. فأتمتّها.

لماذا توقّفتُ عن إدارة إعلانات فيسبوك يدوياً

ينقسم العمل الفعلي في إدارة إعلانات فيسبوك إلى ثلاثة أعمال:

1. المراقبة — التحقق من أيّ مجموعات الإعلانات تحرق المال وأيّها تجنيه
2. التشخيص — معرفة لماذا يُقصّر شيء ما (إرهاق إبداعي؟ استهداف سيئ؟ صفحة الهبوط؟)
3. التكرار — كتابة نصوص جديدة، وإنشاء مجموعات إعلانية جديدة، وتعديل الميزانيات

العمل 1 آليّ. العمل 3 آليّ في معظمه (مع قيد صوتي). العمل 2 يتطلب حكماً — وهو الوحيد الذي يستفيد من وجود إنسان في الحلقة.

تستطيع مهارة Claude أداء 1 و3. أُراجع مخرجات العمل 2 قبل نشر أي شيء. هذا هو التصميم الذي توصّلتُ إليه.

إعداد Meta Graph API (هذا هو الجزء المزعج)

قبل أي كود: تحتاج حساب Meta Business، ومستخدم نظام، ورمز وصول دائم. بوابة المطوّرين في فيسبوك معادية لكن المسار هو:

1. إنشاء Meta App على developers.facebook.com (النوع: Business)
2. إضافة منتج Marketing API
3. في محفظة الأعمال ← الإعدادات ← المستخدمون ← مستخدمو النظام، أنشئ مستخدم نظام وامنحه دور ADVERTISER على حساب إعلاناتك
4. أنشئ رمزاً بهذه الأذونات: ads_read، ads_management، business_management

احفظ الرمز كـ META_ACCESS_TOKEN ومعرّف حساب إعلاناتك (الصيغة: 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 بالكريتيف الجديد. أُراجعها في مدير الإعلانات، وأُفعّل ما يُعجبني، وأُرشفة الخاسرين.

الوقت الإجمالي: 20 دقيقة. صفر من بعد ظهر الأحد في مدير الإعلانات.

ما لا تحلّ محلّه هذه المهارة

لا تستطيع المهارة أن تُخبرني إن كانت مشكلة ملاءمة المنتج للسوق تتنكّر كمشكلة نصوص. إذا كان ROAS سيئاً في كل مكان، فذلك مشكلة قمع أو عرض وليس مشكلة عنوان. سيُعيد Claude كتابة النصوص بأمانة على قمع معطوب — وإعادة الكتابة لن تُنقذه.

خطوة التشخيص لا تزال من مسؤوليتي. أقرأ التقرير، وأُطالع بيانات القمع، وأُقرر ما إذا كنا نكرّر الكريتيف أم نحلّ مشكلة في المنبع. العميل سريع في كل شيء إلا تلك الحكمة.

خلاصة المشغّل

إذا كنتَ تُدير الإعلانات يدوياً وتفتح مدير الإعلانات أكثر من مرتين في الأسبوع، فأنتَ تؤدي عمليات ينبغي للبرنامج النصي أن يفعلها. Graph API موثّقة بشكل جيد، وتدفق أذونات Meta، رغم إزعاجه، إعداد لمرة واحدة. ابنِ المهارة في فترة ما بعد الظهر. العائد في الوقت المُستعاد يظهر في الأسبوع الأول.