Hermoso 是一个营销 MCP 服务器：一个 OAuth 端点提供 922+ 个工具，让智能体可以调研某个市场中正在投放的广告、生成成品图片和视频广告、发布它们，并搭建背后的付费广告系列。Codex 通过一个连接就能使用全部功能。本页只讲其中的一部分：Codex 在 Pinterest 上究竟能做什么，以及 Pinterest 不允许它做什么。
将 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 的“设置 → 连接器”中连接 Pinterest 本身，只需一次。这是一个 OAuth 授权页面，所以这是唯一需要浏览器的步骤。之后的一切都是工具调用。
Codex 可以使用的 Pinterest 工具
list_pinterest_boards：账号的画板，包括私密画板，并附带其 ID。create_pinterest_board：创建新画板。post_to_pinterest：在你指定的画板上创建图片或视频 Pin，并设置标题、描述、目标链接和替代文本。schedule_post：将 Pin 排队，并携带boardId。list_pinterest_ads_campaigns / pinterest_ads_report：读取付费广告的数据。
规划 Pinterest 工作流之前需要知道的限制：本应用持有 Trial 访问权限，而 Pinterest 在生产环境中拒绝 Trial 权限下的 Pin 创建。这是他们自己的说法，我们在第一条真实 Pin 上发现的：“持有 Trial 访问权限的应用不得在生产环境中创建 Pin。”画板和读取在 Trial 下可以使用（列出画板、创建画板、读取 Pin）。Hermoso 的错误会指出访问级别，而不是让你重新连接，因为重新连接无法解决问题。升级到 Standard 访问权限才能解除 Pin 创建的限制，该申请正在审核中。同一层级也限制了付费一侧：在 Trial 下，Pinterest 完全不暴露任何广告账号。
在自动化任何操作之前，值得了解的 Pinterest 限制
| 文字 | Pin 描述上限为 800 个字符，Pin 标题上限为 100 个字符。该限制在帖子创建或排队时即执行，因此超长帖子会在你仍在场时被拒绝，方便你修改，而不是在发出途中被悄悄截断。 |
|---|---|
| 可见性 | 公开，而控制权在画板而非 Pin 本身。Pin 继承其画板的公开或私密状态，因此“发到某个私密地方”需要通过选择私密画板来表达。这就是画板是必填参数而非默认值的原因。 |
| 轮播 | 2 至 5 张图片，仅限图片。这两个边界直接来自 Pinterest 自己的 v5 OpenAPI（minItems: 2、maxItems: 5），这是 Pinterest 发布的唯一机器可读来源（其开发者网站是客户端渲染的应用，对抓取没有任何返回内容）。没有多视频的来源，因此视频幻灯片会被拒绝，而不是被丢弃。 |
| 使用哪个账户 | boardId，它是唯一在排队时而非发布时就被拒绝的身份字段。如果省略它，内容就不会被排期，因为“放错画板的 Pin 是一个公开的错误，所以我们从不替你选择”。 |
在 Codex 中试一试
用日常语言提出需求即可。这些都是普通句子，不是某种专用语法：
“非交互模式：对订阅源中的每个新产品，生成一张竖版 Pin 图片、一个标题和一段描述，并以 JSON 格式将整批内容暂存。”
这会依次执行 list_pinterest_boards → plan_ad → generate_image → post_to_pinterest。交互使用时，Codex 会在运行前显示该调用。非交互使用时没有人可以确认，因此在任何发布或花费的步骤上，都值得专门设计应对方式。
Codex 在 Pinterest 上：真正棘手的部分
暂存，而不是发布。在 Trial 访问下，无人值守任务若尝试在生产环境中创建 Pin，每一项都会失败，而任何重试策略都无法解决访问级别的问题。画板可以读写，因此结构可以真正搭建起来；boardId 会在入队时被拒绝，而不是在触发时才拒绝。对于定时运行来说，这就是现在一次干净的失败与之后一次无声失败的区别。
对于无人值守运行，相较于完整的工具清单，请优先使用带 --json 的 hermoso CLI。它占用的上下文要少得多，也更便于断言。
发布前先调研 Pinterest
没有 Pinterest 广告库，因此 Hermoso 不声称能对 Pinterest 进行竞争对手研究。你要在那里投放的创意，由工作室的其他部分充分覆盖：make_template_ad 和图像模型可以制作该平台所青睐的竖版、以文字为主的静态图。
付费部分
Pinterest 广告工具存在于广告系列、广告组以及推广现有 Pin 的广告中，并采用归档而非删除的方式，因为 Pinterest 的 ADS API 没有删除操作（有机的 Pin 和画板可以删除，通过 delete_pinterest_pin 和 delete_pinterest_board；只有付费对象只能归档）。但同样限制创建 Pin 的 Trial 访问层级也不暴露任何广告账号，因此在 Standard 访问权限开通之前，广告写入无法使用。这是诚实的现状，用一句话在这里说明，比在截止日期前才发现要好得多。
Codex 自己无法完成的事
一个掌握预算的智能体，只有在影响范围有界的情况下才有用，所以这道围栏设在服务器里，而不是提示词里。每个广告系列、广告组、广告分组和广告都以暂停状态创建，而会真正动用资金的状态切换，若没有明确的确认标记就拒绝执行。每次渲染前都会先报价（hermoso_capabilities 会在任何花费发生之前公布每个模型的确切积分成本）。积分在第一次调用服务商之前就会预留，之后按确切成本结算，因此派发失败会退款，而不是让你白白付费。删除操作同样需要确认；并且在智能体告诉你它搭建了什么之前，每个广告系列结构都会从广告平台回读。
有一步刻意不能无头完成：连接账户是一个 OAuth 授权页面，因此你需要在浏览器中连接一次该渠道。之后的一切都是工具调用。
其余的矩阵
从 Codex 发布到： Facebook · Instagram · Threads · TikTok · YouTube · X · LinkedIn · Bluesky · Telegram。或查看 Codex 可发布的全部平台。
从以下工具发布到 Pinterest： Claude · ChatGPT · Claude Code · Cursor · Cline · OpenClaw · Grok Bot · Hermes · Gemini CLI · Perplexity · Le Chat · Claude Cowork · Perplexity Computer · Paperclip · 从命令行投放广告
常见问题
Codex 能发布到 Pinterest 吗？
可以，通过 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+ 个工具，包括发布到 Pinterest 的工具，以及研究你所在市场正在投放的广告并从头渲染创意的工具。
如何将 Pinterest 连接到 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 的 设置 → 连接器 中连接 Pinterest，这是浏览器中的 OAuth 授权页面。之后，Codex 发布到 Pinterest 就像普通的工具调用一样。
Codex 需要我的 Pinterest 密码吗？
不需要。你只需在浏览器中通过 OAuth 授权页面把 Pinterest 连接到 Hermoso 一次，之后 Codex 会以工具调用的方式访问它。连接账户是唯一不能无头完成的步骤；之后的任何步骤都不需要密码，也从不会把任何凭据交给模型。
从 Codex 发布到 Pinterest 要花多少钱？
Pinterest 不对每次 API 调用收费，因此发布不消耗积分。积分用于生成 Pin 创意。方案为每月 $29、$69 和 $149，分别包含 1,200、3,000 和 7,000 积分，每个功能在包括 Free 在内的所有方案中都可用。唯一的例外是企业版 SSO。
Codex 能发布 Pinterest 轮播吗？
原则上可以：2 至 5 张图片，仅限图片，直接来自 Pinterest 自己的 v5 OpenAPI。实际上，只要该应用持有 Trial 访问权限，Pin 的创建在生产环境中就会被阻止。无论哪种情况，Codex 调用的都是同一个发布工具；无法承载轮播的渠道会被拒绝，并附上真实原因。
Codex 能为 Pinterest 帖子设定未来的发布时间吗？
可以。schedule_post 会把它排进与其他所有渠道共用的同一个日历，如果文案需要不同，还可以为该渠道设置单独的文案；list_scheduled 和 cancel_scheduled 可以读取并撤回它。Pinterest 是可以排队的十一个渠道之一。