Taisly Agent

Taisly Agent Kit

面向短视频的免费 AI 优先社交媒体发布工具。Taisly Agent Kit 是一款以 JSON 为先的 SDK、CLI、Agent Skill 和 MCP 服务，可让 AI Agent、开发者工具和自动化工作流通过 Taisly，将视频发布到 TikTok、Instagram Reels、YouTube Shorts、X、Facebook 以及其他已连接的社交平台。

当你的 Agent 能够创作内容、撰写配文或准备营销活动，但仍需要可靠的视频发布 API 来将内容发布到网上时，就可以使用它。该软件包可免费安装，旨在帮助 Agent 从创意到视频发布一路畅通，无需自行构建每个平台的集成。

网站 | Agent Kit | API 文档 | npm | GitHub | MCP 注册表 | Glama | 指南

语言

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

开发者为何使用它

• 将 AI Agent 社交媒体发布功能集成到 Codex、Claude Code、Cursor、OpenClaw 和自定义自动化工具中。
• 自动将一个本地文件中的视频发布到多个已连接的社交账号。
• 为 Agent 提供安全的 JSON 工作流：发现账号、验证载荷、创建帖子并检查状态。
• 添加 TikTok API 发布自动化、Instagram Reels 自动化、YouTube Shorts 发布和跨平台社交媒体自动化，无需自行构建每个平台的集成。
• 免费开始使用，仅在发布工作流规模扩大时才升级。

Taisly 负责已连接的账号和发布执行。你的 Agent 负责规划、撰写配文、营销活动逻辑或工作流编排。

可选的本地工作流

• 免费安装软件包。
• 通过 AI Agent 创建或连接 Taisly 账号。
• 让 Agent 通过以 JSON 为先的工作流完成身份验证、连接社交账号、验证视频并发布内容。
• 需要更高发布量、更多账号或自动转发工作流时再升级。

开始使用无需信用卡。付费套餐适用于需要更大规模的团队和工作流。

Agent Skill

该软件包包含 Taisly 社交媒体发布 Skill，位于 SKILL.md 中。当你希望 Agent 在接触实际社交账号之前了解安全的发布工作流时，可将其与 Claude Code、Codex、Cursor、OpenClaw 和其他 Agent 搭配使用。

推荐的 Skill 工作流：

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

该 Skill 会指导 Agent 发现已连接的账号、验证帖子、征求用户明确确认、创建帖子，并保存返回的 historyId 以便检查状态。

Codex 插件

此软件包在 .codex-plugin/plugin.json 中包含 Codex 插件清单。该插件会将 Codex 指向规范的 SKILL.md 文件和官方远程 MCP 服务：

https://app.taisly.com/mcp

如果你希望 Codex 能从一个软件包中发现发布工作流说明和 Taisly MCP 工具，请使用此插件。根目录下的 SKILL.md 是 Agent 工作流的唯一可信来源。

通过远程 MCP 连接 AI Agent

远程 MCP 是默认的 AI Agent 连接方式。如果 Taisly 工具已可用，请直接调用 taisly_auth_status 和 taisly_platforms_list。OAuth 会提供访问权限；对此连接无需安装此软件包，也无需索取 API 密钥。

Help me connect Taisly to this agent using the setup guide. Check access and list my connected social accounts. Do not publish anything during setup.

Full documentation: https://docs.taisly.com/docs/mcp

远程服务 URL 为 https://app.taisly.com/mcp。如有需要，请通过客户端的远程 MCP 和 OAuth 设置添加。可能需要人工授权或管理员批准。授权过期时，请通过 OAuth 重新连接，而不要切换到 CLI。

可选的本地软件包安装

如需使用 SDK、CLI 或本地文件工作流，请参照以下软件包说明。这些说明并非远程 MCP 的配置要求。

npm install -g @taisly/agent

或者，无需全局安装即可运行：

npx @taisly/agent help

启动 stdio MCP 服务：

npx @taisly/agent mcp

在此代码库中进行本地开发：

node packages/agent/src/cli.js help

本地软件包身份验证

对于本地软件包，浏览器设置可以存储本地凭据，无需手动复制 API 密钥。可使用任意简短的 Agent 标识，例如 claude-code、codex、cursor、windsurf、openclaw、hermes-agent、cline 或 aider。

