Hermoso 是一个营销 MCP 服务器：一个 OAuth 端点提供 922+ 个工具，让智能体可以调研某个市场中正在投放的广告、生成成品图片和视频广告、发布它们，并搭建背后的付费广告系列。Claude Code 通过一个连接就能使用全部功能。本页只讲其中的一部分：Claude Code 在 Telegram 上究竟能做什么，以及 Telegram 不允许它做什么。
将 Hermoso 连接到 Claude Code
- 一条命令，无需密钥。
已经在会话中？输入claude plugin marketplace add hermoso-ai/hermoso && claude plugin install hermoso@hermoso/plugin marketplace add hermoso-ai/hermoso，然后输入/plugin install hermoso@hermoso。它会安装五项 Hermoso 技能（research、ad-from-brand、generate、product-photoshoot 和 marketing），它们通过npx运行hermoso命令，因此不会向你的会话加载工具列表，在运行之前也不消耗任何上下文。 - 登录一次。
它会在回环地址上打开浏览器登录，与npx -y hermoso auth logingh的方式相同，并将仅所有者可读的凭证保存在~/.hermoso/config.json中。Claude Code 会在它第一次需要 Hermoso 时替你运行该命令。那台机器没有浏览器，比如 CI、远程机器或容器？请在 MCP & CLI → Terminal & API keys 下创建一个密钥，然后运行npx -y hermoso auth login --token hmk_…。密钥带有真实的花费权限，请像对待密码一样对待它。 - 可选：同时使用 MCP 服务器。如果你还希望 Hermoso 的工具出现在 Claude Code 自己的工具列表中，请在登录后运行
claude mcp add hermoso -- npx -y hermoso mcp。它读取的是同一份已保存的凭证，因此不会有密钥写入.claude.json。不使用 MCP，技能也能调用每一项工具。 - 向 Claude Code 提出需求。“调研我三个最主要竞争对手跑得最久的广告，并把最好的钩子改编成 9:16 的视频”，或者“把这条渲染好的视频发布到频道上”。由智能体挑选工具；花费由你批准。
插件和可选的 MCP 服务器访问的是同一套工具和同一个账号。区别在于上下文：工具列表会在你输入任何内容之前就加载进每个会话，而技能在命令运行之前不占用任何上下文。
然后在 Hermoso 的 设置 → 连接器 中连接 Telegram 本身，只需一次：粘贴来自 @BotFather 的机器人令牌，并将该机器人添加为你频道的管理员。没有授权页面：令牌就是凭证，而机器人是发布者。
Claude Code 可以使用的 Telegram 工具
post_to_telegram：以你的机器人身份向你指定的聊天发送消息：最多 4,096 个字符的文字，或一张照片、一个视频，或 2 至 10 项的相册（照片和视频可混合）。schedule_post：附带其chatId进行排队，与其他所有渠道在同一日历上。list_telegram_chats：过去 24 小时内向机器人发过消息的聊天。它有助于查找 ID，但它不是机器人所在的所有聊天的列表。edit_telegram_message / pin_telegram_message：修正消息的文字或文案而不丢失其浏览量，以及置顶或取消置顶行动号召。create_telegram_invite_link：为每个活动创建一个命名的邀请链接，可选择设置有效期、成员上限或入群审批，以便你看清谁从哪里加入。telegram_account：聊天的订阅者或成员数量、标题、描述和邀请链接。list_telegram_dms：过去 24 小时内发给机器人的内容，最新的在前，便于用post_to_telegram回复。delete_telegram_message：在 Telegram 的 48 小时窗口内删除机器人发出的消息，并需经过确认步骤。
Telegram 使用机器人令牌连接，而不是登录页面。在 Telegram 中通过 @BotFather 创建机器人，在 设置 → 连接器 中粘贴其令牌，然后将机器人以具有“发布消息”权限的管理员身份添加到你的频道，或以可以发帖的成员身份添加到群组。Hermoso 以该机器人身份发布，绝不以你的身份发布。Telegram 自身有两个限制，规划时需要留意：机器人拿不到每条帖子的浏览量，也没有帖子历史，因此订阅者数和命名邀请链接就是你能拿到的数据；发给机器人的消息会保留 24 小时，之后就消失了。发布不消耗积分。
在自动化任何操作之前，值得了解的 Telegram 限制
| 文字 | Telegram 消息最多 4,096 个字符，但一旦附加了照片或视频就只有 1,024 个，因为文字会变成说明文字。该限制在帖子创建或排队时即执行，因此超长帖子会在你仍在场时被拒绝，方便你修改，而不是在发出途中被悄悄截断。 |
|---|---|
| 可见性 | 已发送或未发送，没有草稿、未列出或私密形式。谁能看到，由聊天决定：“发到私密群组或频道，只有其成员能看到。”silent 会静默发送、不带提示音，但不会改变谁能看到这条消息。 |
| 轮播 | 2 至 10 项的相册，照片和视频可以混合。这两个边界都是 Telegram 自己的规定，来自 Bot API 的 sendMediaGroup（“必须包含 2-10 项”），混合也是它的规定。相册只显示一条文案，位于第一项上。Hermoso 上传文件而不是传递链接，这将 Telegram 的上限提高到每张照片 10MB、每个视频 50MB。 |
| 使用哪个账户 | chatId，每条帖子都必填：公开频道的 @用户名或数字 ID（超级群组或频道以 -100 开头）。Bot API 没有列出机器人所在聊天的方法，因此 Hermoso 无从得知，也从不猜测。 |
在 Claude Code 中试一试
用日常语言提出需求即可。这些都是普通句子，不是某种专用语法：
“把 ./out/launch 中的四张图片作为一个 Telegram 相册发送到聊天 -1001234567890，配文取自 ./copy/tg.txt，并记录消息 ID。”
这会依次执行 render_ad → post_to_telegram → pin_telegram_message → create_telegram_invite_link。Claude Code 会在运行工具前先询问，而且全部过程都记录在终端里，因此发布这一步你在按下 y 之前就能看清。
Claude Code 在 Telegram 上：真正棘手的部分
只要附上媒体，两种文字长度限制就同时适用，并以更严格的那个为准：纯文字消息为 4,096 个字符，配文为 1,024 个字符，相册只在第一项上显示一条配文。Hermoso 会上传文件，而不是把链接交给 Telegram，因此单张图片上限提高到 10MB，单个视频上限提高到 50MB。请保存消息 ID。编辑和删除都需要它，而且 Telegram 不会给机器人提供之后再查找的方式。
该插件不携带工具清单，这在长时间无人值守的运行中最为重要：智能体会为每个步骤调用 hermoso 命令，而任何命令加上 --json 都会提供机器可读的输出以供断言。
发布前先调研 Telegram
Hermoso 中没有 Telegram 广告库，也没有频道搜索，因此它不声称在 Telegram 上做竞争对手研究。请在创意公开可见的地方进行研究（Meta、Google 和 LinkedIn 广告库，加上有机的 TikTok、Instagram、YouTube、Reddit 和 Threads），然后在这里发布成品广告。
付费部分
Hermoso 中没有 Telegram 广告，我们也不暗示有。这里的 Telegram 是你通过自己的机器人运营的频道：发布、置顶、编辑、统计订阅者并跟踪邀请。付费工具涵盖 Meta、Google Ads、Microsoft Advertising、Reddit Ads、LinkedIn、Pinterest、X Ads、TikTok Ads、Snapchat Ads、ChatGPT Ads、Apple Search Ads 和 AppLovin Ads。
Claude Code 自己无法完成的事
一个掌握预算的智能体，只有在影响范围有界的情况下才有用，所以这道围栏设在服务器里，而不是提示词里。每个广告系列、广告组、广告分组和广告都以暂停状态创建，而会真正动用资金的状态切换，若没有明确的确认标记就拒绝执行。每次渲染前都会先报价（hermoso_capabilities 会在任何花费发生之前公布每个模型的确切积分成本）。积分在第一次调用服务商之前就会预留，之后按确切成本结算，因此派发失败会退款，而不是让你白白付费。删除操作同样需要确认；并且在智能体告诉你它搭建了什么之前，每个广告系列结构都会从广告平台回读。
有一步是刻意留给你的：通过 @BotFather 创建机器人，并把它添加到你的频道。之后的一切都是工具调用。
其余的矩阵
从 Claude Code 发布到： Facebook · Instagram · Threads · TikTok · YouTube · X · LinkedIn · Pinterest · Bluesky。或查看 Claude Code 可发布的全部平台。
从以下工具发布到 Telegram： Claude · ChatGPT · Cursor · Codex · Cline · OpenClaw · Grok Bot · Hermes · Gemini CLI · Perplexity · Le Chat · Claude Cowork · Perplexity Computer · Paperclip · Claude Code 营销
常见问题
Claude Code 能发布到 Telegram 吗？
可以，使用 Hermoso 的 Claude Code 插件。一条命令：claude plugin marketplace add hermoso-ai/hermoso && claude plugin install hermoso@hermoso，或在会话中输入 /plugin marketplace add hermoso-ai/hermoso，然后 /plugin install hermoso@hermoso。它会安装五项驱动 hermoso CLI 的 Hermoso 技能，因此不会向你的会话加载工具列表。使用 npx -y hermoso auth login 登录一次，它会打开浏览器并自行保存凭证，因此无需创建或粘贴任何密钥。之后 Claude Code 就拥有 922+ 个工具，包括发布到 Telegram 的工具，以及研究你所在市场正在投放的广告并最终渲染创意的工具。
如何将 Telegram 连接到 Claude Code？
两个步骤，各做一次。一条命令：claude plugin marketplace add hermoso-ai/hermoso && claude plugin install hermoso@hermoso，或在会话内执行 /plugin marketplace add hermoso-ai/hermoso，然后执行 /plugin install hermoso@hermoso。它会安装五个驱动 hermoso CLI 的 Hermoso 技能，因此不会把工具列表加载进你的会话。用 npx -y hermoso auth login 登录一次，它会打开浏览器并自行保存凭证，无需创建密钥，也无需粘贴。然后通过 @BotFather 在 Telegram 中创建机器人，把它的令牌粘贴到 Hermoso 的 设置 → 连接器 中，并把机器人加为频道管理员，授予“发布消息”权限。之后，Claude Code 发布到 Telegram 就像普通的工具调用一样，每次都会指明发布到哪个聊天。
Claude Code 需要我的 Telegram 密码吗？
不会。Telegram 通过你在 @BotFather 中创建的机器人连接，Hermoso 只持有该机器人的令牌，因此 Claude Code 始终以机器人身份发布，绝不以你的个人 Telegram 账号身份。你随时可以在 @BotFather 中撤销该令牌，而且它绝不会交给模型。
Claude Code 能为 Telegram 帖子设定未来的发布时间吗？
可以。schedule_post 会把它排进与其他所有渠道共用的同一个日历，如果文案需要不同，还可以为该渠道设置单独的文案；list_scheduled 和 cancel_scheduled 可以读取并撤回它。Telegram 是可以排队的十一个渠道之一。
Claude Code 能发布 Telegram 轮播吗？
可以，作为 2 至 10 项的相册，照片和视频可以混合，这是 Telegram 自己对 sendMediaGroup 的规定。相册只带一条文案，位于第一项上。无论哪种方式，Claude Code 调用的都是同一个发布工具；无法承载轮播的渠道会被拒绝，并附上真实原因。
从 Claude Code 发布到 Telegram 要花多少钱？
发布到 Telegram 不消耗积分，因为 Telegram 不对每次调用收费。积分用于生成创意。方案为每月 $29、$69 和 $149，分别包含 1,200、3,000 和 7,000 积分，每个功能在包括 Free 在内的所有方案中都可用。唯一的例外是企业版 SSO。