hermoso-ai/hermoso

**The AI marketing agent with an AI ad generator built in**, run from **any AI agent**: Claude Code, Claude.ai, Cursor, Codex, or your own
scripts. Research the ads already winning in a market, generate finished image & video ads (your real product
composited in, copy + CTA included), publish them to your own social channels, and build & manage the ad
campaigns behind them, all over MCP tools, a CLI, or installable Claude skills.
**906 tools.** tools/list is always the authoritative set; hermoso_capabilities (free) returns the live model
catalog with exact per-render credit costs plus the full capability map.
**A Chrome extension too.** Hermoso: save and clone ads
saves any ad to your swipefile in one click, clones it for your brand, and pulls any company's ads from its
website.
**Most of it costs nothing.** Publishing and scheduling posts, building and managing paid campaigns, analytics
and insights, comments and DMs, connectors, profiles and team seats are **free on every plan**, with no
per-post or per-channel fee and no seat pricing. Credits are spent only on running an AI model (image, video,
voice, text, planning, post-production) and on Ad Spy research, and posting an ad you already rendered is never a
second charge. The one exception is X (Twitter), where posting and reads bill a few credits per call because X
charges per API request.
**What it connects to.** Ad platforms: Meta, Google Ads, TikTok Ads, LinkedIn Ads, Reddit Ads, X Ads,
Pinterest Ads, Snapchat Ads, Microsoft Advertising, Apple Search Ads, ChatGPT Ads and AppLovin Ads, plus
product feeds in Google Merchant Center. Publishing and scheduling — **eleven** channels: Facebook, Instagram,
Threads, TikTok, YouTube, X, LinkedIn, Pinterest, Bluesky, Telegram and Google Business Profile. Messaging: WhatsApp (you message a
person, so it is not a twelfth publishing channel) and DM automations on Instagram, Facebook Pages and
Messenger, and X (a keyword comment, a DM, a story reply or an ig.me / m.me link gets an automatic reply). Ad research: the Meta, Google and LinkedIn ad libraries plus organic TikTok,
Instagram, YouTube, Threads and Reddit. Analytics: Google Analytics 4, Google Search Console and every
connected platform's own post and campaign insights. Files: Google Drive, Sheets, Docs and OneDrive.
**It is not all-or-nothing.** Research, creation, publishing/scheduling and ads management are four *independent*
areas — no tool requires that you used another one first. Publish or schedule creative you already have and
generate nothing here (upload_file turns any local or external file into a URL every publish, schedule and
ad-build tool accepts); build and read campaigns on your own ad accounts with your own creative; research
competitors with no brand drafted and no channel connected; or generate a file with nothing connected at all and
just download it. Use the one piece you need, or all of it together.
Install in one command
This repo is a plugin marketplace, a Gemini CLI extension and a skills package at once, so a coding agent takes
Hermoso in one line. Every install brings the same five skills (hermoso-research, hermoso-generate,
hermoso-ad-from-brand, hermoso-product-photoshoot, hermoso-marketing), and the skills drive the hermoso
CLI through npx. No
tool list is loaded into your session: a CLI command costs nothing until it runs, and it reaches every tool.
The first time, your agent runs npx -y hermoso auth login, which opens a browser to sign in.
**Claude Code:**
Inside a session the same thing is /plugin marketplace add hermoso-ai/hermoso then /plugin install hermoso@hermoso.
**Codex CLI** (it reads the same marketplace file):
**Gemini CLI:**
**Grok** (xAI) comes in three shapes, and each one connects differently:
- **grok.com and the Grok apps** take the hosted connector: open **Plugins → Connectors → New Connector → Custom**
(or go straight to grok.com/connectors), paste https://app.hermoso.ai/mcp and sign in with your Hermoso account.
- **Grok Bot**: add the Hermoso Marketing Bot template. It arrives wired
to Hermoso and asks for a key, which you create in the app under **MCP & CLI → Terminal & API keys**.
- **Grok Build**, xAI's terminal agent, runs a local MCP server. Sign in once, then add it:
**Cursor, OpenCode, GitHub Copilot, Windsurf and about 75 more agents**, through the open skills installer:
It asks which agents to install into; -a opencode (or cursor, github-copilot, windsurf) picks one, and