Help me set up Taisly Agent Kit.

1. Install the CLI: npm i -g @taisly/agent
2. Run taisly setup --agent <agent-slug> and send me the login URL so I can finish authentication.
3. Wait for me to finish login in the browser.
4. Run taisly checkin --agent <agent-slug>.
5. Tell me if Taisly is connected and ready. If not, tell me what failed.

If you cannot install or run the Taisly CLI in this environment, stop and tell me to open Taisly Settings instead.

设置命令会存储本地 Taisly Agent 凭据，因此后续 CLI 和 MCP 命令无需手动复制 API 密钥即可运行。

手动备用方案：在 Taisly 设置中创建 API 密钥，然后设置：

export TAISLY_API_KEY="taisly_..."

高级用法：默认情况下，浏览器设置会将本地凭据存储在 ~/.taisly/config.json 中。大多数用户无需更改此设置。仅在 CI、测试或需要独立凭据存储的隔离 Agent 配置中，才设置 TAISLY_CONFIG_HOME=/path/to/dir。

快速开始

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

taisly auth:status
taisly platforms:list

从 AI Agent 工作流中连接社交账号：

taisly platforms:connect:start --platform instagram
# Open the returned connectUrl and finish authorization in the browser.
taisly platforms:connect:check --platform instagram
taisly platforms:list

支持的连接标识：instagram、tiktok、youtube、x、facebook。

发布前验证本地视频：

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>

发布设置

发现每个目标平台支持的选项及其可接受的值：

taisly platforms:schema --platform TikTok
taisly platforms:schema --platform YouTube

在 settings 中按平台名称分组设置。例如：

taisly posts:create \
  --video ./launch.mp4 \
  --platforms your_tiktok_platform_id,your_youtube_platform_id \
  --description "Product walkthrough" \
  --settings '{"TikTok":{"status":"PUBLIC_TO_EVERYONE"},"YouTube":{"title":"Product walkthrough","status":"unlisted"}}'

使用 --json 时，将同一对象放入输入文件的 settings 属性中。SDK 调用接受作为对象的 settings。对于远程或本地 MCP，使用 taisly_platform_schema 发现选项，并将 settings 传递给 taisly_posts_validate 和 taisly_posts_create。HTTP API 接受经过 JSON 编码的 settings 表单字段。

平台	设置	含义
TikTok	status	PUBLIC_TO_EVERYONE、MUTUAL_FOLLOW_FRIENDS、FOLLOWER_OF_CREATOR 或 SELF_ONLY，具体取决于账号可用的可见性选项。
TikTok	comment_disabled、duet_disabled、stitch_disabled	布尔开关；true 表示禁用相应互动。
TikTok	brand_content_toggle	布尔值；用于披露推广第三方业务的付费合作关系。不能与 SELF_ONLY 同时使用。
TikTok	brand_organic_toggle	布尔值；用于披露对创作者自有业务的推广。两个品牌开关可以同时启用。
TikTok	is_aigc	布尔值；true 表示启用原生 AI 生成内容标签。省略此项可保留现有行为，也可以显式传入 false。
YouTube	title	可选视频标题，最多 100 个字符。省略此项则使用帖子说明文字。
YouTube	status	public、private 或 unlisted。

例如，推广自有业务的公开 TikTok 帖子和标题独立设置的非公开 YouTube 帖子可以共用一个请求：

{
  "settings": {
    "TikTok": {
      "status": "PUBLIC_TO_EVERYONE",
      "brand_organic_toggle": true,
      "comment_disabled": false
    },
    "YouTube": {
      "title": "Product walkthrough",
      "status": "unlisted"
    }
  }
}

这些设置适用于 --settings、--json、SDK 调用和两个 MCP 服务， 可用于即时发布和定时发布。它们会应用于相应平台上所有选定的账号。省略的字段将保留通常的发布行为。这些选项仅适用于所请求的帖子。TikTok 账号限制仍然有效。

每条命令都会输出 JSON，方便 Agent 解析结果，无需从终端文本中抓取信息。

MCP 服务

Taisly 已在官方 MCP Registry 中发布：

