Hermoso

Hermoso：MCP、CLI 和 Skills

内置 AI 广告生成器的 AI 营销 Agent，可通过任何 AI Agent运行：Claude Code、Claude.ai、Cursor、Codex，或你自己的 脚本。研究市场上表现出色的广告，生成图片和视频广告（将你的真实产品融入其中，并包含文案和 CTA），将它们发布到你自己的社交渠道，并创建和管理相应的广告 系列。以上所有操作均可通过 MCP 工具、CLI 或可安装的 Claude 技能完成。

1090 个工具。 tools/list 始终是权威工具集；hermoso_capabilities（免费）会返回实时模型 目录，其中包含每次生成的精确额度成本以及完整的能力映射。

模型不加价。 不再为 AI 模型支付过高的加价。套餐：hermoso.ai/pricing。

还有 Chrome 扩展。 Hermoso：保存并克隆广告 只需点击一次，即可将任意广告保存到你的广告素材库，为你的品牌克隆广告，并从任意公司的 网站获取其广告。

大部分功能免费。 在所有套餐中，发布和定时发布帖子、创建和管理付费广告系列、分析与洞察、 评论和私信、连接器、个人资料和团队席位均免费，不按帖子或渠道收费，也不收取席位费用。只有运行 AI 模型（图片、视频、 语音、文本、规划、后期制作）和 Ad Spy 研究才会消耗额度，而发布已生成的广告绝不会再次收费。唯一例外是 X（Twitter）：由于 X 按 API 请求收费，发布内容和读取数据时，每次调用会扣除少量额度。

可连接的平台。 广告平台：Meta、Google Ads、TikTok Ads、LinkedIn Ads、Reddit Ads、X Ads、 Pinterest Ads、Snapchat Ads、Microsoft Advertising、Apple Search Ads、ChatGPT Ads 和 AppLovin Ads，以及 Google Merchant Center 中的商品 Feed。发布和定时发布——十一个渠道：Facebook、Instagram、Threads、TikTok、YouTube、X、LinkedIn、Pinterest、Bluesky、Telegram 和 Google Business Profile。消息功能：WhatsApp（你是在给 某个人发消息，因此它不算第十二个发布渠道），以及 Instagram、Facebook Pages 和 Messenger、X 上的私信自动化（关键词评论、私信、快拍回复或 ig.me / m.me 链接都会触发自动回复）。广告研究：Meta、Google 和 LinkedIn 广告资料库，以及 TikTok、Instagram、YouTube、Threads 和 Reddit 上的自然内容。 分析：Google Analytics 4、Google Search Console，以及每个已连接平台自身的帖子和广告系列洞察。文件：Google Drive、Sheets、Docs 和 OneDrive。

无需绑定使用全部功能。 研究、创作、发布／定时发布和广告管理是四个独立领域——没有任何工具要求你先使用其他工具。发布或定时发布已有创意，无需在此生成任何内容（upload_file 会将任意本地或外部文件转换为每个发布、定时发布和广告创建工具都可接受的 URL）；在你自己的广告账户中，用你自己的创意创建和查看广告系列；无需起草品牌资料或连接渠道，即可研究竞争对手；或者在完全不连接任何内容的情况下生成文件，然后直接下载。你可以只使用所需的一项功能，也可以将所有功能结合使用。

一键安装

这个仓库同时是一个插件市场、Gemini CLI 扩展和技能包，因此编码 Agent 只需一行命令即可使用 Hermoso。每次安装都会带上同样的五项技能（hermoso-research、hermoso-generate、 hermoso-ad-from-brand、hermoso-product-photoshoot、hermoso-marketing），这些技能通过 npx 驱动 hermoso CLI。会话中不会加载工具列表：CLI 命令只有在运行时才会产生开销，而且可以访问所有工具。 首次使用时，Agent 会运行 npx -y hermoso auth login，打开浏览器以登录。

Claude Code：

claude plugin marketplace add hermoso-ai/hermoso && claude plugin install hermoso@hermoso

在会话中，也可以运行 /plugin marketplace add hermoso-ai/hermoso，然后运行 /plugin install hermoso@hermoso。

Codex CLI（它读取同一个市场文件）：

