Hermoso 是一个营销 MCP 服务器：通过一个经 OAuth 授权的端点提供 922+ 个工具，让智能体研究你所在市场正在投放的广告、生成成品图片和视频广告、发布它们，并搭建背后的付费广告系列。Claude Code 通过一个连接就能使用全部功能。本页只讲其中一部分：Claude Code 在 X 上实际能做什么，以及 X 不允许它做什么。
将 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 的 设置 → 连接器 中连接 X 本身，只需一次。这是一个 OAuth 授权页面，所以这是唯一需要浏览器的一步。之后的一切都是工具调用。
Claude Code 可用的 X 工具
post_to_x：发布文字、带替代文本的图片或视频、整串帖子、回复、引用帖子或投票，并可限制谁能回复。post_x_article：发布长文 Article。用 Markdown 编写，标题、列表、引用、链接、代码块和表格都会完整保留。edit_x_post：在 X 允许的一小时内，重写你已经发布的帖子。schedule_post：将其排入共享日历。x_post_metrics：帖子的公开数据。x_post_insights：仅限最近 28 小时的广告主级数据：展示次数、链接点击、主页访问、视频播放和完播四分位。x_post_insights_historical：同样的数据，可按任意日期范围查询，每次最多 25 条帖子。“上个月表现如何”就用它。x_mentions：谁在谈论这个品牌。delete_x_post：删除帖子。
X 是唯一按次调用收费的连接器，而且费用是公开的，不是隐藏的。Meta、TikTok、LinkedIn、YouTube、Threads 和 Drive 的每次请求都不收费；X 会向我们收费，所以这些调用每次只消耗少量积分。一条普通帖子每次请求 $0.015，一条带链接的帖子 $0.200，约贵 13 倍。删除、读取和替代文本的元数据写入各有自己的价格，洞察数据则按返回的帖子数计费。链接检测特意倾向于假定帖子含有链接，因为判断错误的代价是 13 倍。实际结论是：在 X 上，一条好帖子胜过五条，而且你的智能体在发帖前就能看到报价。字数上限取决于发帖账号，而不是固定的 280。Hermoso 会读取该账号自己的 X 订阅，在 Premium 允许的范围内最多发送 25,000 个字符，因此长帖会完整发出，而不会被拒绝，也绝不截断。这恰好也是更省钱的做法：一条长帖是一次计费的 X 调用，而同样的内容拆成五条帖子就是五次。X Premium 还为你解锁了 Hermoso 能代为发布的两项功能：长文 Article（用 Markdown 编写，标题、列表、引用、代码块和表格完整保留），以及在 X 允许的一小时内对已发布帖子进行的编辑。
在自动化之前需要了解的 X 限制
| 文字 | 字数上限取决于发帖账号：普通账号为 280 个字符，X Premium 为 25,000 个字符。Hermoso 从 X 读取订阅信息，因此长帖会完整发出，绝不截断。该限制在帖子创建或排队时即执行，因此超长帖子会在你仍在场时被拒绝，方便你修改，而不是在发出途中被悄悄截断。 |
|---|---|
| 可见性 | 仅公开。X 上的帖子一经存在即为公开。API 没有草稿，也没有未列出的帖子。确实存在受保护的账号，但那是账号级别的设置，Hermoso 既不读取也不控制，并非按帖子选择的。 |
| 轮播 | 按具体原因明确拒绝。“X 没有可左右滑动的轮播。”它的 API 最多为一条帖子附加 4 个媒体，它们会以网格形式呈现，所有图片同时可见，没有可滑动的内容，因此编号为“1/6 · SWIPE”的幻灯片组无法按原样发布到 X。拒绝信息会说明替代做法：“仅发布最有力的一张幻灯片到 X，或将 X 从本帖中移除。”一组要求读者滑动、却以网格形式发布的幻灯片，比不发布更糟。 |
| 使用哪个账户 | 无。X 只发布到已连接的账号。 |
在 Claude Code 中试一试
用日常语言提出需求即可。这些都是普通句子，不是某种专用语法：
“把 ./notes/launch.md 改写成不超过五条帖子的 X 串帖，链接只放在最后一条，发布前先告诉我费用。”
这会依次执行 get_brand → generate_text → post_to_x → x_post_insights_historical。Claude Code 会在运行工具前先询问，而且全部过程都记录在终端里，因此发布这一步你在按下 y 之前就能看清。
Claude Code 在 X 上的棘手之处
把链接只放在一条帖子里，而不是每条都放。带链接的帖子费用约为普通帖子的 13 倍，因此每条都带链接的串帖是最贵的写法，而且链接检测会有意偏向判定为含链接。超长的文案会被拒绝而不是截断，并计算超出的部分。在脚本里，这意味着一个干净的、可处理的失败，而不是只发出一半的帖子。
该插件不携带工具清单，这在长时间无人值守的运行中最为重要：智能体会为每个步骤调用 hermoso 命令，而任何命令加上 --json 都会提供机器可读的输出以供断言。
发帖前先研究 X
没有可以搜索的 X 广告库。这里对 X 的研究限于你自己的账号：提及、帖子数据以及广告主的历史数据。研究范围中的其他部分不受影响：Meta、Google 和 LinkedIn 广告库，以及有机的 TikTok、Instagram、YouTube、Reddit 和 Threads。
付费部分
X Ads 于 2026 年 8 月上线，因此 X 现在两个方面都覆盖了。X Ads API 是另一款产品，使用独立的主机和自己的 OAuth 1.0a 签名，这也是它晚于其他功能到来的原因。Hermoso 现在在其上构建完整的推广帖子体系：广告系列、广告项（X 对广告组的称呼）、推广帖子、定向、预算、状态和报告。X 广告推广的是一条帖子，因此广告素材就是一条帖子，也就是 Hermoso 自然发布的那一条。与其他十一个平台一样，启动真实资金的开关在没有明确确认的情况下拒绝运行。规划预算前需要知道一点：X 按广告账号而不是按应用授予 Ads API 访问权限，因此没有 OAuth 按钮。你需要在 business.x.com → Account access 中，把 Hermoso 的 X 用户添加到你的广告账号，它随后就会出现在 list_x_ads_accounts 中，并带有 X 授予的权限级别。
Claude Code 自己无法完成的事
一个掌握预算的智能体，只有在影响范围有界的情况下才有用，所以这道围栏设在服务器里，而不是提示词里。每个广告系列、广告组、广告分组和广告都以暂停状态创建，而会真正动用资金的状态切换，若没有明确的确认标记就拒绝执行。每次渲染前都会先报价（hermoso_capabilities 会在任何花费发生之前公布每个模型的确切积分成本）。积分在第一次调用服务商之前就会预留，之后按确切成本结算，因此派发失败会退款，而不是让你白白付费。删除操作同样需要确认；并且在智能体告诉你它搭建了什么之前，每个广告系列结构都会从广告平台回读。
有一步刻意不能无头完成：连接账户是一个 OAuth 授权页面，因此你需要在浏览器中连接一次该渠道。之后的一切都是工具调用。
其余的矩阵
从 Claude Code 发布到： Facebook · Instagram · Threads · TikTok · YouTube · LinkedIn · Pinterest · Bluesky · Telegram。或查看 Claude Code 可发布的全部平台。
从以下工具发布到 X： Claude · ChatGPT · Cursor · Codex · Cline · OpenClaw · Grok Bot · Hermes · Gemini CLI · Perplexity · Le Chat · Claude Cowork · Perplexity Computer · Paperclip · Claude Code 营销
常见问题
Claude Code 能在 X 上发帖吗？
可以，使用 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+ 个工具，包括发布到 X 的工具，以及研究你所在市场正在投放的广告并从头渲染创意的工具。
如何把 X 连接到 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 登录一次，它会打开浏览器并自行保存凭证，无需创建密钥，也无需粘贴。然后在 Hermoso 的 设置 → 连接器 中连接 X，这是浏览器中的 OAuth 授权页面。之后，Claude Code 发布到 X 就像普通的工具调用一样。
Claude Code 需要我的 X 密码吗？
不需要。你只需在浏览器中通过 OAuth 授权页面把 X 连接到 Hermoso 一次，之后 Claude Code 就通过工具调用来访问它。关联账号是唯一不能无人值守完成的一步；之后的一切都不需要密码，也绝不会把凭证交给模型。
Claude Code 能为 X 帖子设置稍后发布吗？
可以。schedule_post 会把它排入与其他所有渠道共享的同一个日历，如果文案需要不同，可以为每个渠道单独设置。list_scheduled 和 cancel_scheduled 可以读取并撤回排期。X 是可以排队的十一个渠道之一。
Claude Code 能在 X 上发布轮播吗？
不能。X 的 API 最多为一条帖子附加四个媒体，它们会以网格形式呈现，所有图片同时可见，没有可以左右滑动的内容，因此编号的幻灯片组无法按原样发布到 X。无论哪种方式，Claude Code 调用的都是同一个发布工具；无法承载轮播的渠道会被拒绝，并附上真实原因。
从 Claude Code 发布到 X 要花多少钱？
X 是唯一按次调用计积分的连接器，因为 X 按每次 API 请求收费：一条普通帖子约 $0.015，一条带链接的帖子约 $0.200，贵约 13 倍。你的智能体在发帖前会先看到报价。方案为每月 $29、$69 和 $149，分别包含 1,200、3,000 和 7,000 积分，每个功能在包括 Free 在内的所有方案中都可用。唯一的例外是企业版 SSO。