io.github.taisly/agent

显示名称：Taisly Social Media Posting

远程 MCP 端点：

https://app.taisly.com/mcp

远程 MCP 服务使用可流式传输的 HTTP 和 OAuth。远程 MCP 工具只能通过公开的 videoUrl 发布，因为它们无法读取你电脑上的本地文件。

Codex 远程 MCP 设置：

codex mcp add taisly --url https://app.taisly.com/mcp
codex mcp login taisly

Claude Code 远程 MCP 设置：

claude mcp add --transport http taisly https://app.taisly.com/mcp

然后让 Claude Code 验证连接。如果需要 OAuth，Claude Code 可以引导你在会话中通过浏览器登录。如果你想在使用工具前通过 shell 完成 OAuth 流程，也可以使用 claude mcp login taisly 显式进行身份验证。

Taisly Agent Kit 还在同一个包中提供本地 stdio MCP 服务。当 Agent 需要读取本地视频文件时，请使用本地 MCP：

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

如果你已经在使用手动 API 密钥，仍然可以在 MCP 服务的 env 区块中传入 TAISLY_API_KEY。

Codex 本地 MCP 设置：

codex mcp add taisly -- npx @taisly/agent mcp

Claude Code 本地 MCP 设置：

claude mcp add taisly -- npx @taisly/agent mcp

然后询问 Agent：

Use the local Taisly MCP server you just added and run the Taisly agent setup start tool with agentId: "<agent-slug>".

Send me the login URL and wait for me to finish in the browser.
Then run the Taisly agent checkin tool with agentId: "<agent-slug>".
After checkin, run the Taisly auth status tool.
Tell me if Taisly is connected and ready. If not, tell me what failed.

可用的 MCP 工具：

• taisly_agent_setup_start
• taisly_agent_checkin
• taisly_auth_status
• taisly_platforms_list
• taisly_platform_schema
• taisly_platform_connect_start
• taisly_platform_connect_check
• taisly_posts_validate
• taisly_posts_create
• taisly_posts_status
• taisly_posts_list
• taisly_reposts_list
• taisly_reposts_create

taisly_posts_create 要求 confirmed: true。只有在用户明确批准视频、目标账号、说明文字和发布时间表后，才设置此项。

面向 Agent 的 JSON 工作流

Agent 可以编写负载文件并传递给 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 路径必须指向 Agent 可访问的真实本地文件。支持本地预检的扩展名包括 .mp4、.mov、.avi、.mkv、.webm、.flv、.mpeg 和 .mpg。

命令

taisly auth:status
taisly setup --agent <agent-slug>
taisly checkin --agent <agent-slug>
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 Agent 配合使用

Taisly Agent Kit 专为 Agent 工作流设计：用户给出高层级指令，Agent 随后执行安全的发布流程。

• Codex：让编码 Agent 在用户确认后发布演示视频、上线预告片或构建更新。
• Claude Code：将社交媒体发布功能加入本地内容工作流和营销活动脚本。
• Cursor：通过开发者工具、内容应用和内部自动化发布视频。
• OpenClaw 和其他 Agent：通过单个 CLI 连接规划、撰写说明文字和执行发布。

推荐的 Agent 使用流程：

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

Agent 示例

examples/ 文件夹包含适用于常见编码 Agent 的可复制粘贴工作流：

• 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 Agent 凭证或 API 密钥。
• 它不会绕过平台规则、账号权限或媒体验证。

当前限制

• posts:create 使用现有的 multipart /post API。
• posts:status 会读取近期历史记录，因为目前尚无单条帖子状态端点。
• posts:validate 是本地预检；最终验证仍由 Taisly 执行。
• 本地 MCP 使用 stdio 传输。本地 MCP 以外的远程 MCP 使用 https://app.taisly.com/mcp 上的可流式 HTTP。
• 远程 MCP 需要公开视频 URL；对于本地视频文件，请使用本地 MCP 或 CLI。
• 后续计划支持重复使用媒体上传。

链接

• 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
• MCP Registry：https://registry.modelcontextprotocol.io/v0.1/servers?search=io.github.taisly%2Fagent
• SEO 指南：https://taisly.com/en/blog/ai-agent-social-media-posting-api