codex plugin marketplace add hermoso-ai/hermoso && codex plugin add hermoso@hermoso

Gemini CLI：

gemini extensions install https://github.com/hermoso-ai/hermoso

Grok（xAI）有三种形式，每种的连接方式都不同：

• grok.com 和 Grok 应用使用托管连接器：打开 Plugins → Connectors → New Connector → Custom （也可以直接访问 grok.com/connectors），粘贴 https://app.hermoso.ai/mcp，然后使用 Hermoso 账户登录。

• Grok Bot：添加 Hermoso Marketing Bot 模板。它已配置好连接 Hermoso，并会要求提供一个密钥；你可以在应用的 MCP & CLI → Terminal & API keys 中创建密钥。

• Grok Build（xAI 的终端 Agent）运行本地 MCP 服务。登录一次，然后添加它：

  npx -y hermoso auth login
  grok mcp add hermoso -- npx -y hermoso mcp
  

Cursor、OpenCode、GitHub Copilot、Windsurf 和另外约 75 个 Agent，通过开放的技能安装程序安装：

npx skills add hermoso-ai/hermoso

安装程序会询问要安装到哪些 Agent；使用 -a opencode（或 cursor、github-copilot、windsurf）可指定一个， 而 --skill hermoso-research 则可安装单个技能。VS Code Agent 插件也可以直接安装整个仓库：运行 Chat: Install Plugin From Source，并粘贴 https://github.com/hermoso-ai/hermoso。

ChatGPT 和 Claude.ai 在浏览器中运行，无法运行 CLI，因此要改用托管连接器（见下文）。 ChatGPT 桌面应用和 ChatGPT 工作区管理员也可以读取此仓库的 .claude-plugin/marketplace.json，以安装这些技能。

如果这台机器无法使用浏览器，请在应用的 MCP & CLI 中创建密钥，然后运行 npx -y hermoso auth login --token <key>。

如果是在服务器、CI 作业或每天多次调用 Hermoso 的 Agent 网关上使用，请安装一次 （npm i -g hermoso），然后直接调用 hermoso。每次运行时，npx 都会向 npm 注册表查询此软件包， 繁忙的机器可能会受到 npm 的速率限制。如果 CLI 报告某个 HTTP 错误“并非来自 Hermoso”， 说明你这边的某些环节（代理、防火墙或网关）在请求到达我们之前就拒绝了请求。

Agent 应使用哪种接入方式？

有两种形式，应该选择哪种取决于你的客户端能做什么，而不是我们更偏好哪一种。

你的客户端	使用方式	原因
在浏览器中运行：Claude.ai、ChatGPT、Claude Desktop	托管连接器 https://app.hermoso.ai/mcp	它无法启动本地进程，因此只能使用 URL。无需安装，无需粘贴密钥，并且完整的工具集会随你保存的品牌上下文一并提供。对于这些客户端，这是正确的选择，并非次优方案。
可以运行 shell：Claude Code、Codex、Gemini CLI、Cursor、Cline、OpenClaw、Hermes、自行编写的脚本	上面的一键安装方式，或 CLI 本身（npm install -g hermoso）	无论是否调用工具，工具清单都会加载到每个会话中。Shell 命令在运行前不会产生任何开销，而且可以访问所有工具，而不只是默认工具列表。

CLI 会按需、仅在被询问时，回答工具清单本应回答的问题：

npx -y hermoso tools --search reddit   # every matching tool, name + one line
npx -y hermoso tools plan_ad           # one tool's full argument schema
npx -y hermoso call plan_ad --json '{"product":"…"}'   # run it

tools 和 tools <name> 会读取软件包中捆绑的注册表（无需密钥、网络或登录），因此 Agent 可以在任何人登录前浏览整个产品。只有 call 会产生费用，而且只有它需要先运行一次 hermoso auth login。

也想在编码 Agent 自己的工具列表中添加这些工具？ 这就是 MCP 服务，而且是可选的。运行一次 hermoso auth login 即可同时用于 CLI，并让 claude mcp add hermoso -- npx -y hermoso mcp 无需 env 代码块即可获取密钥，这样 Agent 就能在需要结构化结果时使用原生工具，在需要广泛覆盖时使用 shell。它会占用每个会话的上下文，因此可以等到会话聚焦于某个领域并在其中频繁调用工具时再添加；随后，enable_tools({groups:['ads']}) 会通过一次免费调用启用广告系列管理。

