Zernio CLI

通过任意终端或 AI agent，在 14 个平台（Instagram、TikTok、X/Twitter、LinkedIn、Facebook、Threads、YouTube、Bluesky、Pinterest、Reddit、Snapchat、Telegram、WhatsApp、Google Business）上安排并发布社交媒体内容。

安装配置

npm install -g @zernio/cli

# 通过浏览器登录（推荐）
zernio auth:login

# 或手动设置 API 密钥
zernio auth:set --key "sk_your-api-key"

# 验证是否生效
zernio auth:check

也可直接设置环境变量：export ZERNIO_API_KEY="sk_your-api-key"

核心工作流

安排一条帖子的典型流程如下：

# 1. 查看您的个人资料列表
zernio profiles:list

# 2. 查看已连接的社交账号
zernio accounts:list

# 3. 安排一条帖子
zernio posts:create --text "Hello world!" --accounts , --scheduledAt "2025-01-15T10:00:00Z"

# 4. 查看已安排帖子的状态
zernio posts:list --status scheduled

# 5. 查看数据分析（需启用 analytics 插件）
zernio analytics:posts --profileId 

输出格式

所有命令默认以 JSON 格式输出（便于 AI agent 调用及管道处理）。添加 --pretty 参数可获得缩进格式化输出。

错误响应始终为：{"error": true, "message": "...", "status": 401}

命令参考

身份验证（Authentication）

# 通过浏览器登录（自动打开浏览器并创建 API 密钥）
zernio auth:login

# 或指定自定义设备名称
zernio auth:login --device-name "my-server"

# 手动保存 API 密钥
zernio auth:set --key "sk_your-api-key"

# 可选：设置自定义 API 地址
zernio auth:set --key "sk_..." --url "https://custom.api.url/api/v1"

# 验证密钥有效性
zernio auth:check

个人资料（Profiles）

# 列出所有个人资料
zernio profiles:list

# 创建新个人资料
zernio profiles:create --name "My Brand"

# 获取个人资料详情
zernio profiles:get 

# 更新个人资料
zernio profiles:update  --name "New Name"

# 删除个人资料（该资料下不得存在任何已连接账号）
zernio profiles:delete 

账号（社交平台连接，Accounts）

# 列出所有已连接账号
zernio accounts:list

# 按个人资料 ID 或平台筛选
zernio accounts:list --profileId  --platform instagram

# 获取单个账号详情
zernio accounts:get 

# 检查所有账号健康状态（限流情况、Token 过期等）
zernio accounts:health

帖子（Posts）

# 立即发布
zernio posts:create --text "Hello!" --accounts ,

# 安排发布时间
zernio posts:create --text "Scheduled post" --accounts  --scheduledAt "2025-06-01T14:00:00Z"

# 保存为草稿
zernio posts:create --text "Draft idea" --accounts  --draft

# 带媒体文件
zernio posts:create --text "Check this out" --accounts  --media "https://example.com/image.jpg"

# 带标题（适用于 YouTube、Reddit）
zernio posts:create --text "Description" --accounts  --title "My Video Title"

# 按条件列出帖子
zernio posts:list --status published --page 1 --limit 20
zernio posts:list --profileId  --from "2025-01-01" --to "2025-01-31"
zernio posts:list --search "product launch"

# 获取帖子详情
zernio posts:get 

# 删除帖子
zernio posts:delete 

# 重试失败的帖子
zernio posts:retry 

数据分析（Analytics，需启用 analytics 插件）

# 帖子级数据分析
zernio analytics:posts --profileId 
zernio analytics:posts --postId 
zernio analytics:posts --platform instagram --sortBy engagement

# 每日数据指标
zernio analytics:daily --accountId  --from "2025-01-01" --to "2025-01-31"

# 最佳发布时间建议
zernio analytics:best-time --accountId 

媒体（Media）

# 上传文件（返回可用于 posts:create --media 的 URL）
zernio media:upload ./photo.jpg
zernio media:upload ./video.mp4

平台特例说明

Instagram Reel

zernio media:upload ./reel.mp4
# 使用返回的 URL：
zernio posts:create --text "New reel!" --accounts  --media ""

跨平台发布

zernio posts:create 
  --text "Big announcement!" 
  --accounts ,, 
  --media "https://example.com/image.jpg" 
  --scheduledAt "2025-06-01T09:00:00Z" 
  --timezone "America/New_York"

Threads + Twitter 同步发布

zernio posts:create --text "Thoughts on AI agents..." --accounts ,

支持的平台

Instagram、TikTok、X（Twitter）、LinkedIn、Facebook、Threads、YouTube、Bluesky、Pinterest、Reddit、Snapchat、Telegram、WhatsApp、Google Business Profile。

错误处理

常见错误及其含义：

• 401 —— API 密钥无效或缺失
• 402 —— 功能需要付费插件（例如 analytics）
• 403 —— 已达套餐配额上限或权限不足
• 404 —— 请求资源不存在
• 429 —— 触发速率限制（账号处于冷却期）

面向 AI agent 的使用提示

• 创建帖子前，请始终先执行 zernio accounts:list 获取有效的账号 ID
• 发布前建议调用 zernio accounts:health 检查账号是否受限
• zernio posts:create 返回的帖子 ID 可用于 zernio posts:get 查询发布状态
• 对于多图帖文，请先使用 zernio media:upload 分别上传各图片文件，再将返回的多个 URL 以英文逗号分隔传入 --media
• 为确保可靠投递，建议将帖子安排在至少 5 分钟之后的时间点