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