你的 Agent 可以自行注册

没有 Hermoso 账户的 Agent 可以自行创建账户、获取自己的密钥，并在同一会话中开始投放广告。 无需有人操作浏览器，无需工单，也无需等待。

# 1. Start a signup. This call takes no credential, because the credential is what it creates.
curl -sX POST https://app.hermoso.ai/v1/signup \
  -H 'content-type: application/json' \
  -d '{"plan":"pro","period":"mo","email":"[email protected]"}'
# -> { "id": "cs_...", "checkout_url": "https://checkout.stripe.com/...", "claim_token": "hsc_...", "email": { "address": "[email protected]", "verified": false } }
# email = the human behind the account. A verification link goes there; the account works before it is clicked.
# It is a contact mailbox only, never a sign-in. GET /v1/account/email reports the state; POST /v1/account/email/resend re-sends or changes it.

# 2. Pay at checkout_url. Store claim_token first: it is returned only in that response.

# 3. Claim it. Poll until status is "ready".
curl -sX POST https://app.hermoso.ai/v1/signup/cs_.../claim \
  -H 'content-type: application/json' \
  -d '{"claim_token":"hsc_..."}'
# -> { "status": "ready", "api_key": "hmk_...", "credits": 3000 }

这个 hmk_ 密钥与本页其他所有功能使用的凭据相同：/v1、MCP 服务和 CLI。将客户端指向它，即可使用完整功能。

具备浏览器操作能力的 Agent 已经可以自行付款。 结账页面由 Stripe 托管，因此 Claude in Chrome 和类似客户端如今都能在无人值守的情况下完成付款。其他情况只需一键转交：将 checkout_url 发给持卡人。你之后开始使用时也是如此：buy_credits 和 upgrade_plan 会生成可直接付款的链接，用于购买更多额度或升级更高套餐；billing_status 可随时查看余额。

拥有专属付款凭据的 Agent 无需任何人协助即可付款。 向 POST /api/billing/machine-payment 发送 {"packId": "pack-1k"}，会收到 HTTP 402 响应，其中包含 WWW-Authenticate: Payment 挑战（通过 Machine Payments Protocol 使用 Stripe）；完成挑战付款并重试后，同一额度包就会存入同一余额。GET /api/billing/config 会在 machinePayments 下列出额度包。额度包相同、价格相同，不按调用计费。

Agent 工作流需要付费套餐。 任意付费套餐均可。免费套餐供用户在 app.hermoso.ai 注册时使用，在此处申请会收到说明这一点的拒绝响应。只有付款完成后才会创建账户，因此未付款的注册不会留下账户，也不会产生费用。

还有一件事仍需用户操作，最好事先了解。 连接社交账号或广告账号需要 OAuth 同意页面，而任何平台都无法在无头模式下完成此操作。list_connectors 会显示已连接和未连接的项目。其他所有操作均无需浏览器：研究、生成、发布到已连接的渠道、创建广告活动和报告。

完整的请求和响应格式以及所有其他端点，均见 OpenAPI 文档：app.hermoso.ai/openapi.json。该文档由挂载路由的同一张表实时提供。

即刻使用：托管式 Claude.ai 连接器

将 https://app.hermoso.ai/mcp?src=readme 粘贴到 Claude → Customize → Connectors → Add → Add custom connector，点击 Continue，在 Authentication 下选择 Sign in now（Claude 的检测器会预先选择“No sign-in”，因为我们的发现握手无需身份验证；选择该选项后，你的首次请求会收到“Authentication required”），点击 Add 和 Connect，使用你的 Hermoso 账户授权，即可完成：获得包含已保存品牌上下文的完整工具集，费用计入你的套餐。

Claude Code 快速入门（一个命令）

1. 注册账号：访问 app.hermoso.ai。免费方案已包含在内；方案和额度与网页版 Studio 使用的相同。也可以完全跳过浏览器，让 Agent 通过 POST /v1/signup（见上文）自行注册付费方案。
2. **安装插件。**它会添加五个 Hermoso 技能，通过 npx 调用 hermoso CLI：

