تشغيل الإعلانات من سطر الأوامر: واجهة Hermoso CLI

أدوات الإعلان مبنية في معظمها من لوحات تحكم، وهذا يجعلها شبه غير قابلة للأتمتة. لا يمكنك جدولة لوحة تحكم بـ cron، ولا تمرير لوحة تحكم إلى jq، ولا أن تطلب من وكيل طرفية أن ينقر عليها. وُجدت واجهة Hermoso CLI حتى تتوقف حلقة الإعلان عن كونها مكانًا تزوره، وتصبح شيئًا يمكن برمجته.

التثبيت وتسجيل الدخول:

npm install -g hermoso
hermoso auth login

auth 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`	يحوّل الموجز إلى مفهوم إعلاني منتهٍ: نسخ بديلة مع مفهوم صورة أو قصة فيديو، ومعرّفات النماذج لإنتاجه.
`hermoso generate image --prompt "…" --ref ./bottle.png`	ينتج صورة ويعيد رابطًا مخدومًا. `--ref` يركّب منتجك الحقيقي، فتكون الملصقة على الشاشة هي وحدة حفظ المخزون (SKU) الفعلية لديك.
`hermoso jobs` / `hermoso fetch <url>`	فحص الإنتاجات الجارية، وتحويل أي أصل إلى رابط قابل للنقر ورابط تنزيل مباشر.
`hermoso mcp`	يشغّل سطح MCP الكامل بـ 922+ أداة عبر stdio، وهي الأدوات نفسها التي يعرضها الخادم المستضاف.

سطحان، حزمة واحدة، ولماذا يهم ذلك

وكلاء الطرفية يدفعون ثمن الأدوات مرتين: مرة في القائمة التي يحملونها في السياق، ومرة في الرموز التي تكلفها كل استدعاء. قائمة من 922+ أداة ليست مجانية. لذلك تشحن الحزمة السطحين معًا وتترك الوكيل يختار:

MCP (hermoso mcp، أو المضيف https://app.hermoso.ai/mcp) حين تريد السطح الكامل ومعاملات مكتوبة غنية.
أوامر فرعية عبر الصدفة حين تريد المسار الأرخص من حيث الرموز: يشغّل الوكيل الأمر، ويقرأ JSON، ولا يحمّل قائمة أدوات أصلًا. هذا هو النمط الذي تستخدمه المهارات المرفقة لـ Claude.

كلاهما يستدعي الواجهة البرمجية نفسها، ويحسب الأرصدة نفسها، ويكتب في المكتبة نفسها، فلا شيء يضيع على أحد الجانبين.

أشياء تستحق البرمجة

مسح أسبوعي للمنافسين. hermoso competitors ثم hermoso ads، وقارن بالأسبوع الماضي، فيصبح لديك تقرير دائم عما بدأ سوقك بعرضه وما توقف عنه.
إبداع بالجملة لكتالوج. كرّر على كل SKU، وأنتج إعلانًا مبنيًا على كل منتج، واجمع الروابط المعادة. هذا عمل مرهق فعلًا في الواجهة.
حارس رصيد في 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، أو من النقطة المستضافة، أو من الاستوديو على الويب. وجهات النشر هي 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 يثبّت واجهة Hermoso CLI، التي تبحث عن إعلانات المنافسين عبر مكتبات Meta وGoogle وLinkedIn، وتصوغ ملف هوية تجارية من موقع، وتخطط لإعلانات صور وفيديو منتهية وتنتجها، وتعرض الأرصدة والمهام، مع مخرجات --json في كل أمر للبرمجة. الحزمة نفسها تشغّل أيضًا خادم MCP الكامل بـ 922+ أداة عبر stdio.

كيف أصادق على واجهة Hermoso 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 لا يحمل أي قائمة أصلًا. السطحان يستدعيان الواجهة البرمجية نفسها، ويحسبان الأرصدة نفسها، ويكتبان في المكتبة نفسها، فيمكنك المزج بينهما.

هل تستطيع 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، أو من النقطة المستضافة على 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 معًا. العنوان المحلي لا يحتاج إلى رمز مصادقة.

تشغيل الإعلانات من سطر الأوامر