Zernio CLI
Schedule and publish social media posts across 14 platforms (Instagram, TikTok, X/Twitter, LinkedIn, Facebook, Threads, YouTube, Bluesky, Pinterest, Reddit, Snapchat, Telegram, WhatsApp, Google Business) from any terminal or AI agent.
Setup
CODEBLOCK0
Or set the env var directly: INLINECODE0
Core Workflow
The typical flow for scheduling a post:
CODEBLOCK1
Output Format
All commands output JSON by default (for AI agents and piping). Add --pretty for indented output.
Errors always return: INLINECODE2
Commands Reference
Authentication
CODEBLOCK2
Profiles
CODEBLOCK3
Accounts (Social Media Connections)
CODEBLOCK4
Posts
CODEBLOCK5
Analytics (requires analytics add-on)
CODEBLOCK6
Media
CODEBLOCK7
Platform-Specific Examples
Instagram Reel
CODEBLOCK8
Multi-Platform Post
CODEBLOCK9
Threads + Twitter Simultaneous
CODEBLOCK10
Supported Platforms
Instagram, TikTok, X (Twitter), LinkedIn, Facebook, Threads, YouTube, Bluesky, Pinterest, Reddit, Snapchat, Telegram, WhatsApp, Google Business Profile.
Error Handling
Common errors and their meaning:
- -
401 - Invalid or missing API key - INLINECODE4 - Feature requires paid add-on (e.g., analytics)
- INLINECODE5 - Plan limit reached or insufficient permissions
- INLINECODE6 - Resource not found
- INLINECODE7 - Rate limited (account in cooldown)
Tips for AI Agents
- - Always call
zernio accounts:list first to get valid account IDs before creating posts - Use
zernio accounts:health to check if accounts are rate-limited before posting - Post IDs from
zernio posts:create can be used with zernio posts:get to check publish status - For multi-image posts, upload each file with
zernio media:upload first, then pass all URLs comma-separated to INLINECODE13 - Schedule posts at least 5 minutes in the future for reliable delivery
Zernio CLI
从任何终端或AI代理跨14个平台(Instagram、TikTok、X/Twitter、LinkedIn、Facebook、Threads、YouTube、Bluesky、Pinterest、Reddit、Snapchat、Telegram、WhatsApp、Google Business)安排和发布社交媒体帖子。
设置
bash
npm install -g @zernio/cli
通过浏览器登录(推荐)
zernio auth:login
或手动设置API密钥
zernio auth:set --key sk_your-api-key
验证是否生效
zernio auth:check
或直接设置环境变量:export ZERNIOAPIKEY=sk_your-api-key
核心工作流程
安排帖子的典型流程:
bash
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. 查看分析数据(需要分析插件)
zernio analytics:posts --profileId
输出格式
所有命令默认输出JSON格式(适用于AI代理和管道传输)。添加--pretty参数可输出缩进格式。
错误始终返回:{error: true, message: ..., status: 401}
命令参考
身份验证
bash
通过浏览器登录(打开浏览器,自动创建API密钥)
zernio auth:login
或使用自定义设备名称
zernio auth:login --device-name my-server
手动保存API密钥
zernio auth:set --key sk_your-api-key
可选设置自定义API URL
zernio auth:set --key sk_... --url https://custom.api.url/api/v1
验证密钥是否有效
zernio auth:check
个人资料
bash
列出所有个人资料
zernio profiles:list
创建个人资料
zernio profiles:create --name My Brand
获取个人资料详情
zernio profiles:get
更新个人资料
zernio profiles:update --name New Name
删除个人资料(必须没有已连接的账号)
zernio profiles:delete
账号(社交媒体连接)
bash
列出所有已连接的账号
zernio accounts:list
按个人资料或平台筛选
zernio accounts:list --profileId --platform instagram
获取单个账号
zernio accounts:get
检查所有账号的健康状态(速率限制、令牌过期)
zernio accounts:health
帖子
bash
立即发布
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
分析数据(需要分析插件)
bash
帖子分析
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
媒体文件
bash
上传文件(返回URL,用于posts:create --media)
zernio media:upload ./photo.jpg
zernio media:upload ./video.mp4
特定平台示例
Instagram Reel
bash
zernio media:upload ./reel.mp4
使用返回的URL:
zernio posts:create --text New reel! --accounts --media
多平台帖子
bash
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同时发布
bash
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 - 功能需要付费插件(如分析功能)
- 403 - 达到套餐限制或权限不足
- 404 - 资源未找到
- 429 - 请求频率受限(账号处于冷却期)
AI代理使用提示
- - 创建帖子前始终先调用zernio accounts:list获取有效的账号ID
- 发布前使用zernio accounts:health检查账号是否受速率限制
- zernio posts:create返回的帖子ID可用于zernio posts:get检查发布状态
- 对于多图帖子,先使用zernio media:upload上传每个文件,然后将所有URL以逗号分隔传递给--media
- 安排帖子时至少预留5分钟以确保可靠投递