claude plugin marketplace add hermoso-ai/hermoso && claude plugin install hermoso@hermoso

已经在会话中？运行 /plugin marketplace add hermoso-ai/hermoso，然后运行 /plugin install hermoso@hermoso。 Codex、Gemini CLI 及其他工具的安装方法请参见一条命令安装。 3. 登录一次。npx -y hermoso auth login 会打开浏览器；Agent 首次需要使用 Hermoso 时也会自行运行此命令。在没有浏览器的机器上，请使用 npx -y hermoso auth login --token hmk_…，密钥可在 MCP & CLI 选项卡的 Terminal & API keys 下找到（Settings → API keys，或直接访问 https://app.hermoso.ai/?tab=api-keys）。 4. 用常规提示词提出需求。Claude Code 会为任务选择 Hermoso 技能并运行命令。你无需输入任何命令。

想手动安装 CLI？运行 npm install -g hermoso，即可将同一个 hermoso 命令添加到 PATH；如果技能检测到它已安装，就会使用它。

托管 URL 在 Claude Code 中也能使用，但插件是更轻量的选择，因为它不会将工具列表加载到会话中。如果需要连接器：运行 claude mcp add --transport http hermoso "https://app.hermoso.ai/mcp?src=readme"。在首次运行 claude mcp login hermoso 并在浏览器中批准之前（无头机器上使用 --no-browser 可打印链接），claude mcp list 会显示 ! Needs authentication。测试环境为 2026-09-25 的 Claude Code 2.1.282。

现在，你的 Agent 已拥有完整的 Studio 以及个人资料中的上下文：你在 Web 应用中设置的品牌详情、产品、徽标和学习到的记忆都会自动应用（get_brand 可查看已保存的内容；在 plan_ad/plan_variations 中省略 brand 即可使用这些内容）。渲染会扣除 Hermoso 额度，价格与 Studio 相同。只有 AI 模型运行和 Ad Spy 研究会消耗额度；发布、排期、广告管理和分析在所有方案中均免费（发布到 X 和读取 X 数据是唯一按调用收费的例外，管理 X 广告免费）。

1. MCP 服务（stdio），可选用于编码 Agent

hermoso mcp 会运行一个 stdio MCP 服务，提供完整工具集，供需要将 Hermoso 工具加入自身列表的客户端使用。已发布的 hermoso 包意味着无需克隆：运行 npx -y hermoso mcp 即可获取并运行。使用 CLI 登录一次后，客户端配置中无需放入密钥，因为 hermoso mcp 会读取 hermoso auth login 保存的 bearer：

npm install -g hermoso && hermoso auth login && claude mcp add hermoso -- npx -y hermoso mcp

在没有浏览器的机器上，可以跳过登录，改为将密钥传给客户端：

claude mcp add hermoso -e HERMOSO_TOKEN=hmk_… -- npx -y hermoso mcp

Cursor / Codex：以相同方式登录，然后添加到 mcp.json（Codex 使用对应的 TOML 格式）。如果已按上述方式登录，请完全移除 env 块；该配置用于进程无法读取主目录的 CI 环境：

{ "mcpServers": { "hermoso": { "command": "npx", "args": ["-y", "hermoso", "mcp"],
  "env": { "HERMOSO_API_BASE": "https://app.hermoso.ai", "HERMOSO_TOKEN": "<your token>" } } } }

然后向 Agent 提出需求：“用 Hermoso 生成一张图片广告。”

1090 个工具涵盖的功能

