Chạy quảng cáo từ dòng lệnh: CLI Hermoso

Công cụ quảng cáo gần như hoàn toàn là bảng điều khiển, và điều đó khiến nó gần như không thể tự động hóa. Bạn không thể đặt cron cho một bảng điều khiển, không thể đưa bảng điều khiển vào jq, và không thể nhờ agent terminal bấm vào nó. CLI Hermoso tồn tại để vòng lặp quảng cáo không còn là nơi bạn phải ghé thăm, mà trở thành thứ bạn có thể viết script.

Cài đặt và đăng nhập:

npm install -g hermoso
hermoso auth login

auth login mở một listener loopback và mở trình duyệt, cùng kiểu với gh và firebase, nên không có gì phải dán. Khóa được tạo ra được ghi vào ~/.hermoso/config.json với quyền chỉ chủ sở hữu (thư mục 0700, file 0600), vì nó mang quyền chi tiêu thật. Với CI, hermoso auth login --token <key> lưu một khóa mà không cần tương tác, và HERMOSO_TOKEN / HERMOSO_API_BASE ghi đè cấu hình từ biến môi trường.

Các lệnh

Mọi lệnh đều nhận --json, đó là toàn bộ điểm mấu chốt: dòng văn bản dễ đọc chỉ là tiện ích, còn JSON mới là hợp đồng.

Lệnh	Chức năng
`hermoso capabilities`	Mã mô hình hợp lệ và chi phí credit chính xác của chúng. Hãy chạy lệnh này đầu tiên. Nó miễn phí và chỉ đọc, và đó là cách bạn ngừng đoán tên mô hình.
`hermoso credits`	Số dư, mức dùng trong phiên và các lệnh gọi tính phí gần đây.
`hermoso brand --domain example.com`	Đọc một website thành hồ sơ thương hiệu (sản phẩm, bảng màu, logo, giọng điệu) mà các lần render sau này dựa vào.
`hermoso competitors --domain example.com`	Tìm các đối thủ trực tiếp và thương hiệu tương tự đáng để học hỏi.
`hermoso ads --company "Brand"`	Lấy các quảng cáo đang chạy thật của nhà quảng cáo đó từ thư viện quảng cáo Meta, Google và LinkedIn, đã loại trùng và sắp xếp.
`hermoso research "longest-running protein bar ads"`	Nghiên cứu quảng cáo bằng ngôn ngữ tự nhiên trên các thư viện cùng TikTok tự nhiên, trả về các quảng cáo tìm được.
`hermoso create --brand … --product … --format video`	Biến một brief thành một ý tưởng quảng cáo hoàn chỉnh: các biến thể nội dung cùng một ý tưởng ảnh hoặc storyboard video, kèm các mã mô hình để render.
`hermoso generate image --prompt "…" --ref ./bottle.png`	Render và trả về một URL đã được phục vụ. `--ref` ghép sản phẩm thật của bạn vào để nhãn trên màn hình chính là SKU thật của bạn.
`hermoso jobs` / `hermoso fetch <url>`	Kiểm tra các bản render đang chạy; phân giải bất kỳ tài sản nào thành một URL có thể nhấp và một URL tải trực tiếp.
`hermoso mcp`	Phục vụ toàn bộ bề mặt MCP hơn 922 công cụ qua stdio, cùng các công cụ mà máy chủ hosted đang cung cấp.

Hai bề mặt, một gói, và vì sao điều đó quan trọng

Các agent terminal phải trả tiền cho công cụ hai lần: một lần trong bản kê mà chúng mang theo trong ngữ cảnh, và một lần bằng token mỗi lần gọi. Một bản kê hơn 922 công cụ không hề rẻ. Vì vậy, cùng một gói cung cấp cả hai bề mặt và để agent tự chọn:

