Back to Details

zernio-cli

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Zernio CLI

Zernio CLI

Overview

概述

Zernio CLI schedules and manages social media posts across 14 platforms from the terminal. Run via 
npx @zernio/cli
- no global install needed.
Zernio CLI 可在终端中实现14个平台的社交媒体内容定时发布与管理。通过 
npx @zernio/cli
运行，无需全局安装。

Safety Guidelines

安全指南

CRITICAL: Always ask user permission before posting.
  1. Prepare the command - show user exactly what will be posted
  2. Get explicit approval - "Should I run this command to post?"
  3. Only then execute - after user confirms
Never post without asking first, even if the user seems to request it directly.
Default to draft mode - use 
--draft
flag unless user explicitly wants to publish immediately.
重要提示：发布前必须先征得用户同意
  1. 准备命令 - 向用户准确展示即将发布的内容
  2. 获得明确批准 - 询问「我是否可以运行此命令进行发布？」
  3. 确认后再执行 - 仅在用户确认后操作
即使看起来是用户直接要求发布，也绝对不能未经询问就直接发布
默认使用草稿模式 - 除非用户明确要求立即发布，否则都要带上
--draft
参数。

When to Use

适用场景

  • User wants to post to social media platforms
  • User mentions scheduling posts for later
  • User wants to post to multiple platforms at once
  • User has social media accounts to manage
When NOT to use:
  • Direct API integration (use Zernio API skill instead)
  • One-off manual posting (CLI is for automation/scheduling)
  • 用户想要在社交媒体平台发布内容
  • 用户提到要定时发布内容
  • 用户想要同时在多个平台发布内容
  • 用户需要管理多个社交媒体账号
不适用场景：
  • 直接API集成（请使用Zernio API skill代替）
  • 单次手动发布（CLI适用于自动化/定时发布场景）

Quick Reference

快速参考

TaskCommand
Check auth
npx @zernio/cli auth:check
Login (browser)
npx @zernio/cli auth:login
List accounts
npx @zernio/cli accounts:list
Create draft
npx @zernio/cli posts:create --text "..." --accounts id1,id2 --draft
Publish post
npx @zernio/cli posts:create --text "..." --accounts id1,id2
(ASK FIRST)
Schedule postAdd 
--scheduledAt "2025-06-01T09:00:00Z"
(ASK FIRST)
Upload media
npx @zernio/cli media:upload <file>
List posts
npx @zernio/cli posts:list
任务命令
检查授权状态
npx @zernio/cli auth:check
登录（浏览器方式）
npx @zernio/cli auth:login
列出账号列表
npx @zernio/cli accounts:list
创建草稿
npx @zernio/cli posts:create --text "..." --accounts id1,id2 --draft
发布内容
npx @zernio/cli posts:create --text "..." --accounts id1,id2
（发布前必须询问）
定时发布内容添加 
--scheduledAt "2025-06-01T09:00:00Z"
（发布前必须询问）
上传媒体资源
npx @zernio/cli media:upload <file>
列出内容列表
npx @zernio/cli posts:list

Authentication

授权

ALWAYS check auth first:
bash
npx @zernio/cli auth:check
If not authenticated:
bash
undefined
务必首先检查授权状态：
bash
npx @zernio/cli auth:check
如果未授权：
bash
undefined

Browser login (recommended - creates API key automatically)

浏览器登录（推荐 - 自动生成API密钥）

npx @zernio/cli auth:login
npx @zernio/cli auth:login

Or manual key (get from zernio.com/dashboard/api-keys)

或手动设置密钥（从 zernio.com/dashboard/api-keys 获取）

npx @zernio/cli auth:set --key "sk_your-api-key"

Config stored in `~/.zernio/config.json`
npx @zernio/cli auth:set --key "sk_your-api-key"

配置文件存储在 `~/.zernio/config.json`

Common Workflows

常用工作流

Simple Post

简单发布

bash
undefined
bash
undefined

1. Get account IDs

1. 获取账号ID

npx @zernio/cli accounts:list
npx @zernio/cli accounts:list

2. Create draft first (ALWAYS start with draft)

2. 首先创建草稿（请始终先创建草稿）