广告监测 / 研究 — find_competitors、competitor_teardown、pull_competitor_ads、research_ads；Meta / Google / LinkedIn 广告库（search_meta_ads、search_google_ads、search_linkedin_ads）；社交媒体自然内容（search_tiktok、search_instagram、search_youtube、search_reddit、search_threads）；fetch_social_data、mine_angles、analyze_video、check_ad_policy、list_skills / get_skill。 创作 — draft_brand → plan_ad → render_ad（Studio 品质流程：合成文字、清晰语音、音乐、品牌片尾卡），或 generate_image / generate_video / generate_avatar（UGC 创作者 + 唇形同步）。 工作区的已保存演员可重复使用：list_creators 会返回每位已保存创作者及其肖像 URL，save_creator 可添加创作者，delete_creator 可删除创作者 — 将肖像重新传给 generate_avatar / generate_video / recast_motion，每支广告都会由同一个人出演，而不是每次渲染都换一张新面孔。 还包括 make_template_ad（原生 HTML 广告格式）、make_explainer、product_sizzle、make_thumbnail、clone_static、recast_motion、reframe_video、upscale_video、dub_video、change_voice、finish_video、fix_beat、stitch_video、clip_video、post_edit，以及用于批量生成并排序的 plan_variations + score_ad。 **时长由你决定：**为 plan_ad 传入 durationSeconds，分镜脚本就会按指定时长编写 — 符合渲染模型单段片长上限的内容会渲染为单个连续镜头，较长内容则会按段落拼接（对于片长上限为 15s 的模型，40s = 15+15+10），不会压缩时长。单段片长上限由模型自身决定，并非固定数值：大多数视频模型的单段片长上限为 15 秒，而片长最长的模型可一次性连续拍摄 30 秒，并带有原生同步音频。hermoso_capabilities 会实时列出各种档位的时长、分辨率和确切点数费用 — 在 model 中指定模型名称即可使用该模型，因为未指定模型的渲染会由范围较窄的自动模型池分配。

Ads Studio（make_static_ads）：选择产品和数量，一次调用即可批量生成完成的静态广告；每支广告采用不同的销售角度和版式，并叠加真实产品照片与 Logo。其所用的产品目录（list_products、add_product、refresh_products、update_product、remove_product）会缓存每个产品的实时页面，因此名称、照片和价格都来自产品页面本身。

将人物替换到任意视频中（recast_hook、recast_motion）：保留场景、剪辑和声音，只替换出镜人物；可使用你自己的照片、已保存的创作者或 AI 人物（在网页端 Studio 中，你可以用文字描述主持人）。 使用你自己照片中的真人面孔需要付费套餐；AI 人物适用于所有套餐。

原始模型试验场 — 提供完整目录（30 多种图像 / 视频 / 语音 / 写作模型，各自标明准确的单次渲染点数费用），不添加广告包装：generate_image / generate_video（使用 useBrand:false）、generate_voice、generate_text。图像生成默认使用 Nano Banana 2.1。 发布到自己的渠道 — 11 个：Facebook、Instagram 和 Threads（post_to_meta）、TikTok （post_to_tiktok）、YouTube（post_to_youtube + update_youtube_video、youtube_video_insights、评论 读取/回复）、X（post_to_x、x_post_metrics、x_post_insights、x_mentions、list_x_dms、send_x_dm）、 LinkedIn 个人主页和公司主页（post_to_linkedin、post_to_linkedin_page）、Pinterest （post_to_pinterest + 画板）、Bluesky（post_to_bluesky、delete_bluesky_post、bluesky_post_metrics，以及 list_bluesky_convos / read_bluesky_dm / send_bluesky_dm）、Telegram（post_to_telegram、 delete_telegram_message、list_telegram_chats）和 Google Business Profile（见下文）。schedule_post / list_scheduled / cancel_scheduled 可让你用一个内容日历管理 这些渠道。upload_file 可导入任何外部或本地媒体，而不仅限于 Hermoso 渲染内容。 X 发布按 API 调用收取额度（X 按请求收费）；包含链接的帖子费用是普通帖子的 13 倍。 Google Business Profile 是商家在 Google 搜索和地图上展示的面板。post_to_google_business 可发布包含文字、可选一张照片和一个行动号召按钮的帖子（Google 帖子不接受视频，因此仅含视频的日程安排会被该渠道拒绝）；list_google_business_posts 和 delete_google_business_post 可管理当前展示的内容。list_google_business_reviews 可查找尚未回复的评价，reply_to_google_business_review 可代表商家回复评价。google_business_insights 可报告搜索和地图展示次数、来电、网站点击和路线请求，而 google_business_search_keywords 可报告人们用来查找商家信息的搜索词。list_business_locations、get_business_location 和 update_business_location 可读取和编辑商家信息本身，包括营业时间、电话、网站、描述和类别。暂不提供 Business Profile 问答功能：Google 已于 2025-11-03 将其停用。

