کمانڈ لائن سے اشتہارات چلائیں: Hermoso CLI

اشتہاری ٹولنگ تقریباً مکمل طور پر ڈیش بورڈز پر مبنی ہے، اس لیے یہ تقریباً مکمل طور پر خودکار نہیں ہو سکتی۔ آپ ڈیش بورڈ کا کرون جاب نہیں چلا سکتے، ڈیش بورڈ کو jq میں پائپ نہیں کر سکتے، اور ٹرمینل ایجنٹ سے اس پر کلک نہیں کروا سکتے۔ Hermoso CLI اس لیے ہے کہ اشتہاری لوپ ایسی جگہ نہ رہے جہاں آپ جاتے ہیں، بلکہ ایسی چیز بن جائے جسے آپ اسکرپٹ کر سکیں۔

انسٹال اور سائن ان:

npm install -g hermoso
hermoso auth login

auth login ایک loopback listener شروع کرتا ہے اور براؤزر کھولتا ہے، وہی طریقہ جو gh اور firebase استعمال کرتے ہیں، تو کچھ پیسٹ کرنے کی ضرورت نہیں۔ بنی ہوئی کلید ~/.hermoso/config.json میں صرف مالک کی اجازت کے ساتھ لکھی جاتی ہے (ڈائریکٹری 0700، فائل 0600)، کیونکہ اس کے پاس حقیقی خرچ کا اختیار ہے۔ CI کے لیے hermoso auth login --token <key> ایک غیر تعاملی طور پر محفوظ کرتا ہے، اور HERMOSO_TOKEN / HERMOSO_API_BASE ماحول سے config کو اوور رائیڈ کرتے ہیں۔

کمانڈز

ہر کمانڈ --json لیتی ہے، اور یہی اصل نکتہ ہے: انسانی پڑھنے والی لائن محض سہولت ہے، JSON معاہدہ ہے۔

کمانڈ	کیا کرتی ہے
`hermoso capabilities`	درست ماڈل IDs اور ان کی درست کریڈٹ لاگت۔ پہلے یہ چلائیں۔ یہ مفت اور صرف پڑھنے والی ہے، اور یہی وہ چیز ہے جو ماڈل کے نام اندازے سے لکھنا بند کرتی ہے۔
`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`	ایک بریف کو تیار اشتہاری تصور میں بدلتا ہے: کاپی ویرینٹس کے ساتھ ایک تصویری تصور یا ویڈیو اسٹوری بورڈ، اور وہ ماڈل IDs جن سے اسے رینڈر کیا جا سکے۔
`hermoso generate image --prompt "…" --ref ./bottle.png`	رینڈر کرتا ہے اور ایک سرو کیا ہوا URL واپس دیتا ہے۔ `--ref` آپ کی اصل پروڈکٹ کو کمپوز کرتا ہے تاکہ اسکرین پر لیبل آپ کا اصل SKU ہو۔
`hermoso jobs` / `hermoso fetch <url>`	چلتے ہوئے رینڈرز دیکھیں؛ کسی بھی اثاثے کو کلک ہونے والے اور براہ راست ڈاؤن لوڈ URL میں حل کریں۔
`hermoso mcp`	پورا 922+ ٹول MCP سطح stdio پر چلاتا ہے، وہی ٹولز جو ہوسٹڈ سرور دکھاتا ہے۔

دو سطحیں، ایک پیکج، اور یہ کیوں اہم ہے

ٹرمینل ایجنٹس ٹولز کی قیمت دو بار ادا کرتے ہیں: ایک بار اس مینی فیسٹ میں جو وہ سیاق و سباق میں رکھتے ہیں، اور ایک بار ہر کال کے ٹوکنز میں۔ 922+ ٹولز کا مینی فیسٹ مفت نہیں۔ اس لیے وہی پیکج دونوں سطحیں فراہم کرتا ہے اور ایجنٹ کو انتخاب دیتا ہے:

MCP (hermoso mcp، یا ہوسٹڈ https://app.hermoso.ai/mcp) جب آپ مکمل سطح اور بھرپور ٹائپ شدہ آرگیومنٹس چاہیں۔
سب پروسیس کمانڈز جب آپ ٹوکن کے لحاظ سے سستا راستہ چاہیں: ایجنٹ شیل کرتا ہے، JSON پڑھتا ہے، اور مینی فیسٹ کبھی لوڈ نہیں کرتا۔ یہی وہ طریقہ ہے جو ساتھ آنے والی Claude اسکلز استعمال کرتی ہیں۔

دونوں ایک ہی API کو کال کرتے ہیں، ایک ہی کریڈٹس خرچ کرتے ہیں اور ایک ہی لائبریری میں لکھتے ہیں، تو کچھ بھی ایک طرف پھنسا نہیں رہتا۔

اسکرپٹ کے قابل چیزیں

ہفتہ وار مدمقابل سروے۔ hermoso competitors کو hermoso ads میں ڈالیں، پچھلے ہفتے سے موازنہ کریں، اور آپ کے پاس اس بات کی مستقل رپورٹ ہے کہ آپ کی مارکیٹ نے کیا شروع اور کیا بند کیا۔
کیٹلاگ کے لیے بیچ تخلیق۔ SKUs پر لوپ کریں، ہر پروڈکٹ کے لیے ایک گراؤنڈڈ اشتہار رینڈر کریں، اور واپس آنے والے URLs جمع کریں۔ یہ وہ کام ہے جو 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 چلا کر، ہوسٹڈ اینڈ پوائنٹ سے، یا ویب اسٹوڈیو سے پہنچا جا سکتا ہے۔ اشاعت کے اہداف 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 آؤٹ پٹ کے ساتھ۔ یہی پیکج 922+ ٹولز والا مکمل MCP سرور 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 ماحول سے config کو اوور رائیڈ کرتے ہیں۔

کیا آؤٹ پٹ کو jq میں پائپ کر سکتا ہوں؟

ہاں۔ ہر کمانڈ --json لیتی ہے اور ایک ساختی آبجیکٹ پرنٹ کرتی ہے۔ یہی مطلوبہ معاہدہ ہے؛ انسانی لائن محض سہولت ہے۔ hermoso credits --json | jq .balance لمبے رینڈر بیچ سے پہلے ایک مفید CI گارڈ ہے۔

MCP سرور کے بجائے CLI کیوں استعمال کریں؟

ٹوکن کی لاگت۔ 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 پر اشاعت، شیڈولنگ اور مہم کا انتظام CLI سب کمانڈز کے بجائے MCP سطح میں ہے، جو اسی پیکج سے hermoso mcp چلا کر، ہوسٹڈ اینڈ پوائنٹ https://app.hermoso.ai/mcp سے، یا ویب اسٹوڈیو سے قابل رسائی ہے۔ اشاعت کے اہداف Facebook، Instagram، Threads، TikTok، YouTube، X، LinkedIn، Pinterest، Bluesky، Telegram اور Google Business Profile ہیں۔

کیا یہ مقامی سرور کے خلاف کام کرتا ہے؟

ہاں۔ HERMOSO_API_BASE کو اپنے origin پر سیٹ کریں (مثلاً http://localhost:3000) تو CLI اور MCP سرور دونوں اسی کو ہدف بناتے ہیں۔ مقامی base کو auth ٹوکن کی ضرورت نہیں۔

کمانڈ لائن سے اشتہارات چلائیں