Τα εργαλεία διαφήμισης είναι σχεδόν εξ ολοκλήρου πίνακες ελέγχου, πράγμα που σημαίνει ότι σχεδόν δεν αυτοματοποιούνται. Δεν μπορείτε να βάλετε έναν πίνακα ελέγχου σε cron, δεν μπορείτε να στείλετε έναν πίνακα ελέγχου στο jq, και δεν μπορείτε να ζητήσετε από έναν πράκτορα τερματικού να πατήσει κάποιο κουμπί του. Το CLI του Hermoso υπάρχει για να σταματήσει ο βρόχος της διαφήμισης να είναι ένα μέρος που επισκέπτεστε και να γίνει κάτι που μπορείτε να προγραμματίσετε σε σενάριο.
Εγκατάσταση και σύνδεση:
npm install -g hermoso
hermoso auth loginΤο auth login ανοίγει έναν τοπικό listener και ανοίγει τον περιηγητή, με το ίδιο μοτίβο που χρησιμοποιούν τα gh και firebase, οπότε δεν χρειάζεται να επικολλήσετε τίποτα. Το κλειδί που εκδίδεται γράφεται στο ~/.hermoso/config.json με δικαιώματα μόνο για τον ιδιοκτήτη (ο φάκελος 0700, το αρχείο 0600), επειδή μεταφέρει πραγματική εξουσία δαπάνης. Για CI, το hermoso auth login --token <key> αποθηκεύει ένα κλειδί χωρίς διαδραστική ροή, και τα HERMOSO_TOKEN / HERMOSO_API_BASE υπερισχύουν του αρχείου ρυθμίσεων από το περιβάλλον.
Οι εντολές
Κάθε εντολή δέχεται το --json, και αυτό είναι το κύριο σημείο: η γραμμή που διαβάζεται από άνθρωπο είναι απλώς διευκόλυνση, ενώ το JSON είναι το συμβόλαιο.
| Εντολή | Τι κάνει |
|---|---|
hermoso capabilities | Έγκυρα αναγνωριστικά μοντέλων και το ακριβές κόστος τους σε credits. Τρέξτε την πρώτη. Είναι δωρεάν και μόνο για ανάγνωση, και έτσι σταματάτε να μαντεύετε ονόματα μοντέλων. |
hermoso credits | Υπόλοιπο, χρήση της τρέχουσας συνεδρίας και πρόσφατες κλήσεις με χρέωση. |
hermoso brand --domain example.com | Διαβάζει έναν ιστότοπο σε προφίλ μάρκας (προϊόντα, παλέτα, λογότυπο, φωνή), πάνω στο οποίο βασίζονται αργότερα τα renders. |
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 σε έτοιμη ιδέα διαφήμισης: παραλλαγές κειμένου και μια ιδέα εικόνας ή ένα storyboard βίντεο, με τα αναγνωριστικά μοντέλων για το render. |
hermoso generate image --prompt "…" --ref ./bottle.png | Κάνει render και επιστρέφει ένα σερβιρισμένο URL. Το --ref τοποθετεί το πραγματικό σας προϊόν, ώστε η ετικέτα στην οθόνη να είναι το πραγματικό σας SKU. |
hermoso jobs / hermoso fetch <url> | Ελέγξτε τα renders που τρέχουν· μετατρέψτε οποιοδήποτε στοιχείο σε URL για προβολή και σε άμεσο URL λήψης. |
hermoso mcp | Σερβίρει ολόκληρη την επιφάνεια MCP με 922+ εργαλεία μέσω stdio, τα ίδια εργαλεία που εκθέτει ο φιλοξενούμενος server. |
Δύο επιφάνειες, ένα πακέτο, και γιατί έχει σημασία
Οι πράκτορες τερματικού πληρώνουν για τα εργαλεία δύο φορές: μία στο μανιφέστο που κουβαλούν στο context, και μία στα tokens που κοστίζει κάθε κλήση. Ένα μανιφέστο 922+ εργαλείων δεν είναι δωρεάν. Γι' αυτό το ίδιο πακέτο προσφέρει και τις δύο επιφάνειες και αφήνει τον πράκτορα να επιλέξει:
- MCP (
hermoso mcp, ή το φιλοξενούμενοhttps://app.hermoso.ai/mcp) όταν θέλετε την πλήρη επιφάνεια και πλούσια τυποποιημένα ορίσματα. - Εντολές υποδιεργασιών όταν θέλετε τον δρόμο φθηνό σε tokens: ο πράκτορας εκτελεί εντολή, διαβάζει JSON και δεν φορτώνει ποτέ μανιφέστο. Αυτό είναι το μοτίβο που χρησιμοποιούν τα συνοδευτικά δεξιοτήματα Claude.
Και οι δύο φτάνουν στο ίδιο API, χρεώνουν τα ίδια credits και γράφουν στην ίδια βιβλιοθήκη, οπότε τίποτα δεν μένει μετέωρο στη μία πλευρά.
Πράγματα που αξίζει να τα βάλετε σε σενάριο
- Εβδομαδιαία σάρωση ανταγωνιστών. Το
hermoso competitorsτροφοδοτεί τοhermoso ads, συγκρίνετε με την προηγούμενη εβδομάδα, και έχετε μόνιμη αναφορά για το τι άρχισαν και τι σταμάτησαν να τρέχουν στην αγορά σας. - Δημιουργικό σε παρτίδα για έναν κατάλογο. Κάντε βρόχο σε κάθε SKU, κάντε render μία διαφήμιση ανά προϊόν με βάση τα δεδομένα του και συλλέξτε τα URL που επιστρέφουν. Είναι το είδος δουλειάς που στο περιβάλλον γραφικής διεπαφής είναι πραγματικά κουραστικό.
- Φρουρός credits στο CI.
hermoso credits --json | jq .balanceκαι αποτυχία της ροής πριν ξεκινήσει μια μεγάλη παρτίδα με άδειο υπόλοιπο. - Επιλογή μοντέλου με γνώμονα το κόστος. Το
hermoso capabilities --jsonδείχνει το ακριβές κόστος ανά μοντέλο, οπότε ένα σενάριο μπορεί να διαλέξει το φθηνότερο μοντέλο που καλύπτει το brief, αντί να έχει μέσα σκληρά κωδικοποιημένο ένα συγκεκριμένο.
Δημοσίευση και καμπάνιες
Οι υποεντολές του 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 ή από το web studio. Οι στόχοι δημοσίευσης είναι τα Facebook, Instagram, Threads, TikTok, YouTube, X, LinkedIn, Pinterest, Bluesky, Telegram και Google Business Profile.
Τι δεν θα κάνει χωρίς να ρωτήσει
Ένας πράκτορας με προϋπολογισμό είναι χρήσιμος μόνο όταν το εύρος του είναι περιορισμένο, γι' αυτό η εξουσία δαπάνης φυλάσσεται στον server και όχι σε μια προτροπή. Οι καμπάνιες, τα ad sets και οι διαφημίσεις του 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 δημοσιεύει το ακριβές κόστος credits κάθε μοντέλου πριν τρέξει οτιδήποτε, και κάθε render δεσμεύει μια εκτίμηση και μετά ρυθμίζει το πραγματικό κόστος, οπότε μια αποτυχημένη εκτέλεση επιστρέφει τα χρήματα αντί να σας χρεώνει αθόρυβα.
Δουλεύετε μέσα σε πράκτορα και όχι σε κέλυφος; Δείτε τη αυτοματοποίηση μάρκετινγκ με Claude Code και την πλήρη τεκμηρίωση MCP & CLI.
Συχνές ερωτήσεις
Υπάρχει εργαλείο γραμμής εντολών για την εκτέλεση διαφημίσεων;
Ναι. Το npm install -g hermoso εγκαθιστά το CLI του Hermoso, που ερευνά διαφημίσεις ανταγωνιστών στις βιβλιοθήκες διαφημίσεων των Meta, Google και LinkedIn, συντάσσει προφίλ μάρκας από έναν ιστότοπο, σχεδιάζει και κάνει render έτοιμες διαφημίσεις εικόνας και βίντεο, και αναφέρει credits και εργασίες, με έξοδο --json σε κάθε εντολή για σενάρια.
Πώς κάνω έλεγχο ταυτότητας στο CLI του Hermoso;
Τρέξτε το hermoso auth login. Ανοίγει σύνδεση στον περιηγητή μέσω τοπικού listener (με το ίδιο μοτίβο που χρησιμοποιούν τα 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 πριν από μια μεγάλη παρτίδα render.
Γιατί να χρησιμοποιήσω το CLI αντί για τον server MCP;
Κόστος σε tokens. Ένας πελάτης MCP φορτώνει το μανιφέστο εργαλείων στο context, και τα 922+ εργαλεία δεν είναι δωρεάν. Ένας πράκτορας τερματικού που καλεί υποεντολές και διαβάζει JSON δεν κουβαλά κανένα μανιφέστο. Και οι δύο επιφάνειες φτάνουν στο ίδιο API, χρεώνουν τα ίδια credits και γράφουν στην ίδια βιβλιοθήκη, οπότε μπορείτε να τις συνδυάζετε.
Μπορεί το 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, ή από το web studio. Οι στόχοι δημοσίευσης είναι τα Facebook, Instagram, Threads, TikTok, YouTube, X, LinkedIn, Pinterest, Bluesky, Telegram και Google Business Profile.
Λειτουργεί με τοπικό server;
Ναι. Ορίστε το HERMOSO_API_BASE στη δική σας προέλευση (για παράδειγμα http://localhost:3000) και τόσο το CLI όσο και ο server MCP στρέφονται εκεί. Μια τοπική βάση δεν χρειάζεται διακριτικό ταυτοποίησης.
Σχετικά
Τα renders τρέχουν ως εργασίες παρασκηνίου που ελέγχετε με polling, και ένα επαναδοκιμασμένο ποστ είναι ασφαλές ακόμη κι όταν το αποτέλεσμα της πρώτης προσπάθειας είναι άγνωστο. Οι λεπτομέρειες βρίσκονται στο jobs and idempotency.
Αν θέλετε να το ρυθμίσετε μέσα στο Claude Code, δείτε το μάρκετινγκ με Claude Code.
Εγκαταστήστε το CLI, συνδεθείτε από τον περιηγητή σας, και η πρώτη σάρωση ανταγωνιστών είναι μία εντολή μακριά. Δωρεάν λογαριασμός, πάνω από 250 δωρεάν credits που κερδίζονται, χωρίς κάρτα.
Ξεκινήστε δωρεάν → Διαβάστε την τεκμηρίωση MCP →