通过 WhatsApp 联系客户 — 这是消息功能，而非第 12 个发布渠道：你向某个人发送消息，这里不会向信息流发布任何内容。list_whatsapp_accounts 可查找 Business Account 及其 号码，list_whatsapp_templates / create_whatsapp_template / delete_whatsapp_template 可管理由 Meta 审核的模板，而 send_whatsapp_message 可发送消息——此操作需要确认，因为消息会发送到真实手机，且 Meta 会向商家收取会话费用。以下两项限制是 Meta API 的既定事实，并非待解决事项：Hermoso 不会接收 WhatsApp webhook，因此没有可读取的消息历史记录——它不是收件箱界面，list_inbox 不涵盖 WhatsApp；在客户首次发送消息后开启的 24 小时窗口之外，WhatsApp 只接受已批准的模板，不接受其他内容。

自动化处理 Instagram 私信 — save_instagram_dm_automation 可设置规则，代表品牌回复用户：有人在一条、下一条或任意帖子上评论特定关键词时，规则会发送私密回复；收到私信、快拍回复或 ig.me 链接时，也会发送答复，并可选择添加链接按钮、公开评论回复、关注门槛和试运行。test_instagram_dm_automation 可准确展示示例评论或私信会触发的回复，而不会实际发送；list_instagram_dm_automations / delete_instagram_dm_automation 可查看每条规则的统计数据和发送日志，或将其删除。每个人每条帖子只能收到一条回复；Meta 允许在评论后 7 天内发送私密回复；发送流程中不会运行 AI，因此不会消耗额度。 也可自动发送 Facebook 和 X 的私信——save_dm_automation（以及 test_dm_automation、list_dm_automations 和 delete_dm_automation）接受一个 channel：instagram、facebook（在主页帖子或广告下评论关键词，会在 Messenger 中收到 私密回复；发送 Messenger 关键词或 m.me 链接，会收到答复）或 x（关键词 @提及或在你的帖子下回复，会收到公开回复；发送私信关键词，会收到私信回复）。X 只允许在对方先给你发过私信后自动发送私信；对方发送 STOP 即表示不再接收。Facebook 和 Instagram 一样免费。X 按调用向我们收费，因此 X 自动化会按 X 送达的每条提及、回复或私信，以及发送的每条回复或私信扣除额度；额度用尽后，X 规则将停止运行。

自动驾驶式发帖（set_post_refill、get_post_refill、run_post_refill）：说明频率、发布平台和主题（“每天在 Instagram 和 Bluesky 发布 2 条关于我们慢节奏晨间习惯的帖子，先让我审核”），Hermoso 就会根据你的品牌生成新帖子并填入日历。可选择先审核（每批内容都要等你批准、编辑或重做），或自动发布（直接加入日程，之后仍可撤回）。它会遵循你留下的备注，并根据各个平台上效果良好的内容来撰写。只有发布帖子时才会使用额度。

投放广告——在十二个平台上构建完整的广告系列层级，创建后保持暂停，并在汇报前读取；每项支出变更都必须经过确认：Meta、Google Ads、LinkedIn Ads、Reddit Ads、 Pinterest Ads、Microsoft Advertising、ChatGPT Ads（OpenAI 的 Advertiser API）、X Ads、TikTok Ads、 Snapchat Ads、Apple Ads（App Store 上的 Apple Search Ads）和 AppLovin Ads（所有账户密钥均可用于报告和网站像素；待 AppLovin 为账户开放 Campaign Management API 访问权限后即可构建广告系列，并可使用 AppLovin 应要求提供的 Conversion API 密钥发送服务器端转化事件）。每个平台都提供列表、报告、创建、预算和状态工具 （例如 list_google_ads_campaigns、google_ads_report、create_google_ads_campaign、set_google_ads_budget、 set_google_ads_status）。Snapchat 还需要一个其他平台不需要的额外步骤：广告需要指向一个 CREATIVE，且每个 Snapchat creative 都必须带有 Public Profile id——使用 upload_snapchat_ads_creative 创建。

