‏پلاگین Spotify Ads برای Claude: کمپین تبلیغاتی با یه جمله فارسی!

اسپاتیفای یه پلاگین برای Claude Code ساخته به اسم spotify-ads-api که هدفش اینه فاصله بین «چی می‌خوام» و «چطور باید با API کار کنم» رو پر کنه. API تبلیغاتی اسپاتیفای بیش از ۳۰ نوع منبع داره، با ساختارهای تودرتو — کمپین شامل ad set، و ad set شامل ad می‌شه. یه نفر که فقط می‌خواد یه کمپین صوتی راه بندازه، باید از یه کوه پیچیدگی رد بشه. این پلاگین اون مسیر رو حذف می‌کنه.

وقتی کاربر می‌نویسه «یه کمپین صوتی با نام Back to School برای گروه سنی ۲۵ تا ۴۴ در آمریکا با بودجه روزانه ۱۰۰ دلار بساز»، سیستم خودش این درخواست رو به چند فراخوان API موازی و ترتیبی تبدیل می‌کنه: جستجوی ID مناطق جغرافیایی، تبدیل دلار به micro-amount (واحد داخلی API)، اعتبارسنجی سایز مخاطب، و در نهایت ساخت سه موجودیت campaign، ad set و ad به ترتیب صحیح.

یکی از جالب‌ترین انتخاب‌های معماری اینه که همه چیز Markdown‌ه. این پلاگین هیچ کد کامپایل‌شده‌ای نداره؛ نه build step، نه package manager، نه bundler. مهارت‌ها (Skills)، عامل‌ها (Agents) و مستندات مرجع همه فایل .md هستن. وقتی یه باگ یا رفتار جدید API پیدا می‌شه، معمولاً یه جمله به یه فایل Markdown اضافه می‌کنن و مشکل حل می‌شه.

تیم اسپاتیفای تصمیم گرفت از MCP (Model Context Protocol) استفاده نکنه. دلیلش اینه که API خیلی بزرگه و تعریف استاتیک همه endpoint‌ها به‌عنوان ابزار MCP، context window رو می‌بلعه. در عوض، از OpenAPI Spec به‌عنوان منبع اصلی استفاده می‌کنن — همون فایل ۸۶۰۰ خطی که خود اسپاتیفای منتشر کرده. Agent فقط بخشی از این spec رو که لازم داره بارگذاری می‌کنه.

یه مزیت مهم دیگه اینه که همه فراخوان‌های API به‌شکل دستورات curl نشون داده می‌شن. کاربر می‌تونه دقیقاً ببینه چه چیزی داره ارسال می‌شه، دستور رو کپی کنه، تغییر بده، یا مستقل اجرا کنش. این شفافیت توی یه سیستم تبلیغاتی که هر درخواست می‌تونه روی بودجه واقعی تأثیر بذاره، خیلی مهمه.

یه ویژگی هوشمند دیگه استفاده از OpenAPI Links هست — بخشی نسبتاً کم‌استفاده از استاندارد OpenAPI 3.x که رابطه بین operation‌ها رو تعریف می‌کنه. مثلاً response ساخت campaign لینک به ساخت ad set داره، و ad set به ساخت ad. این ساختار به agent کمک می‌کنه بفهمه بعد از هر قدم، قدم بعدی چیه و ID‌ها رو چطور بین مراحل منتقل کنه.

نکات کلیدی:

• پلاگین متن‌باز روی GitHub و در مارکت‌پلیس Claude Plugins قابل دسترسه
• معماری کاملاً مبتنی بر Markdown — بدون کامپایل، بدون build step
• به جای MCP، از OpenAPI Spec و curl استفاده می‌کنه تا شفافیت و قابلیت دیباگ حفظ بشه
• Agent خودش تبدیل واحدها، جستجوی geo-targeting و اعتبارسنجی مخاطب رو مدیریت می‌کنه
• کاربر می‌تونه بین اجرای خودکار و تأیید دستی (auto_execute) انتخاب کنه