MCP (hermoso mcp, hoặc https://app.hermoso.ai/mcp hosted) khi bạn cần toàn bộ bề mặt và các đối số có kiểu phong phú.
Các lệnh con qua subprocess khi bạn muốn đường đi tiết kiệm token: agent gọi shell, đọc JSON, và không bao giờ nạp bản kê nào. Đây là kiểu mẫu mà các kỹ năng Claude đi kèm đang dùng.

Cả hai đều gọi cùng một API, tính cùng credit và ghi vào cùng một thư viện, nên không có gì bị thất lạc ở một phía.

Những việc đáng viết script

Quét đối thủ hằng tuần. Chạy hermoso competitors rồi hermoso ads, so với tuần trước, và bạn có một báo cáo thường trực về những gì thị trường của bạn vừa bắt đầu và ngừng chạy.
Tạo creative hàng loạt cho một catalog. Lặp qua các SKU, render một quảng cáo có căn cứ cho mỗi sản phẩm, và gom các URL trả về. Đó là loại công việc thật sự tẻ nhạt khi làm trên giao diện.
Chốt kiểm tra credit trong CI. hermoso credits --json | jq .balance và làm pipeline thất bại trước khi một đợt lớn bắt đầu với số dư đã cạn.
Chọn mô hình theo chi phí. hermoso capabilities --json cung cấp chi phí chính xác của từng mô hình, nên một script có thể chọn mô hình rẻ nhất đáp ứng brief thay vì mã cứng một mô hình.

Đăng bài và chiến dịch

Các lệnh con CLI bao phủ nghiên cứu và sáng tạo. Đăng bài, lên lịch và quản lý chiến dịch trên Meta, Google Ads, Microsoft Advertising, Reddit Ads, LinkedIn, Pinterest, X Ads, TikTok Ads, Snapchat Ads, ChatGPT Ads, Apple Search Ads và AppLovin Ads nằm trong bề mặt MCP, có thể truy cập từ cùng gói đó bằng hermoso mcp, từ endpoint hosted, hoặc từ studio trên web. Các kênh đăng bài là Facebook, Instagram, Threads, TikTok, YouTube, X, LinkedIn, Pinterest, Bluesky, Telegram và Google Business Profile.

Những việc nó sẽ không làm nếu chưa hỏi

Một agent có ngân sách chỉ hữu ích khi phạm vi tác động của nó bị giới hạn, nên quyền chi tiêu được rào lại ở máy chủ chứ không nằm trong prompt. Các chiến dịch, nhóm quảng cáo và quảng cáo Meta luôn được tạo ở trạng thái PAUSED, không có cách nào để người gọi ghi đè. Các công tắc trạng thái có thể bật chi tiêu quảng cáo thật (có một công tắc trên mỗi nền tảng quảng cáo: 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 và set_openai_ads_status, cùng những công tắc khác) đều từ chối chạy nếu không có cờ xác nhận rõ ràng, và cùng cổng đó áp dụng cho việc tạo một nhóm quảng cáo, quảng cáo hoặc từ khóa Google Ads đang bật dưới một mục cha đã bật, vì nó sẽ phục vụ ngay ở phiên đấu giá tiếp theo. Các thao tác xóa cũng cần xác nhận. Về phía tạo nội dung, hermoso_capabilities công bố chi phí credit chính xác của từng mô hình trước khi chạy bất cứ thứ gì, và mỗi lần render giữ trước một khoản ước tính rồi quyết toán theo chi phí thật, nên một lần gửi thất bại sẽ được hoàn lại thay vì âm thầm tính tiền bạn.

Đang làm việc trong một agent thay vì shell? Xem marketing tự động hóa trong Claude Code và tài liệu đầy đủ MCP & CLI.

Câu hỏi thường gặp

Có công cụ dòng lệnh nào để chạy quảng cáo không?

Có. npm install -g hermoso cài CLI Hermoso, công cụ nghiên cứu quảng cáo đối thủ trên thư viện quảng cáo Meta, Google và LinkedIn, soạn hồ sơ thương hiệu từ một website, lên kế hoạch và render quảng cáo ảnh và video hoàn chỉnh, và báo cáo credit cùng các tác vụ, với đầu ra --json trên mọi lệnh để viết script. Cùng gói đó cũng phục vụ máy chủ MCP hơn 922 công cụ đầy đủ qua stdio.

Làm thế nào để xác thực CLI Hermoso?

Chạy hermoso auth login. Lệnh này mở đăng nhập trình duyệt qua loopback (cùng kiểu với gh và firebase) và lưu khóa được tạo ra tại ~/.hermoso/config.json với quyền chỉ chủ sở hữu (thư mục 0700, file 0600). Với CI, hermoso auth login --token <key> lưu khóa mà không cần tương tác, và HERMOSO_TOKEN cùng HERMOSO_API_BASE ghi đè cấu hình từ biến môi trường.

Tôi có thể đưa đầu ra vào jq không?

Có. Mọi lệnh đều nhận --json và in ra một đối tượng có cấu trúc. Đó là hợp đồng được thiết kế; dòng văn bản dễ đọc chỉ là tiện ích. hermoso credits --json | jq .balance là một chốt kiểm tra CI hữu ích trước một đợt render lớn.

Vì sao dùng CLI thay vì máy chủ MCP?

Chi phí token. Một client MCP nạp bản kê công cụ vào ngữ cảnh, và hơn 922 công cụ không hề miễn phí. Một agent terminal gọi các lệnh subprocess và đọc JSON thì không mang theo bản kê nào. Cả hai bề mặt đều gọi cùng một API, tính cùng credit và ghi vào cùng một thư viện, nên bạn có thể dùng kết hợp.

CLI có thể đăng lên Facebook hoặc quản lý quảng cáo Meta không?

Đăng bài, lên lịch và quản lý chiến dịch trên Meta, Google Ads, Microsoft Advertising, Reddit Ads, LinkedIn, Pinterest, X Ads, TikTok Ads, Snapchat Ads, ChatGPT Ads, Apple Search Ads và AppLovin Ads nằm trong bề mặt MCP chứ không nằm trong các lệnh con CLI, có thể truy cập từ cùng gói đó bằng cách chạy hermoso mcp, từ endpoint hosted tại https://app.hermoso.ai/mcp, hoặc từ studio trên web. Các kênh đăng bài là Facebook, Instagram, Threads, TikTok, YouTube, X, LinkedIn, Pinterest, Bluesky, Telegram và Google Business Profile.

Có chạy được với máy chủ local không?

Có. Đặt HERMOSO_API_BASE thành origin của bạn (ví dụ http://localhost:3000) và cả CLI lẫn máy chủ MCP đều sẽ nhắm tới nó. Một base localhost không cần token xác thực.

Liên quan

Các lần render chạy như tác vụ phía máy chủ mà bạn thăm dò, và một bài đăng được thử lại vẫn an toàn ngay cả khi không biết kết quả của lần thử đầu. Chi tiết nằm ở tác vụ và tính idempotent.

Nếu bạn đang làm trong Claude Code, xem Claude Code marketing.

Cài CLI, đăng nhập từ trình duyệt, và lần quét đối thủ đầu tiên của bạn chỉ cách một lệnh. Tài khoản miễn phí, có 250+ credit miễn phí có thể kiếm thêm, không cần thẻ.

Bắt đầu miễn phí → Đọc tài liệu MCP →