为购物平台提供商品信息——Google Merchant Center 是零售 Performance Max 或 Shopping 广告系列推广的商品目录（create_google_ads_performance_max_campaign 接受 merchantCenterId），你可以在这里管理它：账户和账户状态、数据源、商品新增或更新 / 删除、各地区库存、配额、用于查看商品级表现的 merchant_report、通知和转化来源，以及违规问题处理流程——list_merchant_issues 会指出问题所在，merchant_issue_help 会返回 Google 官方文档中的修复方法。促销功能需要商家自行加入 Google 的促销计划；未加入时，Google 会直接拒绝该子 API 请求。Microsoft Merchant Center 也提供相同范围的功能（商店、目录、商品、问题），适用于 Bing Shopping。 衡量广告带来的成效——Google Analytics 4 将整个流程串联起来。这里的其他连接器都报告广告花了多少成本；只有它会报告广告带来了什么。analytics_report 按渠道、来源/媒介、广告系列、落地页、国家/地区、设备或日期细分会话数、用户数、转化次数和收入，让 Hermoso 创建的广告系列及其带来的收入可以在同一段对话中查看。analytics_realtime 会显示当前正在访问网站的用户。 从 list_analytics_properties 开始——这些工具需要数字属性 ID，而不是跟踪代码段中的 G-XXXXXXXXX Measurement ID；此工具可将两者对应起来。它既能读取，也能写入：create_analytics_key_event 会将 GA4 已收集的事件标记为关键事件——这样才能将其作为转化导入 Google Ads——而 create_analytics_custom_dimension 会注册事件参数，以便报告按其细分；list_analytics_definitions 则会显示该属性目前衡量的内容。它使用与 Google Ads、YouTube 和 Drive 相同的 Google 账号登录，但需要单独连接。 仅支持 GA4——此 API 不提供 Universal Analytics 功能。自定义维度可以归档，但无法删除；一个属性最多可有 50 个事件范围的自定义维度。

文件——Google Drive 增删改查（save_to_drive、list_drive_files、update_drive_file、delete_drive_file、create_drive_folder）、Google Sheets（create_sheet、append_to_sheet、read_sheet）、Google Docs（create_doc、append_to_doc）以及 OneDrive（save_to_onedrive + 完整增删改查）。

工作区和账号——个人资料（list_brands、create_brand、use_brand、update_brand、delete_brand；一个账号可拥有多个个人资料，每个资料可对应一个品牌、客户、创作者或个人工作区，因此代理机构可通过这里管理所有客户）、记忆（remember、forget、list_memory）、自定义技能（save_skill、get_skill、list_skills、delete_skill——统一的技能库，已整合旧版 AI-Employee 的角色）、团队（list_team、invite_member、remove_member、set_role）、设置（get_settings、update_settings——包括所有广告、脚本和计划所使用的语言）、连接器（list_connectors、list_connector_accounts、set_connector_accounts、disconnect_connector）和账单（hermoso_credits、billing_status、buy_credits、upgrade_plan、set_auto_reload），以及用于异步渲染的 list_jobs / get_job。

连接器账号由用户选择，而非自动猜测。 一个人通常会管理多个 Facebook 公共主页、Google Ads 客户账号或 LinkedIn 公司主页。只有为某个个人资料勾选的账号才能使用——此限制由服务端强制执行；若未选择任何账号，则不会共享任何内容。关联新账号是唯一不能无界面完成的步骤（此流程需要 OAuth 授权页面，因此用户需在应用中操作）。

渲染任务会在服务端排队并轮询直至完成，随后返回可访问的 URL。

2. CLI：适用于终端 Agent 的无上下文路径

bin/hermoso.mjs 将完整的 MCP 工具集作为子进程命令公开，因此 Agent 可以通过 shell 调用，而不必携带庞大的工具清单。

npm install -g hermoso                             # installs `hermoso`
hermoso capabilities                               # valid model ids + costs (run first)
hermoso create --brand "YourBrand" --product "your best-selling product" --format image
hermoso generate image --prompt "…" --ref ./product.png --wait
hermoso generate video --prompt "…" --duration 8 --wait
hermoso competitors yourbrand.com
hermoso research "Liquid Death’s longest-running ads"

