内容
# Taisly 智能代理工具包
[](https://glama.ai/mcp/servers/taisly/agent)
[](https://glama.ai/mcp/servers/taisly/agent)
免费的 AI 优先社交媒体发布，用于短视频内容。Taisly 智能代理工具包是一个 JSON-first 的 SDK、CLI、智能代理技能和 MCP 服务器，允许 AI 智能代理、开发者工具和自动化工作流将视频发布到 TikTok、Instagram Reels、YouTube Shorts、X、Facebook 和其他连接的社交平台，通过 Taisly 进行发布。
在您的智能代理可以创建内容、编写标题或准备活动，但仍然需要一个可靠的视频发布 API 将内容上线时使用它。该软件包免费安装，旨在让智能代理从创意到发布的视频内容无需自己构建每个平台的集成。
[官方网站](https://taisly.com/en) | [智能代理工具包](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 注册表](https://registry.modelcontextprotocol.io/v0.1/servers?search=io.github.taisly%2Fagent) | [Glama](https://glama.ai/mcp/servers/taisly/agent) | [指南](https://taisly.com/en/blog/ai-agent-social-media-posting-api)
## 语言
阅读本指南：
[English](docs/i18n/README.en.md),
[Español](docs/i18n/README.es.md),
[Deutsch](docs/i18n/README.de.md),
[Français](docs/i18n/README.fr.md),
[Português](docs/i18n/README.pt-PT.md),
[ไทย](docs/i18n/README.th.md),
[中文](docs/i18n/README.zh-CN.md),
[Bahasa Indonesia](docs/i18n/README.id.md),
[Русский](docs/i18n/README.ru.md),
[Nederlands](docs/i18n/README.nl.md),
[한국어](docs/i18n/README.ko.md),
[日本語](docs/i18n/README.ja.md),
[العربية](docs/i18n/README.ar.md),
[Türkçe](docs/i18n/README.tr.md),
[Polski](docs/i18n/README.pl.md).
## 为什么开发者使用它
- 在 Codex、Claude Code、Cursor、OpenClaw 和自定义自动化工具中构建 AI 智能代理社交媒体发布功能。
- 从一个本地文件自动发布视频到多个连接的社交账户。
- 为智能代理提供安全的 JSON 工作流：发现账户、验证有效载荷、创建帖子并检查状态。
- 在无需自己构建每个平台集成的情况下，添加 TikTok API 发布自动化、Instagram Reels 自动化、YouTube Shorts 发布和跨平台社交媒体自动化。
- 开始使用免费，之后仅在发布工作流增长时升级。
Taisly 处理连接的账户和发布执行。您的智能代理处理规划、标题编写、活动逻辑或工作流编排。
## 免费的 AI 优先发布
- 免费安装该软件包。
- 从您的 AI 智能代理创建或连接一个 Taisly 账户。
- 让智能代理通过 JSON-first 工作流进行身份验证、连接社交账户、验证视频并发布。
- 在需要更高容量发布、更大的账户集或自动重新发布工作流时升级。
开始使用无需信用卡。付费计划适用于需要更多扩展的团队和工作流。
## 智能代理技能
该软件包包括 `SKILL.md` 中的 **Taisly 社交媒体发布技能**。在您希望智能代理了解安全发布工作流以触及实时社交账户时，与 Claude Code、Codex、Cursor、OpenClaw 等智能代理一起使用。
推荐的技能工作流：
```txt
auth -> platforms -> validate -> confirm -> create -> status
```
该技能告诉智能代理发现连接的账户、验证帖子、请求明确的用户确认、创建帖子并保存返回的 `historyId` 以进行状态检查。
## Codex 插件
该软件包包括 `.codex-plugin/plugin.json` 中的 Codex 插件清单。该插件指向规范的 `SKILL.md` 文件和官方远程 MCP 服务器：
```txt
https://app.taisly.com/mcp
```
在您希望 Codex 发现发布工作流说明和 Taisly MCP 工具的情况下使用该插件。根目录 `SKILL.md` 是智能代理工作流的单一真实来源。
## 安装
```bash
npm install -g @taisly/agent
```
或在不进行全局安装的情况下运行：
```bash
npx @taisly/agent help
```
启动 stdio MCP 服务器：
```bash
npx @taisly/agent mcp
```
在存储库内进行本地开发：
```bash
node packages/agent/src/cli.js help
```
## 身份验证
最简单的流程是让您的 AI 智能代理为您打开浏览器登录。使用任意短的智能代理 slug，例如 `claude-code`、`codex`、`cursor`、`windsurf`、`openclaw`、`hermes-agent`、`cline` 或 `aider`。
```txt
帮助我设置 Taisly 智能代理工具包。
1. 安装 CLI：npm i -g @taisly/agent
2. 运行 taisly setup --agent <agent-slug> 并发送给我登录 URL，以便我可以完成身份验证。
3. 等待我在浏览器中完成登录。
4. 运行 taisly checkin --agent <agent-slug>。
5. 告诉我 Taisly 是否已连接并就绪。如果不是，请告诉我哪里出了问题。
如果您无法在此环境中安装或运行 Taisly CLI，请停止并告诉我打开 Taisly 设置。
```
设置命令存储本地 Taisly 智能代理凭证，以便后续 CLI 和 MCP 命令无需手动复制 API 密钥。
手动备用： 在 [Taisly 设置](https://app.taisly.com/en/settings) 中创建 API 密钥，然后设置：
```bash
export TAISLY_API_KEY="taisly_..."
```
高级： 默认情况下，浏览器设置将本地凭证存储在 `~/.taisly/config.json` 中。大多数用户不应更改此设置。仅为 CI、测试或需要单独凭证存储的隔离智能代理配置文件设置 `TAISLY_CONFIG_HOME=/path/to/dir`。
## 快速开始
列出可用于 API 密钥的连接社交账户：
```bash
taisly auth:status
taisly platforms:list
```
从 AI 智能代理流程中连接社交账户：
```bash
taisly platforms:connect:start --platform instagram
# 打开返回的 connectUrl 并在浏览器中完成授权。
taisly platforms:connect:check --platform instagram
taisly platforms:list
```
支持的连接 slug： `instagram`、`tiktok`、`youtube`、`x`、`facebook`。
在发布前验证本地视频：
```bash
taisly posts:validate \
--video ./launch.mp4 \
--platforms platform_id_1,platform_id_2 \
--description "发布日"
```
立即发布：
```bash
taisly posts:create \
--video ./launch.mp4 \
--platforms platform_id_1,platform_id_2 \
--description "发布日"
```
安排稍后发布：
```bash
taisly posts:create \
--video ./launch.mp4 \
--platforms platform_id_1,platform_id_2 \
--description "发布日" \
--scheduled "2026-06-14T09:00:00+07:00"
```
检查返回的帖子：
```bash
taisly posts:status --id <historyId>
```
每个命令都打印 JSON，以便智能代理可以解析结果而无需刮取终端文本。
## MCP 服务器
Taisly 在官方 MCP 注册表中发布为：
```txt
io.github.taisly/agent
```
显示名称： **Taisly 社交媒体发布**
远程 MCP 端点：
```txt
https://app.taisly.com/mcp
```
远程 MCP 服务器使用可流式 HTTP 和 OAuth。远程 MCP 工具只能从公共 `videoUrl` 值发布，因为它们无法从您的机器读取本地文件。
Codex 远程 MCP 设置：
```bash
codex mcp add taisly --url https://app.taisly.com/mcp
codex mcp login taisly
```
Claude Code 远程 MCP 设置：
```bash
claude mcp add --transport http taisly https://app.taisly.com/mcp
```
然后要求 Claude Code 验证连接。如果需要 OAuth，Claude Code 可以指导浏览器登录流程。您也可以在使用工具之前使用 `claude mcp login taisly` 显式进行身份验证。
Taisly 智能代理工具包还包括此软件包中的本地 stdio MCP 服务器。在智能代理需要读取本地视频文件时使用本地 MCP：
```json
{
"mcpServers": {
"taisly": {
"command": "npx",
"args": ["@taisly/agent", "mcp"]
}
}
}
```
如果您已经使用手动 API 密钥，可以在 MCP 服务器的 `env` 块中传递 `TAISLY_API_KEY`。
Codex 本地 MCP 设置：
```bash
codex mcp add taisly -- npx @taisly/agent mcp
```
Claude Code 本地 MCP 设置：
```bash
claude mcp add taisly -- npx @taisly/agent mcp
```
然后要求智能代理：
```txt
使用您刚刚添加的本地 Taisly MCP 服务器，并使用 agentId: "<agent-slug>" 运行 Taisly 智能代理设置启动工具。
发送给我登录 URL，等待我在浏览器中完成。
然后运行 Taisly 智能代理签到工具，agentId: "<agent-slug>"。
检查 Taisly 是否已连接并就绪。如果不是，请告诉我哪里出了问题。
```
可用的 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`。仅在用户明确批准视频、目标账户、标题和时间表后设置。
## 智能代理的 JSON 工作流
智能代理可以编写有效载荷文件并将其传递给 CLI：
```json
{
"video": "./launch.mp4",
"platforms": ["platform_id_1", "platform_id_2"],
"description": "发布日。短演示，大更新。",
"scheduled": "2026-06-14T09:00:00+07:00"
}
```
然后运行：
```bash
taisly posts:validate --json ./campaign.json
taisly posts:create --json ./campaign.json
```
`video` 路径必须指向智能代理可访问的真实本地文件。支持的本地预检扩展名包括 `.mp4`、`.mov`、`.avi`、`.mkv`、`.webm`、`.flv`、`.mpeg` 和 `.mpg`。
## 命令
```bash
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 "发布日"
taisly posts:create --video ./launch.mp4 --platforms platform_id_1 --description "发布日"
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 在应用程序中将连接的社交账户称为平台，而许多公共 API 称它们为集成。
## SDK
```js
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: "发布日",
});
const post = await taisly.posts.create({
video: "./launch.mp4",
platforms: [platforms.data[0].id],
description: "发布日",
scheduled: "2026-06-14T09:00:00+07:00",
});
console.log(validation.success);
console.log(post.historyId);
```
## 与 AI 智能代理一起使用
Taisly 智能代理工具包专为用户提供高级指令，智能代理执行安全发布路径的代理工作流而设计。
- Codex：让编码智能代理发布演示视频、发布剪辑或在用户确认后构建更新。
- Claude Code：将社交发布添加到本地内容工作流和活动脚本中。
- Cursor：从开发者工具、内容应用程序和内部自动化中发布视频。
- OpenClaw 和其他智能代理：通过单个 CLI 连接规划、标题编写和发布执行。
推荐的智能代理路径：
```txt
auth:status -> platforms:list -> platforms:schema -> posts:validate -> 用户确认 -> posts:create -> posts:status
```
## 智能代理配方
`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 在 `https://app.taisly.com/mcp` 使用可流式 HTTP。
- 远程 MCP 需要公共视频 URL；使用本地 MCP 或 CLI 处理本地视频文件。
- 媒体上传重用计划稍后实现。
## 链接
- Taisly： <https://taisly.com/en>
- 智能代理工具包页面： <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 注册表： <https://registry.modelcontextprotocol.io/v0.1/servers?search=io.github.taisly%2Fagent>
- SEO 指南： <https://taisly.com/en/blog/ai-agent-social-media-posting-api>
