仅需几条命令,在任意 Agent 操作蚁小二
yxer 把多账号、多平台、多内容类型发布封装成可审计的 CLI 流程,让 AI Agent 可以完成账号查询、素材上传、字段校验、发布预览和正式发布。
适合已经在 Codex、Cursor、Claude Code 等宿主中使用 Skills 的场景。npm 包已内置 yixiaoer skill,安装 CLI 后同步即可。
npm install -g @yixiaoermail/cli
yxer --version
yxer config init --api-key <apiKey>
yxer skill sync
yxer doctor3 分钟快速了解蚁小二 CLI
如果你想先看完整演示,再决定如何安装和接入,可以直接播放这段介绍视频。
面向 AI Agent
账号查询、素材上传、字段校验、发布预览和正式发布都通过稳定命令完成。
发布前校验
通过 schema fields、validate 和 dry-run,在真正发布前检查平台字段和素材结构。
云发布与本机发布
支持蚁小二云端发布,也可通过 clientId 切换到本机客户端发布。
Skill 同步
CLI 或工作流文档更新后,一条命令同步 Agent 使用规则。
支持主流 AI Agent 工具
只要宿主可以调用本地 CLI 或安装 Skills,就能把 yxer 接入自动化发布流程。
覆盖自媒体运营核心业务域
从账号到素材,从 payload 到发布记录,Agent 可以按业务域调用不同命令,不需要绕过 CLI 猜接口。
账号与授权
查询平台账号、状态、授权情况和发布通道。
视频发布
上传视频和封面,校验字段后发布到短视频平台。
图文发布
处理多图、标题、正文、话题和平台差异字段。
文章发布
面向公众号、百家号等文章类平台组织 payload。
素材上传
上传图片、视频、封面并复用 CLI 返回的完整对象。
草稿保存
保存蚁小二草稿或平台草稿,支持后续继续编辑。
发布记录
查询发布任务状态、失败原因和历史记录。
失败排查
根据 validate、dry-run、publish 错误给出修复建议。
Skill 更新
同步最新规则、流程文档和 Agent 操作约束。
标准发布流程
Agent 不直接猜字段,也不绕过校验。正式发布前按固定顺序完成环境检查、账号确认、字段读取、素材上传、payload 校验和 dry-run。
yxer doctoryxer accounts list 抖音 --status 1 --jsonyxer schema fields 抖音 videoyxer upload ./video.mp4yxer validate 抖音 video payload.jsonyxer publish video 抖音 payload.json --dry-runyxer publish video 抖音 payload.json常用命令
yxer doctoryxer accounts list <平台> --status 1 --jsonyxer schema fields <平台> <video|imageText|article>yxer upload ./cover.jpgyxer validate <平台> <类型> payload.jsonyxer publish <类型> <平台> payload.json --dry-runyxer skill sync --globalyxer update --check发布纪律
资源必须先通过 yxer upload 上传,并复用 CLI 返回的完整对象。
复杂字段如位置、音乐、合集、挑战等,应使用 CLI 提供的查询命令获取。
每次修改 payload 后,都需要重新执行 validate 和 dry-run。
CLI 或 skill 文档升级后,执行 yxer skill sync 保持 Agent 规则最新。
常见问题
yxer CLI 和蚁小二客户端是什么关系?
yxer 是命令行执行入口,负责把自动化请求转换为蚁小二发布能力;客户端适合人工运营,本机发布场景也可通过 clientId 与 CLI 配合。
没有 API Key 能不能使用?
不能完成正式调用。首次使用需要先下载客户端,登录后在客户端内获取 apiKey,并执行 yxer config init --api-key <apiKey>。
支持哪些内容类型?
当前围绕视频、图文和文章发布设计,并通过 schema fields / schema get 获取不同平台的真实字段要求。
为什么要先 validate 和 dry-run?
平台字段、素材对象和账号状态都可能影响发布结果。validate 和 dry-run 能在正式发布前发现结构错误和通道问题。
CLI 升级后为什么要同步 skill?
Agent 使用的是 skill 中的规则和工作流说明。CLI 或文档升级后执行 yxer skill sync,才能避免宿主继续使用旧流程。