用 Agent 驱动 OmniPost

OmniPost 天生为 Agent 驱动而设计。Agent 准备内容;OmniPost 负责账号、会话、发布与记录。同一个发布内核有三种接入方式,外加一个最省事的 Skill。

Skill(最省事,所有 Agent 通用)

开源仓库 github.com/OmniGoAI/omnipost-skill(MIT)提供现成的 SKILL.md:它教 Agent 如何找到本机的 OmniPost、有 MCP 用 MCP、没有就用 CLI,以及完整的发布工作流;随附 10 个中文平台的内容规则速查,Agent 发布前会先读。把仓库里的 skills/omnipost/ 文件夹放进 Agent 的 skills 目录即可:

  • Claude Code:~/.claude/skills/omnipost/
  • OpenClaw:~/.openclaw/skills/omnipost/
  • 其它 Agent:放进它的 skills 目录,或把 SKILL.md 作为系统提示

应用自己也能生成一份为这台机器定制、路径都算好的版本:GET /api/skill?download=1。

MCP(推荐给 Agent)

桌面应用内置一个 MCP over SSE 服务。把你的 Agent 指向它:

claude mcp add --transport sse omnipost http://127.0.0.1:8787/sse

需要应用处于运行状态。只支持 stdio 传输的客户端,把 GET /api/health 返回的 mcp.stdio(command / args / env)填进客户端配置即可,安装版同样可用。

为帮助 Agent 自助接入,应用还提供:

  • GET /api/health —— 状态、端口、MCP SSE 地址,以及数据/日志目录。
  • GET /api/agent-tools —— 实时的 MCP 工具清单。
  • GET /api/skill —— 现成的 Claude Skill(?download=1 下载 ZIP)。

推荐的 Agent 工作流

  1. get_status —— 确认应用已就绪(平台/账号/已登录数量)。
  2. list_accounts —— 查看可用账号。
  3. preview_content —— 按目标渲染 Markdown。
  4. create_draft 或 publish_post —— 执行动作。
  5. list_posts —— 检查结果、定时与失败。

小贴士:尽量用 targets(具体账号)而不是整个 platforms;图片传文件路径或 http URL——不要自己转 base64,OmniPost 会读取并重新托管它们。

CLI

面向脚本,或不走 MCP 的 Agent:

omnipost publish --doc post.md --targets csdn:default,juejin:default --mode draft

omnipost 是安装版自带的命令:GET /api/health 返回的 cli.shell 就是这台机器上可执行的完整路径(Windows 通常是安装目录下的 omnipost.cmd,macOS 是 OmniPost.app/Contents/Resources/bin/omnipost-cli)。除 omnipost mcp(启动 stdio MCP 服务)和 omnipost oauth-connect(连接 Mastodon 族或 LinkedIn 账号)外,其余命令都要求桌面应用在运行。完整命令见接口参考。

HTTP

一切都是 http://127.0.0.1:8787/api/* 下的本机 REST 调用(非本机请求返回 403)。还有一个流式发布端点(POST /api/publish/stream,按账号返回 NDJSON 事件),为 UI 的进度面板提供支持。

Agent 的免费版与专业版

只读调用(get_status、list_platforms、list_posts……)在免费版可用。Agent 的写操作——创建草稿、发布、定时——是专业版功能;免费版会返回 LICENSE_REQUIRED。桌面 UI 不受这个 Agent 门禁限制(但仍遵循上面的发布规则)。