कमांड लाइन से ऐड चलाएं: Hermoso CLI

ऐड के टूल लगभग पूरी तरह डैशबोर्ड हैं, और इसलिए लगभग पूरी तरह स्वचालित नहीं हो सकते। आप डैशबोर्ड को cron पर नहीं चला सकते, डैशबोर्ड को jq में पाइप नहीं कर सकते, और टर्मिनल एजेंट से उस पर क्लिक नहीं करवा सकते। Hermoso CLI इसलिए है ताकि ऐड का चक्र ऐसी जगह न रहे जहां आप जाते हैं, बल्कि ऐसी चीज़ बन जाए जिसे आप स्क्रिप्ट कर सकें।

इंस्टॉल कीजिए और साइन इन कीजिए:

npm install -g hermoso
hermoso auth login

auth login एक loopback listener चालू करता है और ब्राउज़र खोलता है, वही पैटर्न जो gh और firebase इस्तेमाल करते हैं, इसलिए कुछ भी चिपकाना नहीं पड़ता। बनी हुई key ~/.hermoso/config.json में केवल-मालिक अनुमतियों (डायरेक्टरी 0700, फ़ाइल 0600) के साथ लिखी जाती है, क्योंकि उसमें असली खर्च का अधिकार है। CI के लिए, hermoso auth login --token <key> बिना इंटरैक्टिव प्रॉम्प्ट के एक key सेव करता है, और HERMOSO_TOKEN / HERMOSO_API_BASE environment से config को बदल देते हैं।

कमांड

हर कमांड --json लेता है, और यही असली बात है: मनुष्य के लिए पढ़ने योग्य पंक्ति सुविधा है, JSON ही अनुबंध (contract) है।

कमांड	क्या करता है
`hermoso capabilities`	मान्य मॉडल ID और उनकी सटीक क्रेडिट लागत। इसे पहले चलाइए। यह मुफ़्त और केवल-पढ़ने वाला है, और इसी से आप मॉडल के नाम अंदाज़े से लगाना बंद करते हैं।
`hermoso credits`	बैलेंस, इस session का उपयोग और हाल की शुल्क वाली कॉल।
`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`	एक brief को तैयार ऐड कॉन्सेप्ट में बदलता है: कॉपी के वेरिएंट और एक इमेज कॉन्सेप्ट या वीडियो स्टोरीबोर्ड, साथ में उसे रेंडर करने के लिए मॉडल ID।
`hermoso generate image --prompt "…" --ref ./bottle.png`	रेंडर करता है और एक सर्व किया गया URL लौटाता है। `--ref` आपका असली प्रोडक्ट कंपोज़ करता है, ताकि स्क्रीन पर दिखने वाला लेबल आपका असली SKU हो।
`hermoso jobs` / `hermoso fetch <url>`	चल रहे रेंडर देखिए; किसी भी asset को क्लिक करने योग्य और सीधे डाउनलोड होने वाले URL में बदलिए।
`hermoso mcp`	stdio पर पूरी 922+ टूल वाली MCP सतह चलाता है, वही टूल जो होस्टेड सर्वर देता है।

दो सतहें, एक पैकेज, और यह क्यों मायने रखता है

टर्मिनल एजेंट टूल की कीमत दो बार चुकाते हैं: एक बार उस मैनिफ़ेस्ट में जो वे context में ढोते हैं, और एक बार हर कॉल की टोकन लागत में। 922+ टूल का मैनिफ़ेस्ट मुफ़्त नहीं है। इसलिए वही पैकेज दोनों सतहें देता है और एजेंट को चुनने देता है:

