Agent

🚀 Taisly Agent Kit

面向短视频的 AI 代理社交媒体发布工具。 Taisly Agent Kit 是一个 JSON 优先的 SDK、CLI、Agent Skill 与 MCP 服务器，让 AI 代理、开发者工具和自动化工作流能够通过 Taisly 将视频发布至 TikTok、Instagram Reels、YouTube Shorts、X、Facebook 及其他已连接的社交平台。

当你的代理能够创作内容、撰写文案或策划营销活动，但还需要一个可靠的视频发布 API 将内容上线时，它正是你的理想选择。

🌐 官网 | Agent Kit | API 文档 | npm | GitHub | Glama | 指南

🌍 多语言文档

阅读本指南的其它语言版本：

English、 Español、 Deutsch、 Français、 Português、 ไทย、 中文、 Bahasa Indonesia、 Русский、 Nederlands、 한국어、 日本語、 العربية、 Türkçe、 Polski。

💡 为什么开发者选择它

• 将 AI 代理社交媒体发布能力集成到 Codex、Claude Code、Cursor、OpenClaw 以及自定义自动化工具中。
• 从一个本地文件向多个已连接的社交账号自动发布视频。
• 为代理提供安全的 JSON 工作流：发现账号、校验负载、创建帖子、检查状态。
• 无需自行构建每个平台的集成，即可接入 TikTok API 发布自动化、Instagram Reels 自动化、YouTube Shorts 发布以及跨平台社媒自动化。

Taisly 负责管理已连接账号并执行发布，而你的代理专注于规划、文案撰写、营销逻辑或工作流编排。

🤖 Agent Skill

本包在 SKILL.md 中包含 Taisly Social Media Posting Skill。当你希望代理在操作真实社交账号之前先理解安全发布工作流时，可将它用于 Claude Code、Codex、Cursor、OpenClaw 及自定义代理。

推荐的技能工作流：

auth -> platforms -> validate -> confirm -> create -> status

该技能会引导代理发现已连接账号、校验帖子、请求用户明确确认、创建帖子，并保存返回的 historyId 用于状态查询。

📦 安装

npm install -g @taisly/agent

或者无需全局安装直接运行：

npx @taisly/agent help

启动 stdio MCP 服务器：

npx @taisly/agent mcp

在本仓库内进行本地开发时：

node packages/agent/src/cli.js help

🔐 认证

在 Taisly 设置中创建 API 密钥，然后设置：

export TAISLY_API_KEY="taisly_..."
export TAISLY_API_URL="https://app.taisly.com/api/private"

除非需要指向非默认的 Taisly API 环境，否则 TAISLY_API_URL 为可选。

🚀 快速开始

列出该 API 密钥可用的已连接社交账号：

taisly auth:status
taisly platforms:list

发布前校验本地视频：

taisly posts:validate \
  --video ./launch.mp4 \
  --platforms platform_id_1,platform_id_2 \
  --description "Launch day"

立即发布：

taisly posts:create \
  --video ./launch.mp4 \
  --platforms platform_id_1,platform_id_2 \
  --description "Launch day"

定时发布：

taisly posts:create \
  --video ./launch.mp4 \
  --platforms platform_id_1,platform_id_2 \
  --description "Launch day" \
  --scheduled "2026-06-14T09:00:00+07:00"

查询返回的帖子状态：

taisly posts:status --id <historyId>

每条命令都会输出 JSON，便于代理直接解析结果，而无需从终端文本中提取信息。

🔌 MCP 服务器

Taisly Agent Kit 在同一包中内置了一个 stdio MCP 服务器。MCP 客户端可通过以下配置连接：

{
  "mcpServers": {
    "taisly": {
      "command": "npx",
      "args": ["@taisly/agent", "mcp"],
      "env": {
        "TAISLY_API_KEY": "taisly_..."
      }
    }
  }
}

可用的 MCP 工具：

• taisly_auth_status
• taisly_platforms_list
• taisly_platform_schema
• taisly_posts_validate
• taisly_posts_create
• taisly_posts_status
• taisly_posts_list
• taisly_reposts_list
• taisly_reposts_create

