Hermoso: competitor & ad research

This is Hermoso's discovery half (which most generators don't have). Drive the Hermoso CLI.

Setup (once)

Install the CLI once: npm install -g hermoso, then run every command as hermoso …, as written below. If you cannot install packages, prefix the commands with npx -y, but know that npx asks the npm registry on every single call, so an agent making many calls can be rate-limited by npm (an HTTP 429 from npm, before Hermoso is ever reached). No MCP server is needed.
Sign in once: npx -y hermoso auth login (opens a browser; nothing to paste). On a machine with no browser: npx -y hermoso auth login --token <your key>, using a key from app.hermoso.ai under MCP & CLI. No account at all? An agent can sign itself up on a paid plan with POST /v1/signup at app.hermoso.ai; see the Hermoso README.
For anything these steps do not cover (organic search on TikTok, Instagram, YouTube, Reddit or Threads, creator search, a competitor teardown): hermoso tools --search <what you want> finds the tool, hermoso tools <name> prints its arguments, hermoso call <name> --json '{...}' runs it.

Pick the tool that fits the ask:

Find competitors for a domain: hermoso competitors <domain> [--mode competitors|inspiration|company] --json
- competitors = head-to-head rivals; inspiration = best relevant ads incl. the brand itself; company = the company's own.
Pull a brand's real ads across ad libraries: hermoso ads pull --company "<name>" [--domain <d>] [--platforms facebook,google,linkedin] [--country US] --json
- Defaults to Meta (richest library). Add google/linkedin only if asked (Google detailed pulls cost more).
Natural-language research (Claude tool-use over ad libraries + organic TikTok): hermoso research "<request>"
- e.g. hermoso research "the longest-running protein-pancake ads on Meta and what hooks they use". Prints a summary + the found ads with their URLs.
Synthesize: report the strongest hooks, angles, formats, and what's worth copying, be specific (quote the actual headlines/angles). If the user then wants to build one, hand off to hermoso-ad-from-brand / hermoso-generate.