ابزارهای تبلیغاتی تقریباً همگی داشبورد هستند و به همین دلیل تقریباً غیرقابل خودکارسازی‌اند. نمی‌توانید یک داشبورد را زمانبندی کنید، نمی‌توانید خروجی داشبورد را به jq بفرستید، و نمی‌توانید از یک عامل ترمینالی بخواهید روی آن کلیک کند. CLI هرمسو وجود دارد تا حلقه تبلیغات از جایی که به آن سر می‌زنید، به چیزی تبدیل شود که بتوانید آن را اسکریپت کنید.
نصب و ورود:
npm install -g hermoso
hermoso auth loginauth login یک شنونده loopback راه می‌اندازد و مرورگر را باز میکند، همان الگویی که gh و firebase استفاده میکنند، پس چیزی برای چسباندن نیست. کلید ساخته‌شده در ~/.hermoso/config.json با مجوز فقط برای مالک نوشته می‌شود (پوشه 0700 و فایل 0600)، چون اختیار خرج واقعی را دارد. برای CI، hermoso auth login --token <key> یکی را بدون تعامل ذخیره میکند، و HERMOSO_TOKEN / HERMOSO_API_BASE تنظیمات فایل را از محیط بازنویسی میکنند.
فرمان‌ها
هر فرمان --json را میپذیرد، و دلیل اصلی همین است: خط خوانا برای راحتی است، و JSON همان قرارداد است.
| فرمان | کارش |
|---|---|
hermoso capabilities | شناسه‌های معتبر مدل و هزینه دقیق اعتبار هر کدام. اول این را اجرا کنید. رایگان و فقط‌خواندنی است، و راهی است که دیگر نام مدل حدس نزنید. |
hermoso credits | موجودی، مصرف جلسه و آخرین فراخوانی‌های دارای هزینه. |
hermoso brand --domain example.com | یک وبسایت را به پروفایل برند تبدیل میکند (محصولات، پالت، لوگو، لحن) که رندرهای بعدی بر پایه آن ساخته میشوند. |
hermoso competitors --domain example.com | رقبای مستقیم و برندهای مشابه‌ای را پیدا میکند که ارزش یادگیری دارند. |
hermoso ads --company "Brand" | تبلیغات واقعی در حال اجرای آن برند را از کتابخانههای Meta، Google و LinkedIn می‌آورد، بدون تکرار و مرتب‌شده. |
hermoso research "longest-running protein bar ads" | تحقیق تبلیغات با زبان طبیعی در کتابخانه‌ها به‌علاوه TikTok ارگانیک، و تبلیغاتی را که پیدا کرده برمی‌گرداند. |
hermoso create --brand … --product … --format video | یک بریف را به مفهوم تبلیغ کامل تبدیل میکند: متن‌های جایگزین به‌همراه یک مفهوم تصویری یا یک storyboard ویدیویی، با شناسه‌های مدل برای رندرش. |
hermoso generate image --prompt "…" --ref ./bottle.png | رندر میکند و یک URL سرو شده برمی‌گرداند. --ref محصول واقعی شما را ترکیب میکند تا برچسب روی صفحه همان SKU واقعی شما باشد. |
hermoso jobs / hermoso fetch <url> | رندرهای در حال اجرا را بررسی کنید؛ هر دارایی را به یک URL قابل کلیک و یک URL دانلود مستقیم تبدیل کنید. |
hermoso mcp | کل سطح MCP با 922+ ابزار را روی stdio سرو میکند، همان ابزارهایی که سرور هاستشده عرضه میکند. |
دو سطح، یک بسته، و چرا این مهم است
عامل‌های ترمینالی ابزارها را دو بار هزینه می‌دهند: یک بار در فهرستی که در زمینه حمل میکنند، و یک بار در توکن‌هایی که هر فراخوانی مصرف میکند. فهرست 922+ ابزار رایگان نیست. پس همین بسته هر دو سطح را عرضه میکند و اجازه میدهد عامل انتخاب کند:
- MCP (
hermoso mcp، یا سرور هاستشدهhttps://app.hermoso.ai/mcp) وقتی می‌خواهید سطح کامل و آرگومان‌های تایپ‌شده غنی داشته باشید. - دستورهای زیرفرایندی وقتی راه ارزان از نظر توکن را می‌خواهید: عامل دستور را اجرا میکند، JSON میخواند، و اصلاً فهرست ابزار بار نمیکند. الگویی که مهارت‌های Claude همراه بسته از آن استفاده میکنند همین است.
هر دو به همان API وصل میشوند، همان اعتبار را خرج میکنند و در همان کتابخانه مینویسند، پس چیزی در یک سمت گیر نمیکند.
کارهایی که ارزش اسکریپت‌کردن دارند
- یک مرور هفتگی رقبا.
hermoso competitorsرا بهhermoso adsبفرستید، با هفته قبل مقایسه کنید، و یک گزارش دائمی از اینکه بازار شما چه را شروع و چه را متوقف کرده دارید. - تولید دسته‌ای خلاقیت برای یک کاتالوگ. روی SKUها حلقه بزنید، برای هر محصول یک تبلیغ بر پایه واقعیت بسازید، و URLهای برگشتی را جمع کنید. این کاری است که در یک UI واقعاً خسته‌کننده است.
- محافظ اعتبار در CI.
hermoso credits --json | jq .balanceو شکست خط لوله قبل از شروع یک دسته بزرگ روی موجودی خالی. - انتخاب مدل آگاه از هزینه.
hermoso capabilities --jsonهزینه دقیق هر مدل را نشان میدهد، پس یک اسکریپت میتواند ارزان‌ترین مدلی را که بریف را برآورده میکند انتخاب کند، بهجای اینکه یک مدل را ثابت کند.
انتشار و کمپین‌ها
زیرفرمانهای CLI تحقیق و ساخت را پوشش می‌دهند. انتشار، زمانبندی و مدیریت کمپین در Meta، Google Ads، Microsoft Advertising، Reddit Ads، LinkedIn، Pinterest، X Ads، TikTok Ads، Snapchat Ads، ChatGPT Ads، Apple Search Ads و AppLovin Ads در سطح MCP قرار دارند و از همان بسته با hermoso mcp، از endpoint هاستشده، یا از استودیوی وب در دسترس‌اند. مقصدهای انتشار Facebook، Instagram، Threads، TikTok، YouTube، X، LinkedIn، Pinterest، Bluesky، Telegram و Google Business Profile هستند.
چه کاری را بدون پرسیدن انجام نمی‌دهد
عامل با بودجه فقط وقتی مفید است که دامنه آسیبش محدود باشد، پس محدودیت هزینه در سرور اعمال می‌شود نه در یک پرامپت. کمپین‌ها، گروه‌های آگهی و تبلیغات Meta همیشه PAUSED ساخته میشوند و هیچ فراخواننده‌ای نمی‌تواند این را عوض کند. کلیدهای وضعیتی که می‌توانند هزینه تبلیغات واقعی را فعال کنند (یکی برای هر پلتفرم تبلیغاتی، از جمله set_meta_campaign_status، set_google_ads_status، set_microsoft_ads_status، set_reddit_ads_status، set_linkedin_ads_status، set_pinterest_ads_status، set_x_ads_status و set_openai_ads_status) همگی بدون یک پرچم تأیید صریح اجرا نمی‌شوند. همین گیت شامل ساخت یک گروه آگهی، آگهی یا کلمه کلیدی فعال Google Ads زیر یک والد از قبل فعال هم می‌شود، چون آن در حراج بعدی نمایش داده می‌شود. حذف‌ها هم نیاز به تأیید دارند. در سمت تولید، hermoso_capabilities هزینه دقیق اعتبار هر مدل را پیش از اجرا نشان میدهد و هر رندر ابتدا برآوردی را رزرو میکند و سپس هزینه واقعی را تسویه میکند، پس اگر ارسال شکست بخورد، اعتبار برمی‌گردد.
اگر داخل یک عامل کار می‌کنید نه یک شِل، ببینید بازاریابی خودکار با Claude Code و مرجع کامل MCP و CLI را.
پرسش‌های متداول
آیا ابزار خط فرمانی برای اجرای تبلیغات وجود دارد؟
بله. npm install -g hermoso CLI هرمسو را نصب میکند که تبلیغات رقبا را در کتابخانههای Meta، Google و LinkedIn تحقیق میکند، از یک وبسایت یک پروفایل برند میسازد، تبلیغات تصویری و ویدیویی کامل را برنامهریزی و رندر میکند، و اعتبار و کارها را گزارش میدهد، با خروجی --json برای هر فرمان جهت اسکریپتنویسی. همین بسته سرور کامل MCP با 922+ ابزار را هم روی stdio اجرا میکند.
چطور CLI هرمسو را احراز هویت کنم؟
hermoso auth login را اجرا کنید. یک ورود مرورگری روی loopback باز میکند (همان الگوی gh و firebase) و کلید ساخته‌شده را در ~/.hermoso/config.json با مجوز فقط برای مالک ذخیره میکند (پوشه 0700 و فایل 0600). برای CI، hermoso auth login --token <key> یکی را بدون تعامل ذخیره میکند، و HERMOSO_TOKEN و HERMOSO_API_BASE تنظیمات فایل را از محیط بازنویسی میکنند.
آیا میتوانم خروجی را به jq بفرستم؟
بله. هر فرمان --json را میپذیرد و یک شیء ساختاریافته چاپ میکند. این قرارداد مورد نظر است؛ خط خوانا فقط برای راحتی است. hermoso credits --json | jq .balance یک محافظ مفید در CI قبل از یک دسته بزرگ رندر است.
چرا از CLI بهجای سرور MCP استفاده کنم؟
هزینه توکن. یک کلاینت MCP فهرست ابزار را در زمینه بار میکند، و 922+ ابزار رایگان نیستند. یک عامل ترمینالی که دستورهای زیرفرایندی را اجرا میکند و JSON میخواند هیچ فهرستی حمل نمیکند. هر دو سطح به یک API وصل میشوند، همان اعتبار را خرج میکنند و در یک کتابخانه مینویسند، پس میتوانید ترکیبشان کنید.
آیا CLI میتواند روی Facebook منتشر کند یا تبلیغات Meta را مدیریت کند؟
انتشار، زمانبندی و مدیریت کمپین در Meta، Google Ads، Microsoft Advertising، Reddit Ads، LinkedIn، Pinterest، X Ads، TikTok Ads، Snapchat Ads، ChatGPT Ads، Apple Search Ads و AppLovin Ads در سطح MCP است، نه زیرفرمانهای CLI. این سطح از همان بسته با اجرای hermoso mcp، از endpoint هاستشده در https://app.hermoso.ai/mcp، یا از استودیوی وب در دسترس است. مقصدهای انتشار Facebook، Instagram، Threads، TikTok، YouTube، X، LinkedIn، Pinterest، Bluesky، Telegram و Google Business Profile هستند.
آیا با یک سرور محلی کار میکند؟
بله. HERMOSO_API_BASE را روی مبدأ خودتان بگذارید (برای نمونه http://localhost:3000) و هم CLI و هم سرور MCP به آن وصل میشوند. یک پایه localhost به توکن احراز هویت نیاز ندارد.
مرتبط
رندرها به‌صورت کارهای سمت سرور اجرا میشوند که شما پیگیری‌شان می‌کنید، و یک پست دوباره‌ارسال‌شده حتی وقتی نتیجه تلاش اول معلوم نیست، امن است. جزئیات در کارها و idempotency آمده است.
می‌خواهید این را داخل Claude Code راه‌اندازی کنید؟ ببینید بازاریابی با Claude Code.
CLI را نصب کنید، از مرورگر خود وارد شوید، و اولین مرور رقبای شما یک دستور فاصله دارد. حساب رایگان، بیش از 250 اعتبار رایگان قابل‌کسب، بدون کارت.
رایگان شروع کنید → مستندات MCP را بخوانید →