⚠️ 重要提示

taisly_posts_create 需要传入 confirmed: true。仅在用户明确确认视频、目标账号、文案与发布计划后，才应设置该参数。

📋 面向代理的 JSON 工作流

代理可以编写一个负载文件并将其传给 CLI：

{
  "video": "./launch.mp4",
  "platforms": ["platform_id_1", "platform_id_2"],
  "description": "Launch day. Short demo, big update.",
  "scheduled": "2026-06-14T09:00:00+07:00"
}

然后运行：

taisly posts:validate --json ./campaign.json
taisly posts:create --json ./campaign.json

video 路径必须指向代理可访问的真实本地文件。支持的本地预检扩展名包括 .mp4、.mov、.avi、.mkv、.webm、.flv、.mpeg 和 .mpg。

⌨️ 命令

taisly auth:status
taisly platforms:list
taisly integrations:list
taisly platforms:schema --platform TikTok
taisly posts:validate --video ./launch.mp4 --platforms platform_id_1 --description "Launch day"
taisly posts:create --video ./launch.mp4 --platforms platform_id_1 --description "Launch day"
taisly posts:create --json ./campaign.json
taisly posts:list --page 1
taisly posts:status --id <historyId>
taisly reposts:list
taisly reposts:create --from <platform_id> --to <platform_id_1,platform_id_2>
taisly mcp

integrations:* 命令是 platforms:* 命令的别名。Taisly 在应用中把已连接社交账号称为 platforms（平台），而许多公开 API 则称之为 integrations（集成）。

🧰 SDK

import { Taisly } from "@taisly/agent";

const taisly = new Taisly({
  apiKey: process.env.TAISLY_API_KEY,
});

const platforms = await taisly.platforms.list();

const validation = await taisly.posts.validate({
  video: "./launch.mp4",
  platforms: [platforms.data[0].id],
  description: "Launch day",
});

const post = await taisly.posts.create({
  video: "./launch.mp4",
  platforms: [platforms.data[0].id],
  description: "Launch day",
  scheduled: "2026-06-14T09:00:00+07:00",
});

console.log(validation.success);
console.log(post.historyId);

🤝 与 AI 代理配合使用

Taisly Agent Kit 专为代理化工作流设计——用户给出高层级指令，代理执行一条安全的发布路径。

• Codex：让编码代理在用户确认后发布演示视频、发布剪辑或构建更新。
• Claude Code：为本地内容工作流与营销脚本添加社媒发布能力。
• Cursor：从开发者工具、内容应用和内部自动化中直接完成视频发布。
• OpenClaw 及自定义代理：通过单一 CLI 打通规划、文案撰写与发布执行。

推荐的代理路径：

auth:status -> platforms:list -> platforms:schema -> posts:validate -> user confirmation -> posts:create -> posts:status

📝 Agent recipe

examples/ 目录包含适用于常见编码代理的可复制工作流：

• examples/codex/post-video.md
• examples/claude-code/schedule-video.md
• examples/cursor/post-build-demo-video.md
• examples/post-video.sh
• examples/schedule-video.sh

🚫 本包不是什么

• 它不是社交媒体管理面板。
• 它不是视频编辑器。
• 它不能替代 Taisly 账号。
• 它需要已连接的社交账号和 Taisly API 密钥。
• 它不会绕过平台规则、账号权限或媒体校验。

⚠️ 当前限制

• posts:create 使用现有的 multipart /post API。
• posts:status 读取的是近期历史记录，因为单帖状态查询接口尚未提供。
• posts:validate 属于本地预检；最终校验仍在 Taisly 中完成。
• MCP 服务器目前使用 stdio 传输，远程 MCP 传输计划后续支持。
• 媒体上传复用功能计划后续支持。

🔗 链接

• Taisly：https://taisly.com/en
• Agent Kit 页面：https://taisly.com/en/ai-agent-kit
• API 文档：https://docs.taisly.com/en/docs
• npm 包：https://www.npmjs.com/package/@taisly/agent
• GitHub 仓库：https://github.com/taisly/agent
• SEO 指南：https://taisly.com/en/blog/ai-agent-social-media-posting-api