Hermoso 是一个营销 MCP 服务器：通过一个经 OAuth 授权的端点提供 922+ 个工具，让智能体研究你所在市场正在投放的广告、生成成品图片和视频广告、发布它们，并搭建背后的付费广告系列。Codex 通过一个连接就能使用全部功能。本页只讲其中一部分：Codex 在 X 上实际能做什么，以及 X 不允许它做什么。
将 Hermoso 连接到 Codex
- 一条命令，无需密钥。
Codex 会读取 Hermoso 公开仓库中的市场文件，并安装其五项技能（research、ad-from-brand、generate、product-photoshoot 和 marketing）。这些技能通过codex plugin marketplace add hermoso-ai/hermoso && codex plugin add hermoso@hermosonpx运行hermoso命令，因此不会向你的会话加载任何工具列表，在命令运行之前也不占用上下文。 - 只需登录一次。
它会打开浏览器进行登录，并将仅限所有者访问的凭证保存在npx -y hermoso auth login~/.hermoso/config.json中。如果该机器没有浏览器（例如 CI 或容器），请在 MCP & CLI → 终端与 API 密钥 中创建一个密钥，然后运行npx -y hermoso auth login --token hmk_…。密钥拥有真实的花费权限，请像对待密码一样对待它。 - 可选：同时配置 MCP 服务器。
这会把服务器写入codex mcp add hermoso -- npx -y hermoso mcp~/.codex/config.toml，并读取同一份已保存的凭证，因此文件中不包含任何密钥。想使用托管端点？运行codex mcp add hermoso --url https://app.hermoso.ai/mcp，然后运行codex mcp login hermoso完成 OAuth 登录。无论哪种方式，技能都能调用全部工具。 - 向 Codex 提出需求。“调研我三个最主要竞争对手跑得最久的广告，并把最好的钩子改编成 9:16 的视频”，或者“把这条渲染好的视频发布到频道上”。由智能体挑选工具；花费由你批准。
Codex 将 MCP 服务器保存在 ~/.codex/config.toml 中，或在受信任的项目中保存在 .codex/config.toml 中，而且该文件是 TOML 而非 JSON：直接复制 mcpServers 代码块无法加载，手写的条目应为 [mcp_servers.hermoso]，其中 command = "npx"，args = ["-y", "hermoso", "mcp"]。末尾的 mcp 不可省略：只写 npx -y hermoso 而没有子命令，会打印帮助信息后退出。Codex 读取插件市场时使用的是 Claude Code 所用的同一 .claude-plugin 布局，这也是同一个仓库能在两者中安装的原因。
然后在 Hermoso 的 设置 → 连接器 中连接 X 本身，只需一次。这是一个 OAuth 授权页面，所以这是唯一需要浏览器的一步。之后的一切都是工具调用。
Codex 可用的 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 只发布到已连接的账号。 |
在 Codex 中试一试
用日常语言提出需求即可。这些都是普通句子，不是某种专用语法：
“非交互模式：每次发布一条 X 更新，每条不超过 280 个字符，链接只放在这一条帖子中，并记录计费金额。”
这会依次执行 get_brand → generate_text → post_to_x → x_post_insights_historical。交互使用时，Codex 会在运行前显示该调用。非交互使用时没有人可以确认，因此在任何发布或花费的步骤上，都值得专门设计应对方式。
Codex 在 X 上的棘手之处
这一项要有意控制预算。每次发帖、删除和读取都是一次计费请求，数据分析按返回的每条帖子计费，而带链接的帖子费用约为普通帖子的 13 倍。对于无人值守的任务，这意味着：每个事件发一条帖子而不是串帖，只放一个链接而不是多个，并限制任务的运行频率。字数超限会被干净地拒绝，因此失败的任务会明确报错，而不会发出一条只说了一半的帖子。
对于无人值守运行，相较于完整的工具清单，请优先使用带 --json 的 hermoso CLI。它占用的上下文要少得多，也更便于断言。
发帖前先研究 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 授予的权限级别。
Codex 自己无法完成的事
一个掌握预算的智能体，只有在影响范围有界的情况下才有用，所以这道围栏设在服务器里，而不是提示词里。每个广告系列、广告组、广告分组和广告都以暂停状态创建，而会真正动用资金的状态切换，若没有明确的确认标记就拒绝执行。每次渲染前都会先报价（hermoso_capabilities 会在任何花费发生之前公布每个模型的确切积分成本）。积分在第一次调用服务商之前就会预留，之后按确切成本结算，因此派发失败会退款，而不是让你白白付费。删除操作同样需要确认；并且在智能体告诉你它搭建了什么之前，每个广告系列结构都会从广告平台回读。
有一步刻意不能无头完成：连接账户是一个 OAuth 授权页面，因此你需要在浏览器中连接一次该渠道。之后的一切都是工具调用。
其余的矩阵
从 Codex 发布到： Facebook · Instagram · Threads · TikTok · YouTube · LinkedIn · Pinterest · Bluesky · Telegram。或查看 Codex 可发布的全部平台。
从以下工具发布到 X： Claude · ChatGPT · Claude Code · Cursor · Cline · OpenClaw · Grok Bot · Hermes · Gemini CLI · Perplexity · Le Chat · Claude Cowork · Perplexity Computer · Paperclip · 从命令行投放广告
常见问题
Codex 能在 X 上发帖吗？
可以，通过 Hermoso 的 Codex 插件。运行 codex plugin marketplace add hermoso-ai/hermoso && codex plugin add hermoso@hermoso，即可安装 Hermoso 的技能，然后用 npx -y hermoso auth login 登录一次。登录会打开浏览器并自行保存凭证，无需创建密钥，也无需粘贴。如需同时使用 MCP 服务器，请运行 codex mcp add hermoso -- npx -y hermoso mcp。随后 Codex 便拥有 922+ 个工具，包括发布到 X 的工具，以及研究你所在市场正在投放的广告并从头渲染创意的工具。
如何把 X 连接到 Codex？
两个步骤，各做一次。运行 codex plugin marketplace add hermoso-ai/hermoso && codex plugin add hermoso@hermoso，即可安装 Hermoso 的技能，然后用 npx -y hermoso auth login 登录一次。登录会打开浏览器并自行保存凭证，无需创建密钥，也无需粘贴。如需同时使用 MCP 服务器，请运行 codex mcp add hermoso -- npx -y hermoso mcp。然后在 Hermoso 的 设置 → 连接器 中连接 X，这是浏览器中的 OAuth 授权页面。之后，Codex 发布到 X 就像普通的工具调用一样。
Codex 能在 X 上发布轮播吗？
不能。X 的 API 最多为一条帖子附加四个媒体，它们会以网格形式呈现，所有图片同时可见，没有可以左右滑动的内容，因此编号的幻灯片组无法按原样发布到 X。无论哪种方式，Codex 调用的都是同一个发布工具；无法承载轮播的渠道会被拒绝，并附上真实原因。
从 Codex 发布到 X 要花多少钱？
X 是唯一按次调用计积分的连接器，因为 X 按每次 API 请求收费：一条普通帖子约 $0.015，一条带链接的帖子约 $0.200，贵约 13 倍。你的智能体在发帖前会先看到报价。方案为每月 $29、$69 和 $149，分别包含 1,200、3,000 和 7,000 积分，每个功能在包括 Free 在内的所有方案中都可用。唯一的例外是企业版 SSO。
Codex 需要我的 X 密码吗？
不需要。你只需在浏览器中通过 OAuth 授权页面把 X 连接到 Hermoso 一次，之后 Codex 就通过工具调用来访问它。关联账号是唯一不能无人值守完成的一步；之后的一切都不需要密码，也绝不会把凭证交给模型。
Codex 能为 X 帖子设置稍后发布吗？
可以。schedule_post 会把它排入与其他所有渠道共享的同一个日历，如果文案需要不同，可以为每个渠道单独设置。list_scheduled 和 cancel_scheduled 可以读取并撤回排期。X 是可以排队的十一个渠道之一。