npx @zernio/cli posts:create
--text "Your message here"
--accounts account-id-1,account-id-2
--draft
npx @zernio/cli posts:create \ --text "Your message here" \ --accounts account-id-1,account-id-2 \ --draft

3. Show command to user, ASK permission, then publish

3. 向用户展示命令，询问许可后再发布

Only run after explicit user approval:

仅在用户明确批准后运行:

npx @zernio/cli posts:create
--text "Your message here"
--accounts account-id-1,account-id-2
undefined
npx @zernio/cli posts:create \ --text "Your message here" \ --accounts account-id-1,account-id-2
undefined

Scheduled Post

定时发布

bash
undefined
bash
undefined

Scheduled posts are safer (user can cancel before publish time)

定时发布更安全（用户可在发布时间前取消）

Still ASK permission before running this command

运行该命令前仍需询问用户许可

npx @zernio/cli posts:create
--text "Your message"
--accounts account-id
--scheduledAt "2025-06-01T09:00:00Z"
undefined
npx @zernio/cli posts:create \ --text "Your message" \ --accounts account-id \ --scheduledAt "2025-06-01T09:00:00Z"
undefined

Post with Media

带媒体资源的发布

bash
undefined
bash
undefined

1. Upload media FIRST

1. 首先上传媒体资源

npx @zernio/cli media:upload ~/path/to/image.png
npx @zernio/cli media:upload ~/path/to/image.png

Returns: {"url": "https://..."}

返回: {"url": "https://..."}

2. Create draft with media URL

2. 使用媒体URL创建草稿

npx @zernio/cli posts:create
--text "Your message"
--accounts account-id
--media "https://..."
--draft
npx @zernio/cli posts:create \ --text "Your message" \ --accounts account-id \ --media "https://..." \ --draft

3. ASK permission, show user the draft, then publish

3. 询问许可，向用户展示草稿后再发布

Only run after explicit approval (remove --draft flag):

仅在明确批准后运行（移除--draft参数）:

npx @zernio/cli posts:create
--text "Your message"
--accounts account-id
--media "https://..."

**Multiple images:** Use comma-separated URLs: `--media "url1,url2,url3"`
npx @zernio/cli posts:create \ --text "Your message" \ --accounts account-id \ --media "https://..."

**多张图片：** 使用逗号分隔URL：`--media "url1,url2,url3"`

Supported Platforms

支持的平台

Instagram, TikTok, X (Twitter), LinkedIn, Facebook, Threads, YouTube, Bluesky, Pinterest, Reddit, Snapchat, Telegram, Google Business Profile
Platform requirements:
  • Text-only: All platforms
  • Media required: Instagram, TikTok (images/video)
  • Video required: YouTube, TikTok
Instagram, TikTok, X (Twitter), LinkedIn, Facebook, Threads, YouTube, Bluesky, Pinterest, Reddit, Snapchat, Telegram, Google Business Profile
平台要求：
  • 仅文本：所有平台均支持
  • 需要媒体资源：Instagram、TikTok（图片/视频）
  • 需要视频：YouTube、TikTok

Common Mistakes

常见问题

MistakeFix
Command 
zernio
not found		Use 
npx @zernio/cli
(note the @)
"Account not found"Run 
accounts:list
to get correct IDs
Media not showingUpload media first, then use returned URL
Post fails on some platformsCheck platform requirements (some need media)
Date format wrongUse ISO 8601: 
2025-06-01T09:00:00Z
Unknown argument: status
Use 
--draft
flag, NOT 
--status draft
Posted without askingSTOP. Always ask permission before posting
错误解决方法
找不到
zernio
命令		使用
npx @zernio/cli
（注意@符号）
「账号未找到」运行
accounts:list
获取正确的ID
媒体资源不显示先上传媒体资源，再使用返回的URL
部分平台发布失败检查平台要求（部分平台需要媒体资源）
日期格式错误使用ISO 8601格式：
2025-06-01T09:00:00Z
Unknown argument: status
使用
--draft
参数，不要使用
--status draft
未询问就直接发布立刻停止操作。发布前必须先征得用户许可

Links

链接