Hermoso 是一个营销 MCP 服务器:一个 OAuth 端点提供 922+ 个工具,让智能体可以调研某个市场中正在投放的广告、生成成品图片和视频广告、发布它们,并搭建背后的付费广告系列。Codex 通过一个连接就能使用全部功能。本页只讲其中的一部分:Codex 在 Instagram 上究竟能做什么,以及 Instagram 不允许它做什么。
将 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 的“设置 → 连接器”中连接 Instagram 本身,只需一次。这是一个 OAuth 授权页面,所以这是唯一需要浏览器的步骤。之后的一切都是工具调用。
Codex 可以使用的 Instagram 工具
post_to_meta:通过target: "instagram"发布到 Instagram。Instagram 是视觉渠道,API 也是如此:帖子需要图片或视频。schedule_post:将其排入共用日历;如果文案需要与你的 Facebook 或 LinkedIn 版本不同,可以为 Instagram 设置单独的文案。list_meta_comments / reply_to_meta_comment / moderate_meta_comment:读取、回复和管理帖子下的评论。meta_page_insights / meta_post_insights:覆盖人数、展示次数、收藏和互动,按账户和每篇帖子分别统计。search_instagram:按关键词搜索公开的 Instagram Reels,用于调研而非发布。
在自动化任何操作之前,值得了解的两个 Instagram 事实。Meta 的 API 中没有原生 Instagram 排期,因此排期是 Hermoso 的队列,而不是 Instagram 的;为 Instagram 传入 Facebook 的 scheduleAt 会被拒绝,而不是悄悄地立即发布。另外,Instagram 文案在上线后无法编辑:Meta 允许你对已发布的帖子做的唯一更改,只是开启或关闭评论。删除是支持的:manage_meta_post 可以删除普通帖子、限时动态、Reels 和整个轮播相册,但无法从相册中单独删除某一张卡片。
在自动化任何操作之前,值得了解的 Instagram 限制
| 文字 | Instagram 文案上限为 2,200 个字符。它会在帖子创建或排队时执行,因此超长的帖子会在你还在场时被拒绝,以便你修改,而不是在发布途中被悄悄截断。 |
|---|---|
| 可见性 | 仅限公开。Meta 的内容发布 API 只能立即发布或完全不发布,而 Instagram“没有不公开列出、私密或草稿帖子”。如果你想在 Instagram 上设置审核环节,它必须在调用之前发生,而不是之后。 |
| 轮播 | 2 到 10 张幻灯片,图片和视频可以混合。这个上限是 Meta 自己的,引用自它所执行的能力表:“轮播最多只能包含 10 张图片、视频,或两者的混合。”下限 2 是我们定的,因为在任何平台上一张幻灯片都不算轮播。只提出一张幻灯片的请求会作为普通帖子发布,而不会被拒绝。 |
| 使用哪个账户 | pageId。Instagram 通过已连接的 Facebook 主页发布,因此同一个身份字段用于选择它。 |
在 Codex 中试一试
用日常语言提出需求即可。这些都是普通句子,不是某种专用语法:
“非交互模式:用今天的产品照片制作一个 4 张幻灯片的轮播,发布到 Instagram,配文不超过 2,200 个字符,并在结束时返回永久链接。”
这会依次执行 search_instagram → plan_ad → render_ad → post_to_meta(target: "instagram")。交互使用时,Codex 会在运行前显示该调用。非交互使用时没有人可以确认,因此在任何发布或花费的步骤上,都值得专门设计应对方式。
Codex 在 Instagram 上:真正棘手的部分
在无人值守的流水线中,Instagram 需要一个人工步骤:已发布的配文无法通过 API 编辑。如果 Codex 是按定时器运行的,请把审阅放在发布之前:生成并保留,获批后再发布。删除是唯一的撤销方式。manage_meta_post 可以删除普通帖子、限时动态、Reels 和整个轮播相册,但删除时会一并清除点赞和评论。
对于无人值守运行,相较于完整的工具清单,请优先使用带 --json 的 hermoso CLI。它占用的上下文要少得多,也更便于断言。
发布前先调研 Instagram
search_meta_ads 同时覆盖 Instagram 版位与 Facebook,因为它们属于同一个广告库。对于自然内容,search_instagram 按关键词搜索公开的 Reels,这是这种形式真正产生影响的渠道;主页和话题标签的抓取则通过 fetch_social_data 和 search_instagram_hashtag 完成。
付费部分
Instagram 版位通过与 Facebook 相同的 Meta 广告结构购买:create_meta_campaign → create_meta_adset → create_meta_ad,版位可按平台和位置分别选择。preview_meta_ad 会在你花钱之前按版位展示真实渲染的广告,meta_insights 则按年龄、性别、版位和国家细分结果。正是这种细分,决定了下一版素材该怎么做。
Codex 自己无法完成的事
一个掌握预算的智能体,只有在影响范围有界的情况下才有用,所以这道围栏设在服务器里,而不是提示词里。每个广告系列、广告组、广告分组和广告都以暂停状态创建,而会真正动用资金的状态切换,若没有明确的确认标记就拒绝执行。每次渲染前都会先报价(hermoso_capabilities 会在任何花费发生之前公布每个模型的确切积分成本)。积分在第一次调用服务商之前就会预留,之后按确切成本结算,因此派发失败会退款,而不是让你白白付费。删除操作同样需要确认;并且在智能体告诉你它搭建了什么之前,每个广告系列结构都会从广告平台回读。
有一步刻意不能无头完成:连接账户是一个 OAuth 授权页面,因此你需要在浏览器中连接一次该渠道。之后的一切都是工具调用。
其余的矩阵
从 Codex 发布到: Facebook · Threads · TikTok · YouTube · X · LinkedIn · Pinterest · Bluesky · Telegram。或查看 Codex 可发布的全部平台。
从以下工具发布到 Instagram: Claude · ChatGPT · Claude Code · Cursor · Cline · OpenClaw · Grok Bot · Hermes · Gemini CLI · Perplexity · Le Chat · Claude Cowork · Perplexity Computer · Paperclip · 从命令行投放广告
常见问题
Codex 能发布到 Instagram 吗?
可以,通过 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+ 个工具,包括发布到 Instagram 的工具,以及研究你所在市场正在投放的广告并从头渲染创意的工具。
如何将 Instagram 连接到 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 的 设置 → 连接器 中连接 Instagram,这是浏览器中的 OAuth 授权页面。之后,Codex 发布到 Instagram 就像普通的工具调用一样。
Codex 能发布 Instagram 轮播吗?
能,2 到 10 张幻灯片,图片和视频可以混合。10 这个上限是 Meta 自己公布的,并非 Hermoso 自行设定。无论哪种情况,Codex 都调用同一个发布工具;无法承载轮播的渠道会附上真实原因被拒绝。
从 Codex 发布到 Instagram 要花多少钱?
发布到 Instagram 不消耗积分,因为 Meta 对每次 API 调用都不收费。积分花在渲染本身上。套餐每月 $29、$69 和 $149,分别对应 1,200、3,000 和 7,000 积分,每个功能在每个套餐(包括免费版)中都可用。唯一的例外是企业级 SSO。
Codex 需要我的 Instagram 密码吗?
不需要。你只需在浏览器中通过 OAuth 授权页面把 Instagram 连接到 Hermoso 一次,之后 Codex 会以工具调用的方式访问它。连接账户是唯一不能无头完成的步骤;之后的任何步骤都不需要密码,也从不会把任何凭据交给模型。
Codex 能为 Instagram 帖子设定未来的发布时间吗?
可以。schedule_post 会把它排进与其他所有渠道共用的同一个日历,如果文案需要不同,还可以为该渠道设置单独的文案;list_scheduled 和 cancel_scheduled 可以读取并撤回它。Instagram 是可以排队的十一个渠道之一。