Hermoso 是一个营销 MCP 服务器：一个 OAuth 端点提供 922+ 个工具，让智能体可以调研某个市场中正在投放的广告、生成成品图片和视频广告、发布它们，并搭建背后的付费广告系列。Gemini CLI 通过一个连接就能使用全部功能。本页只讲其中的一部分：Gemini CLI 在 YouTube 上究竟能做什么，以及 YouTube 不允许它做什么。
将 Hermoso 连接到 Gemini CLI
- 安装扩展。
它会安装 Hermoso 公开仓库的最新发布版本：五个技能（research、ad-from-brand、generate、product-photoshoot 和 marketing），外加一个gemini extensions install https://github.com/hermoso-ai/hermosoGEMINI.md上下文文件。这些技能通过npx运行hermoso命令，因此不会向 Gemini CLI 的工具列表中添加任何内容，在命令运行之前也不占用上下文。gemini extensions list会将它们显示在 Agent skills 下。 - 登录一次。
它会打开浏览器登录，并将仅限所有者访问的凭证保存到npx -y hermoso auth login~/.hermoso/config.json。Gemini CLI 在首次需要 Hermoso 时可以替你运行它。该机器上没有浏览器？请在 MCP & CLI → 终端与 API 密钥下创建一个密钥，然后运行npx -y hermoso auth login --token hmk_…。 - 可选：同时添加 MCP 服务器。
当首次连接返回 401 时，Gemini CLI 会找到 Hermoso 的授权服务器并自行注册，因此无需在gemini mcp add --scope user --transport http hermoso https://app.hermoso.ai/mcpsettings.json中填写任何密钥；在会话中运行/mcp auth hermoso即可完成登录。没有它，技能也能调用所有工具。 - 向 Gemini CLI 提出需求。“调研我三个最主要竞争对手跑得最久的广告，并把最好的钩子改编成 9:16 的视频”，或者“把这条渲染好的视频发布到频道上”。由智能体挑选工具；花费由你批准。
我们于 2026-09-23 在干净的主目录中，针对 Gemini CLI 0.60.0 运行了上述安装：它拉取了 hermoso-ai/hermoso 的当前发布版本，gemini extensions list 显示了这五个技能和上下文文件。该扩展本身不附带 MCP 服务器，这是有意为之：工具列表会加载到每个会话中，而技能在运行之前不产生任何开销。Hermoso 与 Google 没有隶属关系，也未获得其认可。
然后在 Hermoso 的“设置 → 连接器”中连接 YouTube 本身，只需一次。这是一个 OAuth 授权页面，所以这是唯一需要浏览器的步骤。之后的一切都是工具调用。
Gemini CLI 可以使用的 YouTube 工具
post_to_youtube：上传已完成的视频，并附带标题、最多 5,000 个字符的描述、最多 30 个标签，以及隐私设置。schedule_post：将上传排队，并连同描述和标签一起携带过去。set_youtube_thumbnail：为上传的视频设置精心设计的缩略图。它是点击率最大的单一杠杆，而 YouTube 否则会或多或少随机地挑选一帧。make_thumbnail：首先生成该缩略图。update_youtube_video / list_youtube_videos：编辑已上传视频的元数据，或列出你自己的上传内容，包括公共搜索看不到的不公开和私密视频。youtube_video_insights / youtube_channel：播放量、观看时长、平均观看百分比以及新增订阅者。list_youtube_comments / reply_to_youtube_comment：以频道身份读取并回复评论。
这个单元确实是视频：post_to_youtube 接受 videoUrl，完全没有图片路径。在自动化上传之前，还有两个较小的限制值得了解：未经验证的 Google 项目无论你要求什么，videos.insert 都会被锁定为私密；自定义缩略图需要经过手机验证的频道。
在自动化任何操作之前，值得了解的 YouTube 限制
| 文字 | YouTube 标题上限为 100 个字符，而排期项目的文字会成为标题。描述是单独的字段，最多 5,000 个字符，可附带最多 30 个标签。它会在帖子创建或排队时执行，因此超长的帖子会在你还在场时被拒绝，以便你修改，而不是在发布途中被悄悄截断。 |
|---|---|
| 可见性 | 公开、不公开或私密。没有 Studio 草稿：“YouTube 的 API 可以以公开、不公开或私密的方式上传，但无法创建 Studio 草稿”，因此不公开（unlisted）是最接近审核状态的选项，立即发布时默认就是它，这样准备投放广告的上传内容就不会意外公开。 |
| 轮播 | 按名称拒绝。“YouTube 的单元是视频，而不是一组静态图片。请把幻灯片转成视频（Hermoso 可以拼接），然后改为发布该视频，或者在这条帖子中去掉 YouTube。”这个限制不是 Hermoso 为了省事而编造的，它本身就是 YouTube 的规则。拒绝会在排队时发生，并附上可行的办法，而不是悄悄发布第一张幻灯片。 |
| 使用哪个账户 | 无。YouTube 会发布到已连接的频道。 |
在 Gemini CLI 中试一试
用日常语言提出需求即可。这些都是普通句子，不是某种专用语法：
“将 ./renders/demo.mp4 以不公开方式上传到 YouTube，标题不超过 100 个字符，简介取自 ./docs/demo.md，附上十个标签和自动生成的缩略图。”
这一流程依次调用 make_thumbnail → post_to_youtube → set_youtube_thumbnail → youtube_video_insights。Gemini CLI 在运行 shell 命令之前会先询问，而技能通过 hermoso 命令执行操作，因此一次发布会显示为一行可读的命令，你可以在确认前看清楚。对于 MCP 工具，它会提供三个选项：仅此一次、始终允许该工具，或始终允许该服务器。
Gemini CLI 在 YouTube 上：真正棘手的部分
将简介作为单独的字段传入。排期项目的文本会成为 100 字符的标题，而承载链接的 5,000 字符简介除非你另外指定，否则会留空。以不公开方式上传，因为 API 没有 Studio 草稿，待你看过之后，再用 update_youtube_video 将其改为公开。自定义缩略图需要通过手机验证的频道。
有两个 Gemini CLI 细节决定了这件事有多安全。除非你传入 --scope user，否则 gemini mcp add 会写入项目的 .gemini/settings.json，当一个仓库应该始终对应一个品牌时，这一点很有用。永远不要用 --trust 添加 Hermoso：它会跳过该服务器的所有确认，包括发布前的确认。MCP 工具会以 mcp_hermoso_ 加工具名的形式出现，而 --exclude-tools 可以将其中任何一个完全排除在外。
发布前先调研 YouTube
search_youtube 搜索的是 YouTube 的公开索引。这和“我上传过什么”是两回事，后者由 list_youtube_videos 处理。对于竞争对手的影片，analyze_video 会返回旁白、画面文字，以及带时间戳的节拍列表，这正是你在重做开场钩子之前最需要的。
付费部分
Hermoso 的 Google Ads 工具可以搭建搜索、展示和 Performance Max 广告系列（整棵广告树在一次原子操作中完成，并在你的智能体开口讲解之前从 Google 读回确认），还可以获取关键词规划师的搜索量、转化操作，以及创建并关联的站点链接和宣传信息。没有 YouTube 视频广告系列的搭建工具，也不应该暗示有；YouTube 视频素材可以上传并关联，但 Hermoso 创建的广告系列类型只有搜索、展示和 Performance Max。
Gemini CLI 自己无法完成的事
一个掌握预算的智能体，只有在影响范围有界的情况下才有用，所以这道围栏设在服务器里，而不是提示词里。每个广告系列、广告组、广告分组和广告都以暂停状态创建，而会真正动用资金的状态切换，若没有明确的确认标记就拒绝执行。每次渲染前都会先报价（hermoso_capabilities 会在任何花费发生之前公布每个模型的确切积分成本）。积分在第一次调用服务商之前就会预留，之后按确切成本结算，因此派发失败会退款，而不是让你白白付费。删除操作同样需要确认；并且在智能体告诉你它搭建了什么之前，每个广告系列结构都会从广告平台回读。
有一步刻意不能无头完成：连接账户是一个 OAuth 授权页面，因此你需要在浏览器中连接一次该渠道。之后的一切都是工具调用。
其余的矩阵
从 Gemini CLI 发布到： Facebook · Instagram · Threads · TikTok · X · LinkedIn · Pinterest · Bluesky · Telegram。或查看 Gemini CLI 可以发布的全部平台。
用以下工具发布到 YouTube： Claude · ChatGPT · Claude Code · Cursor · Codex · Cline · OpenClaw · Grok Bot · Hermes · Perplexity · Le Chat · Claude Cowork · Perplexity Computer · Paperclip
常见问题
Gemini CLI 能发布到 YouTube 吗？
可以，通过 Hermoso 的 Gemini CLI 扩展实现。运行 gemini extensions install https://github.com/hermoso-ai/hermoso，这会添加五个驱动 hermoso 命令的 Hermoso 技能，然后用 npx -y hermoso auth login 登录一次。登录会打开浏览器并自行保存凭证，因此无需创建也无需粘贴任何密钥。如果你还希望在 Gemini CLI 自己的工具列表中看到 Hermoso 的工具，可以运行 gemini mcp add --scope user --transport http hermoso https://app.hermoso.ai/mcp 添加托管服务器，它通过 OAuth 登录。之后 Gemini CLI 就拥有 922+ 个工具，包括可以发布到 YouTube 的工具，以及调研你所在市场正在投放的广告并从头渲染创意的工具。
如何将 YouTube 连接到 Gemini CLI？
两个步骤，各做一次。运行 gemini extensions install https://github.com/hermoso-ai/hermoso，这会添加五个驱动 hermoso 命令的 Hermoso 技能，然后用 npx -y hermoso auth login 登录一次。登录会打开浏览器并自行保存凭证，因此无需创建也无需粘贴任何密钥。如果你还希望在 Gemini CLI 自己的工具列表中看到 Hermoso 的工具，可以运行 gemini mcp add --scope user --transport http hermoso https://app.hermoso.ai/mcp 添加托管服务器，它通过 OAuth 登录。接着在 Hermoso 的 设置 → Connectors 中连接 YouTube，这是浏览器里的 OAuth 授权页面。完成后，Gemini CLI 就能像普通工具调用一样发布到 YouTube。
Gemini CLI 能发布 YouTube 轮播吗？
不支持，拒绝信息会说明原因，而不是只说“不支持”：YouTube 的单位是视频，而不是一组静图。Hermoso 可以把幻灯片拼接成视频再发布。无论哪种方式，Gemini CLI 调用的都是同一个发布工具；无法承载轮播的渠道会被拒绝，并附上真实原因。
Gemini CLI 能在发帖之外投放 YouTube 广告吗？
Hermoso 搭建 Google Ads 的搜索、展示和 Performance Max 广告系列，并提供关键词规划师的搜索量和转化操作。没有 YouTube 视频广告系列的搭建工具，我们也不暗示有。
Gemini CLI 需要我的 YouTube 密码吗？
不需要。你只需在浏览器中通过 OAuth 授权页面把 YouTube 连接到 Hermoso 一次，之后 Gemini CLI 会以工具调用的方式访问它。连接账户是唯一不能无头完成的步骤；之后的任何步骤都不需要密码，也从不会把任何凭据交给模型。
Gemini CLI 能在发帖之前研究 YouTube 吗？
可以。search_youtube 搜索 YouTube 公开索引，list_youtube_videos 读取你自己的上传内容（包括未列出的视频），analyze_video 则返回竞争对手影片的旁白、画面文字和带时间戳的节拍列表。