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