MCP (hermoso mcp, या होस्टेड https://app.hermoso.ai/mcp) जब आपको पूरी सतह और समृद्ध टाइप किए गए arguments चाहिए।
Subprocess कमांड जब आपको टोकन-सस्ता रास्ता चाहिए: एजेंट shell चलाता है, JSON पढ़ता है, और कोई मैनिफ़ेस्ट लोड ही नहीं करता। बंडल्ड Claude skills यही पैटर्न इस्तेमाल करती हैं।

दोनों एक ही API को छूते हैं, एक ही क्रेडिट खर्च करते हैं और एक ही लाइब्रेरी में लिखते हैं, इसलिए एक तरफ़ कुछ भी अटका नहीं रहता।

स्क्रिप्ट करने लायक चीज़ें

साप्ताहिक प्रतिस्पर्धी स्वीप। hermoso competitors को hermoso ads में डालिए, पिछले हफ़्ते से तुलना कीजिए, और आपके पास यह जानने की स्थायी रिपोर्ट होगी कि आपके बाज़ार ने क्या चलाना शुरू और बंद किया।
कैटलॉग के लिए बैच क्रिएटिव। SKU पर लूप चलाइए, हर प्रोडक्ट के लिए एक आधारित ऐड रेंडर कीजिए, और लौटे URL इकट्ठा कीजिए। यह ऐसा काम है जो UI में सच में थकाऊ है।
CI में क्रेडिट गार्ड। hermoso credits --json | jq .balance और लंबा बैच शुरू होने से पहले खाली बैलेंस पर pipeline रोक दीजिए।
लागत के हिसाब से मॉडल चुनना। hermoso capabilities --json हर मॉडल की सटीक लागत देता है, तो स्क्रिप्ट एक मॉडल को कड़ा करने के बजाय वह सबसे सस्ता मॉडल चुन सकती है जो brief को पूरा करे।

पब्लिशिंग और कैंपेन

CLI subcommands रिसर्च और बनाने को कवर करते हैं। 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 कैंपेन, ad sets और ads बिना किसी caller override के 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 समेत) स्पष्ट पुष्टि वाले flag के बिना नहीं चलते, और वही gate एक सक्षम Google Ads ad group, ad या keyword बनाने को भी रोकता है, जिसका parent पहले से सक्षम है, क्योंकि वह अगली नीलामी में ही चलने लगता है। Delete भी पुष्टि के बाद ही होते हैं। जनरेशन की ओर, hermoso_capabilities हर मॉडल की सटीक क्रेडिट लागत कुछ भी चलने से पहले बताता है, और हर रेंडर पहले एक अनुमान रिज़र्व करता है और फिर असली लागत सेटल करता है, इसलिए विफल dispatch पर पैसा वापस होता है, चुपचाप नहीं कटता।

एजेंट के अंदर काम करना है, शेल में नहीं? देखिए Claude Code मार्केटिंग ऑटोमेशन और पूरा MCP और CLI संदर्भ।

अक्सर पूछे जाने वाले सवाल

क्या ऐड चलाने के लिए कोई कमांड-लाइन टूल है?

हां। npm install -g hermoso Hermoso CLI इंस्टॉल करता है, जो Meta, Google और LinkedIn की ऐड लाइब्रेरी के पार प्रतिस्पर्धी ऐड की रिसर्च करता है, किसी वेबसाइट से ब्रांड प्रोफ़ाइल बनाता है, तैयार इमेज और वीडियो ऐड की योजना बनाकर उन्हें रेंडर करता है, और क्रेडिट व jobs की रिपोर्ट देता है, हर कमांड पर स्क्रिप्टिंग के लिए --json आउटपुट के साथ। वही पैकेज stdio पर पूरा 922+ टूल वाला MCP सर्वर भी चलाता है।

Hermoso CLI में authentication कैसे करूं?

hermoso auth login चलाइए। यह एक loopback ब्राउज़र साइन-इन खोलता है (वही पैटर्न जो gh और firebase इस्तेमाल करते हैं) और बनी key को ~/.hermoso/config.json में केवल-मालिक अनुमतियों (डायरेक्टरी 0700, फ़ाइल 0600) के साथ सेव करता है। CI के लिए, hermoso auth login --token <key> एक key बिना इंटरैक्टिव प्रॉम्प्ट के सेव करता है, और HERMOSO_TOKEN तथा HERMOSO_API_BASE environment से config को बदल देते हैं।

क्या मैं आउटपुट को jq में पाइप कर सकता हूं?

हां। हर कमांड --json लेता है और एक संरचित ऑब्जेक्ट प्रिंट करता है। यही इरादा किया गया अनुबंध है; मनुष्य के लिए पढ़ने योग्य पंक्ति केवल सुविधा है। लंबे रेंडर बैच से पहले hermoso credits --json | jq .balance एक उपयोगी CI गार्ड है।

MCP सर्वर के बजाय CLI क्यों इस्तेमाल करें?

टोकन की लागत। MCP क्लाइंट टूल मैनिफ़ेस्ट को context में लोड करता है, और 922+ टूल मुफ़्त नहीं हैं। एक टर्मिनल एजेंट जो subprocess कमांड चलाता है और 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 subcommands के बजाय MCP सतह में रहते हैं, और उसी पैकेज से hermoso mcp चलाकर, https://app.hermoso.ai/mcp पर होस्टेड endpoint से, या वेब स्टूडियो से पहुंचे जा सकते हैं। पब्लिशिंग के लक्ष्य Facebook, Instagram, Threads, TikTok, YouTube, X, LinkedIn, Pinterest, Bluesky, Telegram और Google Business Profile हैं।

क्या यह लोकल सर्वर के खिलाफ काम करता है?

हां। HERMOSO_API_BASE को अपने origin पर सेट कीजिए (उदाहरण के लिए http://localhost:3000) और CLI तथा MCP सर्वर दोनों उसी को लक्ष्य बनाते हैं। localhost base को auth token की ज़रूरत नहीं होती।

कमांड लाइन से ऐड चलाइए