Hermoso یک سرور MCP بازاریابی است: بیش از 922 ابزار روی یک نقطه‌ی پایانی OAuth که به عامل اجازه می‌دهد تبلیغاتی را که هم‌اکنون در یک بازار جریان دارند تحقیق کند، تبلیغات تصویری و ویدیویی آماده بسازد، آن‌ها را منتشر کند، و کمپین‌های پولی پشت‌شان را بسازد. Codex از طریق یک اتصال به همهی آن دسترسی دارد. این صفحه یک برش از آن را پوشش می‌دهد: آنچه Codex واقعاً در Facebook میتواند انجام دهد، و آنچه Facebook اجازه نمی‌دهد.
اتصال Hermoso به Codex
- یک دستور، بدون کلید.
Codex فایل marketplace را در مخزن عمومی Hermoso می‌خواند و پنج مهارتش را نصب میکند (research، ad-from-brand، generate، product-photoshoot و marketing). این مهارت‌ها دستورcodex plugin marketplace add hermoso-ai/hermoso && codex plugin add hermoso@hermosohermosoرا از طریقnpxاجرا می‌کنند، پس فهرست ابزارها در نشست‌های شما بار نمی‌شود و تا وقتی دستوری اجرا نشود، چیزی از زمینه‌ی شما هزینه نمیکند. - یک بار وارد شوید.
مرورگر برای ورود باز می‌شود و یک اعتبارنامه‌ی فقط برای مالک را درnpx -y hermoso auth login~/.hermoso/config.jsonذخیره میکند. روی آن دستگاه مرورگر نیست، مثلاً CI یا کانتینر؟ یک کلید در MCP & CLI → Terminal & API keys بسازید وnpx -y hermoso auth login --token hmk_…را اجرا کنید. کلید اختیار خرج واقعی دارد، پس آن را مثل رمز عبور نگه دارید. - اختیاری: سرور MCP هم.
این سرور را درcodex mcp add hermoso -- npx -y hermoso mcp~/.codex/config.tomlمی‌نویسد و همان اعتبارنامه‌ی ذخیره‌شده را می‌خواند، پس کلیدی در فایل قرار نمی‌گیرد. نقطه‌ی پایانی میزبانی‌شده را ترجیح می‌دهید؟codex mcp add hermoso --url https://app.hermoso.ai/mcp، سپسcodex mcp login hermosoبرای ورود OAuth. مهارت‌ها بدون هیچ‌کدام به همهی ابزارها می‌رسند. - از Codex چیزی بخواهید. «سه رقیب نزدیکم را پیدا کن، طولانی‌ترین تبلیغاتشان را بیاور و بهترین قلاب را به یک ویدیوی 9:16 تبدیل کن»، یا «این رندر را در کانال پست کن». عامل ابزارها را انتخاب میکند؛ هزینه را شما تأیید می‌کنید.
Codex سرورهای MCP را در ~/.codex/config.toml یا .codex/config.toml در پروژه‌ی مورد اعتماد نگه می‌دارد، و آن فایل TOML است نه JSON: یک بلوک کپی‌شده‌ی mcpServers بارگذاری نمی‌شود، و ورودی دستی به شکل [mcp_servers.hermoso] با command = "npx" و args = ["-y", "hermoso", "mcp"] است. کلمه‌ی mcp در انتها حیاتی است: npx -y hermoso بدون زیردستور، راهنما را چاپ میکند و خارج می‌شود. Codex مخازن پلاگین را با ساختار .claude-plugin که Claude Code استفاده میکند می‌خواند، و به همین دلیل یک مخزن در هر دو نصب می‌شود.
سپس خود Facebook را یک بار زیر Settings → Connectors در Hermoso وصل کنید. این یک صفحه‌ی رضایت OAuth است، پس تنها قدمی است که به مرورگر نیاز دارد. هر چیز بعد از آن یک فراخوانی ابزار است.
ابزارهای Facebook که Codex دریافت میکند
post_to_meta: متن، یک عکس، یک ویدیو یا پست چندعکسی را در صفحه منتشر میکند، وpageIdرا می‌گیرد تا هرگز مجبور نباشد حدس بزند کدام صفحه.schedule_post: همان پست را برای زمانی که انتخاب می‌کنید صف میکند، روی یک تقویم مشترک با همهی کانالهای دیگر.list_meta_pages: صفحه‌هایی را که حساب وصل کرده فهرست میکند، با شناسه‌هایشان.manage_meta_post: متن یک پست منتشرشده را ویرایش میکند، یا آن را حذف میکند.list_meta_comments / reply_to_meta_comment / moderate_meta_comment: نظرهای زیر یک پست را می‌خواند، به‌عنوان صفحه پاسخ می‌دهد، و آنچه نباید بماند را پنهان یا حذف میکند.meta_page_insights / meta_post_insights: دسترسی، نمایش‌ها و تعامل در سطح صفحه و برای هر پست.upload_meta_asset: یک رندر نهایی را در کتابخانه‌ی دارایی‌های حساب تبلیغاتی می‌گذارد.
Facebook تنها کانالی است که زمانبندی بومی از راه دور دارد. post_to_meta یک scheduleAt بین ده دقیقه تا سی روز بعد می‌گیرد و زمانبندی را به خود Meta می‌سپارد. Instagram و Threads در API Meta چنین چیزی ندارند، و فرستادن آن برای آن‌ها رد می‌شود، نه اینکه بیصدا همان لحظه منتشر شود.
محدودیت‌های Facebook که پیش از خودکارسازی باید بدانید
| متن | یک پست Facebook میتواند تا 63,206 کاراکتر باشد، که عملاً بیحد است. هنگام ساخت یا صفگذاری اعمال می‌شود، پس پستی که بیش از حد بلند است رد می‌شود در حالی که هنوز آنجا هستید تا آن را درست کنید، نه اینکه در مسیر خروج بیصدا کوتاه شود. |
|---|---|
| دیدنی بودن | عمومی یا پیشنویس. پیشنویس یک پست صفحه‌ی واقعاً منتشرنشده است، که برای بررسی مفید است: در Meta Business Suite وجود دارد و کسی بیرون از آن نمیتواند ببیند. گزینه‌ی فهرست‌نشده و خصوصی وجود ندارد: «یک پست صفحه‌ی Facebook یا منتشر می‌شود یا به‌عنوان پیشنویس منتشرنشده نگه داشته می‌شود». |
| کاروسل | 2 اسلاید و بیشتر، فقط عکس. Meta سقف مستندی برای attached_media منتشر نکرده که بتوانیم منبعش کنیم، پس Hermoso یکی نمی‌سازد و آن را به Facebook نسبت نمی‌دهد. تنها حد، حد ماست، یعنی 30 اسلاید، و رد شدن می‌گوید مال کیست: «Facebook سقف مستندی برای attached_media منتشر نمیکند، پس این حد مال ماست، نه مال آن‌ها.» ویدیو نمیتواند داخل کاروسل عکس Facebook بیاید؛ این لبه‌ی دیگری از API Meta است و Hermoso بهجای اینکه کلیپ را بیصدا حذف کند، رد میکند. |
| کدام حساب | pageId. وقتی یک برند بیش از یک صفحه وصل کند اهمیت پیدا میکند: مسیر انتشار با نام رد میکند و یکی را برای شما انتخاب نمیکند، و زمان‌بندی‌ای که نتواند این پاسخ را حمل کند، آن رد شدن را ساعت‌ها بعد به شکست تبدیل میکند، در حالی که کسی نگاه نمیکند. |
امتحانش در Codex
به زبان معمولی درخواست کنید. اینها جمله‌های ساده‌اند، نه DSL:
«غیرتعاملی: یک تبلیغ تصویری 1:1 از پروفایل برند رندر کن، آن را به‌عنوان پیشنویس منتشرنشده در صفحه پست کن، و شناسه‌ی پست را بهصورت JSON چاپ کن.»
این مسیر از find_competitors → search_meta_ads → plan_ad → render_ad → list_meta_pages → post_to_meta می‌گذرد. در حالت تعاملی Codex پیش از اجرا فراخوانی را نشان می‌دهد. در حالت غیرتعاملی کسی برای پرسیدن نیست، و این باید در طراحی هر مرحله‌ای که منتشر یا خرج میکند لحاظ شود.
Codex روی Facebook: بخش دردسرساز
صفحه را در پرامپت یا پیکربندی نام ببرید. با بیش از یک صفحه‌ی متصل، مسیر انتشار بهجای انتخاب یکی، با نام رد میکند، و این درست است. در یک اجرای بدون نظارت codex exec کسی برای پرسیدن نیست، پس آن رد شدن به یک کار ناموفق تبدیل می‌شود. یک بار با list_meta_pages آن را حل کنید و شناسه را ثابت کنید.
برای اجراهای بدون نظارت، CLI یعنی hermoso با --json را بهجای فهرست کامل ابزارها ترجیح دهید. این روش در زمینه بسیار ارزان‌تر است و نتیجه‌اش را راحت‌تر می‌شود بررسی کرد.
پیش از پست گذاشتن در Facebook تحقیق کنید
کتابخانه‌ی تبلیغات Meta غنی‌ترین بایگانی عمومی تبلیغات خلاق است، و search_meta_ads آن را بر اساس کلیدواژه یا بر اساس صفحه می‌خواند، و هم جایگاه‌های Facebook و هم Instagram را پوشش می‌دهد. pull_competitor_ads و competitor_teardown روی آن ساخته شده‌اند، و find_competitors مشخص میکند کدام‌ها را باید به آن‌ها اشاره کرد.
نیمه‌ی پولی
Facebook عمیق‌ترین سطح پولی‌ای است که Hermoso دارد. create_meta_campaign، create_meta_adset و create_meta_ad کل ساختار را با هدف‌گیری واقعی می‌سازند: جغرافیا تا شعاع یک شهر، علاقه‌مندی‌ها، رفتارها، مخاطبان سفارشی و مشابه، جایگاه‌ها، زمانبندی در ساعات روز، و سقف‌های پیشنهاد و هزینه. همه‌چیز متوقف و بدون هیچ لغو توسط فراخوان ساخته می‌شود، و خلاصه‌ای که عامل شما گزارش می‌دهد از خواندن دوباره‌ی آنچه Meta واقعاً ذخیره کرده ساخته می‌شود، نه از آنچه درخواست شده. پیش از اینکه بودجه‌ای متعهد شود، preview_meta_ad تبلیغ واقعی را برای هر جایگاه بهصورت لینکی که می‌توانید ببینید رندر میکند، و estimate_meta_reach می‌گوید هدف‌گیری واقعاً چه تعداد آدم را می‌رساند. یک هشدار که پول را نجات می‌دهد: مجموعه‌تبلیغی که بدون مکان ساخته شود، فقط به ایالات متحده پیش‌فرض می‌گیرد، و خواندن دوباره‌ی آن این را بلند و روشن می‌گوید.
کاری که Codex به‌تنهایی نمیتواند انجام دهد
عاملی با بودجه فقط وقتی مفید است که شعاع آسیبش محدود باشد، پس حصار در سرور است نه در یک پرامپت. هر کمپین تبلیغاتی، مجموعه‌ی تبلیغ، گروه تبلیغ و تبلیغ متوقف ساخته می‌شود، و تغییر وضعیتی که پول واقعی را فعال میکند بدون یک پرچم تأیید صریح اجرا نمی‌شود. هر رندر پیش از خرج شدن هر چیز قیمت داده می‌شود (hermoso_capabilities هزینه‌ی دقیق اعتبار هر مدل را پیش از هر خرجی منتشر میکند). اعتبارها پیش از اولین فراخوانی ارائه‌دهنده رزرو میشوند و بعد به هزینه‌ی دقیق تسویه میشوند، پس یک ارسال ناموفق بازپرداخت می‌شود نه اینکه بدون هیچ نتیجه‌ای از شما پول گرفته شود. حذف‌ها هم به تأیید نیاز دارند، و هر درخت کمپین پیش از اینکه عامل شما بگوید چه ساخته، از پلتفرم تبلیغات دوباره خوانده می‌شود.
یک قدم عمداً غیردستی نیست: وصل کردن حساب یک صفحه‌ی رضایت OAuth است، پس کانال را یک بار در مرورگر وصل می‌کنید. هر چیز بعد از آن یک فراخوانی ابزار است.
بقیه‌ی ماتریس
از Codex منتشر کنید در: Instagram · Threads · TikTok · YouTube · X · LinkedIn · Pinterest · Bluesky · Telegram. یا همهی کانال‌هایی را که Codex میتواند در آن‌ها منتشر کند ببینید.
پست در Facebook از: Claude · ChatGPT · Claude Code · Cursor · Cline · OpenClaw · Grok Bot · Hermes · Gemini CLI · Perplexity · Le Chat · Claude Cowork · Perplexity Computer · Paperclip · تبلیغات از خط فرمان
پرسش‌های متداول
آیا Codex میتواند در Facebook پست بگذارد؟
بله، با پلاگین Codex مربوط به Hermoso. codex plugin marketplace add hermoso-ai/hermoso && codex plugin add hermoso@hermoso را اجرا کنید، که مهارت‌های Hermoso را نصب میکند، سپس یک بار با npx -y hermoso auth login وارد شوید. ورود مرورگر را باز میکند و اعتبارنامه را خودش ذخیره میکند، پس کلیدی برای ساختن یا چسباندن نیست. برای سرور MCP هم codex mcp add hermoso -- npx -y hermoso mcp را اجرا کنید. آن‌وقت Codex به 922+ ابزار دسترسی دارد، از جمله ابزارهایی که در Facebook منتشر می‌کنند، و ابزارهایی که تبلیغات در حال اجرای بازارتان را بررسی می‌کنند و خود creative را از اول رندر می‌کنند.
چطور Facebook را به Codex وصل کنم؟
دو مرحله، هرکدام یک بار. codex plugin marketplace add hermoso-ai/hermoso && codex plugin add hermoso@hermoso را اجرا کنید، که مهارت‌های Hermoso را نصب میکند، سپس یک بار با npx -y hermoso auth login وارد شوید. ورود مرورگر را باز میکند و اعتبارنامه را خودش ذخیره میکند، پس کلیدی برای ساختن یا چسباندن نیست. برای سرور MCP هم codex mcp add hermoso -- npx -y hermoso mcp را اجرا کنید. سپس Facebook را داخل Hermoso زیر Settings → Connectors متصل کنید، که یک صفحه‌ی رضایت OAuth در مرورگر است. بعد از آن Codex مثل یک فراخوانی ابزار عادی در Facebook منتشر میکند.
سقف کپشن Facebook وقتی از Codex پست میگذارید چقدر است؟
یک پست Facebook میتواند تا 63,206 کاراکتر باشد، که عملاً بیحد است. Hermoso آن را هنگام ساخت یا صفگذاری پست اعمال میکند، تا Codex فوراً خبردار شود، نه اینکه بعداً که کسی نگاه نمیکند شکست بخورد.
آیا Codex میتواند یک پست Facebook را برای بعد زمانبندی کند؟
بله. schedule_post آن را روی یک تقویم مشترک با همهی کانالهای دیگر صف میکند، با کپشن مخصوص هر کانال اگر متن باید متفاوت باشد؛ list_scheduled و cancel_scheduled آن را میخوانند و پس میگیرند. Facebook یکی از یازده کانالی است که صف میشوند.
آیا Codex میتواند بهصورت خصوصی یا پیشنویس در Facebook پست بگذارد؟
بله. Facebook تنها کانالی است که پیشنویس واقعی دارد: یک پست منتشرنشدهی صفحه که در Meta Business Suite وجود دارد و کسی بیرون از آن نمیتواند ببیند. Hermoso دیدنیبودنی را که Facebook در همان لحظهی درخواست نمیتواند رعایت کند رد میکند، بهجای اینکه بیصدا چیزی ضعیفتر منتشر کند.
پست گذاشتن در Facebook از Codex چه هزینه‌ای دارد؟
انتشار در Facebook هیچ اعتباری هزینه ندارد، چون Meta برای هر فراخوانی API چیزی نمی‌گیرد. اعتبارها صرف تولید میشوند: رندر عکس یا ویدیویی که پست همراهش است. پلن‌ها $29، $69 و $149 در ماه هستند برای 1,200، 3,000 و 7,000 اعتبار، و همهی امکانات در همهی پلن‌ها هست، از جمله Free. تنها استثنا SSO سازمانی است.
با ثبت‌نام، رایگان با 30 اعتبار شروع کنید و با کسب بیشتر به 250+ اعتبار دیگر برسید. همهی امکانات در همهی پلن‌ها هست.
رایگان شروع کنید → مشاهده قیمت‌ها