为任意命令添加 --json，即可获取机器可读的输出。

这些快捷方式是常用路径，而非功能上限。 MCP 服务提供的每个工具都可以在此调用，包括连接器默认列表中不包含的广告系列和分析工具组：

hermoso tools                          # every tool, grouped, name + one line
hermoso tools --group ads --search reddit   # narrow it
hermoso tools create_meta_campaign     # that tool's full argument schema
hermoso call create_meta_campaign --json '{"name":"…"}'   # run it
hermoso create_meta_campaign --name "…"                   # same thing, shorter

call 会通过与 MCP 服务相同的处理程序、参数验证和确认/费用限制，因此无需担心不同实现之间出现偏差。tools 和 tools <name> 会读取软件包中捆绑的注册表，因此无需密钥、网络连接或登录。

3. Skills：编码 Agent 安装的内容

skills/ 包含五个可安装的 Skill：

Skill	功能
hermoso-research	查找竞争对手，获取其实际投放的广告，并找出值得借鉴的吸睛点
hermoso-generate	从提示词生成成品图片、视频、虚拟形象片段或拼接剪辑
hermoso-ad-from-brand	根据品牌或域名生成一则契合品牌的广告，包含创意概念和文案
hermoso-product-photoshoot	将真实产品照片合成到影棚、生活方式或主视觉场景中
hermoso-marketing	完整流程：研究、创作、发布和排期、付费营销活动、效果衡量

本页顶部的每种一键安装方式都会添加这些 Skill，支持 Claude Code、Codex、Gemini CLI，也支持通过 npx skills add 安装。从克隆的仓库安装也很简单，只需复制：

cp -r skills/* ~/.claude/skills/

然后调用 /hermoso-ad-from-brand an ad for yourbrand.com, our hero product。

用自己的话提出需求

Skill 会自动选择。以下都是完整的提示词，而非命令：

• 为 [产品 + URL] 找出排名前 5 的竞争对手，获取他们过去 90 天在 Meta 和 TikTok 上最出色的广告，并结合证据告诉我最值得借鉴的 3 个吸睛点和 2 种形式。
• 为 [品牌] 制作本周的广告：采用两种吸睛点和两种形式，一则 UGC 广告、一则产品视觉广告，比例为 9:16。发布前为广告评分并检查是否符合政策。
• 这是竞争对手的广告：[链接]。分析它为何有效，然后用我的产品和品牌重构其结构，并设计一个全新的吸睛点。
• 为接下来 7 天安排社交内容，覆盖 Instagram、TikTok、X 和 LinkedIn，改编自我表现最好的帖子，并为每个平台分别撰写配文。
• 把上周表现最好的广告做成一个每天 $20 的 Meta 和 TikTok 测试营销活动，包含三个广告组，每组采用一种角度。先保持暂停，并把整个结构展示出来，供我检查。
• 汇总上个月各平台的营销活动表现。表现最好的两项创意是什么？为什么？下个月的创意简报应该如何撰写？

配置

环境变量	含义
HERMOSO_API_BASE	Hermoso API 的源地址（默认值为 https://app.hermoso.ai；如果自行运行应用，请设置为 http://localhost:3000）
HERMOSO_TOKEN	Bearer Agent 密钥（hmk_…）——连接托管应用时必需
HERMOSO_PROFILE	Profile ID，适用于拥有多个 Profile 的账户
HERMOSO_OWNER	仅适用于其他账户与您共享的 Profile（团队工作区）：填写拥有该 Profile 的账户 ID。请与 HERMOSO_PROFILE 一同设置，并将 HERMOSO_PROFILE 设为该工作区的 profileUuid（不接受 Profile 的短标识）。运行 list_brands（或在命令行中运行 hermoso list_brands）可查看您有权进入的每个工作区的这两个值。服务端会在每次请求时重新授权这对值，因此错误值会被拒绝，绝不会被信任。

mcp/http.mjs 是托管远程连接器传输层（将 URL 粘贴到 Claude.ai → Connectors）。此文件随仓库提供，便于公开审查；未通过身份验证时拒绝挂载——绝不允许匿名产生费用。

许可证

MIT © Hermoso