Skip to content
Back to search

taisly-agent-kit

Free AI-first short-form video publishing for TikTok, Instagram Reels, YouTube Shorts, X, and Facebook from Claude Code through Taisly.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/taisly-agent/badge.svg)](/listings/taisly-agent)

HTML

<a href="/listings/taisly-agent"><img src="/api/listings/taisly-agent/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

List the connected social accounts available to the API key:

taisly auth:status
taisly platforms:list

Connect a social account from an AI-agent flow:

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

Supported connect slugs: `instagram`, `tiktok`, `youtube`, `x`, `facebook`.

Validate a local video before publishing:

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

Publish now:

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

Schedule for later:

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

Check the returned post:

taisly posts:status --id <historyId>

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/plugin.json · Manifest · 14 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. {
  2. "name": "taisly-agent-kit",
  3. "description": "Free AI-first short-form video publishing for TikTok, Instagram Reels, YouTube Shorts, X, and Facebook from Claude Code through Taisly.",
  4. "version": "0.2.10",
  5. "author": {
  6. "name": "Taisly"
  7. },
  8. "homepage": "https://github.com/taisly/agent",
  9. "repository": {
  10. "type": "git",
  11. "url": "https://github.com/taisly/agent.git"
  12. },
  13. "license": "MIT"
  14. }
README.md · README · 463 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. ![Taisly Agent Kit: AI agent social media posting for TikTok, Instagram Reels, YouTube Shorts, X, and Facebook](assets/taisly-agent-banner.jpg)
  2. # Taisly Agent Kit
  3. [![Taisly MCP server](https://glama.ai/mcp/servers/taisly/agent/badges/card.svg)](https://glama.ai/mcp/servers/taisly/agent)
  4. [![Taisly MCP score](https://glama.ai/mcp/servers/taisly/agent/badges/score.svg)](https://glama.ai/mcp/servers/taisly/agent)
  5. Free AI-first social media posting for short-form video. Taisly Agent Kit is a JSON-first SDK, CLI, Agent Skill, and MCP server that lets AI agents, developer tools, and automation workflows publish videos to TikTok, Instagram Reels, YouTube Shorts, X, Facebook, and other connected social platforms through Taisly.
  6. Use it when your agent can create content, write captions, or prepare a campaign, but still needs a reliable video publishing API to put that content online. The package is free to install and designed to get an agent from idea to published video without building every platform integration yourself.
  7. [Website](https://taisly.com/en) | [Agent Kit](https://taisly.com/en/ai-agent-kit) | [API Docs](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) | [Glama](https://glama.ai/mcp/servers/taisly/agent) | [Guide](https://taisly.com/en/blog/ai-agent-social-media-posting-api)
  8. ## Languages
  9. Read this guide in:
  10. [English](docs/i18n/README.en.md),
  11. [Español](docs/i18n/README.es.md),
  12. [Deutsch](docs/i18n/README.de.md),
  13. [Français](docs/i18n/README.fr.md),
  14. [Português](docs/i18n/README.pt-PT.md),
  15. [ไทย](docs/i18n/README.th.md),
  16. [中文](docs/i18n/README.zh-CN.md),
  17. [Bahasa Indonesia](docs/i18n/README.id.md),
  18. [Русский](docs/i18n/README.ru.md),
  19. [Nederlands](docs/i18n/README.nl.md),
  20. [한국어](docs/i18n/README.ko.md),
  21. [日本語](docs/i18n/README.ja.md),
  22. [العربية](docs/i18n/README.ar.md),
  23. [Türkçe](docs/i18n/README.tr.md),
  24. [Polski](docs/i18n/README.pl.md).
  25. ## Why developers use it
  26. - Build AI agent social media posting into Codex, Claude Code, Cursor, OpenClaw, and custom automation tools.
  27. - Automate video publishing from one local file to multiple connected social accounts.
  28. - Give agents a safe JSON workflow: discover accounts, validate payloads, create posts, and check status.
  29. - Add TikTok API posting automation, Instagram Reels automation, YouTube Shorts publishing, and cross-platform social media automation without building every platform integration yourself.
  30. - Start free, then upgrade only when the publishing workflow grows.
  31. Taisly handles the connected accounts and posting execution. Your agent handles planning, caption writing, campaign logic, or workflow orchestration.
  32. ## Optional local workflows
  33. - Install the package for free.
  34. - Create or connect a Taisly account from your AI agent.
  35. - Let the agent authenticate, connect social accounts, validate videos, and publish through a JSON-first workflow.
  36. - Upgrade later when you need higher-volume publishing, larger account sets, or automatic repost workflows.
  37. No credit card is required to get started. Paid plans are for teams and workflows that need more scale.
  38. ## Agent Skill
  39. This package includes the **Taisly Social Media Posting Skill** in `SKILL.md`. Use it with Claude Code, Codex, Cursor, OpenClaw, and other agents when you want the agent to understand the safe posting workflow before it touches live social accounts.
  40. Recommended skill workflow:
  41. ```txt
  42. auth -> platforms -> validate -> confirm -> create -> status
  43. ```
  44. The skill tells agents to discover connected accounts, validate the post, ask for explicit user confirmation, create the post, and save the returned `historyId` for status checks.
  45. ## Codex plugin
  46. This package includes a Codex plugin manifest in `.codex-plugin/plugin.json`. The plugin points Codex to the canonical `SKILL.md` file and the official remote MCP server:
  47. ```txt
  48. https://app.taisly.com/mcp
  49. ```
  50. Use the plugin when you want Codex to discover both the posting workflow instructions and the Taisly MCP tools from one package. The root `SKILL.md` is the single source of truth for the agent workflow.
  51. ## Connect an AI agent through remote MCP
  52. Remote MCP is the default AI-agent connection. If Taisly tools are already available, call `taisly_auth_status` and `taisly_platforms_list` directly. OAuth provides access; do not install this package or ask for an API key for that connection.
  53. ```txt
  54. 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.
  55. Full documentation: https://docs.taisly.com/docs/mcp
  56. ```
  57. The remote server URL is `https://app.taisly.com/mcp`. Add it through your client's remote MCP and OAuth settings if needed. Human authorization or administrator approval may be required. On expiry, reconnect through OAuth rather than switching to the CLI.
  58. ## Optional local package installation
  59. Use the following package instructions for explicit SDK, CLI or local-file workflows. They are not remote MCP setup requirements.
  60. ```bash
  61. npm install -g @taisly/agent
  62. ```
  63. Or run it without a global install:
  64. ```bash
  65. npx @taisly/agent help
  66. ```
  67. Start the stdio MCP server:
  68. ```bash
  69. npx @taisly/agent mcp
  70. ```
  71. For local development inside this repository:
  72. ```bash
  73. node packages/agent/src/cli.js help
  74. ```
  75. ## Local package authentication
  76. For the local package, browser setup can store a local credential without manually copying an API key. Use any short agent slug, for example `claude-code`, `codex`, `cursor`, `windsurf`, `openclaw`, `hermes-agent`, `cline`, or `aider`.
  77. ```txt
  78. Help me set up Taisly Agent Kit.
  79. 1. Install the CLI: npm i -g @taisly/agent
  80. 2. Run taisly setup --agent <agent-slug> and send me the login URL so I can finish authentication.
  81. 3. Wait for me to finish login in the browser.
  82. 4. Run taisly checkin --agent <agent-slug>.
  83. 5. Tell me if Taisly is connected and ready. If not, tell me what failed.
  84. If you cannot install or run the Taisly CLI in this environment, stop and tell me to open Taisly Settings instead.
  85. ```
  86. The setup command stores a local Taisly agent credential, so later CLI and MCP commands can run without manually copying an API key.
  87. Manual fallback: create an API key in [Taisly Settings](https://app.taisly.com/en/settings), then set:
  88. ```bash
  89. export TAISLY_API_KEY="taisly_..."
  90. ```
  91. Advanced: by default, the browser setup stores the local credential in `~/.taisly/config.json`. Most users should not change this. Set `TAISLY_CONFIG_HOME=/path/to/dir` only for CI, tests, or isolated agent profiles that need a separate credential store.
  92. ## Quick start
  93. List the connected social accounts available to the API key:
  94. ```bash
  95. taisly auth:status
  96. taisly platforms:list
  97. ```
  98. Connect a social account from an AI-agent flow:
  99. ```bash
  100. taisly platforms:connect:start --platform instagram
  101. # Open the returned connectUrl and finish authorization in the browser.
  102. taisly platforms:connect:check --platform instagram
  103. taisly platforms:list
  104. ```
  105. Supported connect slugs: `instagram`, `tiktok`, `youtube`, `x`, `facebook`.
  106. Validate a local video before publishing:
  107. ```bash
  108. taisly posts:validate \
  109. --video ./launch.mp4 \
  110. --platforms platform_id_1,platform_id_2 \
  111. --description "Launch day"
  112. ```
  113. Publish now:
  114. ```bash
  115. taisly posts:create \
  116. --video ./launch.mp4 \
  117. --platforms platform_id_1,platform_id_2 \
  118. --description "Launch day"
  119. ```
  120. Schedule for later:
  121. ```bash
  122. taisly posts:create \
  123. --video ./launch.mp4 \
  124. --platforms platform_id_1,platform_id_2 \
  125. --description "Launch day" \
  126. --scheduled "2026-06-14T09:00:00+07:00"
  127. ```
  128. Check the returned post:
  129. ```bash
  130. taisly posts:status --id <historyId>
  131. ```
  132. ## Posting settings
  133. Discover supported options and accepted values for each destination platform:
  134. ```bash
  135. taisly platforms:schema --platform TikTok
  136. taisly platforms:schema --platform YouTube
  137. ```
  138. Group options by platform name in `settings`. For example:
  139. ```bash
  140. taisly posts:create \
  141. --video ./launch.mp4 \
  142. --platforms your_tiktok_platform_id,your_youtube_platform_id \
  143. --description "Product walkthrough" \
  144. --settings '{"TikTok":{"status":"PUBLIC_TO_EVERYONE"},"YouTube":{"title":"Product walkthrough","status":"unlisted"}}'
  145. ```
  146. With `--json`, put the same object in the input file's `settings` property. SDK
  147. calls accept `settings` as an object. For remote or local MCP, discover options
  148. with `taisly_platform_schema` and pass `settings` to both `taisly_posts_validate`
  149. and `taisly_posts_create`. The HTTP API accepts a JSON-encoded `settings` form field.
  150. | Platform | Settings | Meaning |
  151. | --- | --- | --- |
  152. | TikTok | `status` | `PUBLIC_TO_EVERYONE`, `MUTUAL_FOLLOW_FRIENDS`, `FOLLOWER_OF_CREATOR`, or `SELF_ONLY`, subject to the account's available visibility options. |
  153. | TikTok | `comment_disabled`, `duet_disabled`, `stitch_disabled` | Boolean switches; `true` disables the interaction. |
  154. | TikTok | `brand_content_toggle` | Boolean; discloses a paid partnership promoting a third-party business. Cannot be combined with `SELF_ONLY`. |
  155. | TikTok | `brand_organic_toggle` | Boolean; discloses promotion of the creator's own business. Both brand switches may be enabled together. |
  156. | TikTok | `is_aigc` | Boolean; `true` enables the native AI-generated content label. Omit to keep existing behavior, or explicitly pass `false`. |
  157. | YouTube | `title` | Optional video title, up to 100 characters. Omit to use the post caption. |
  158. | YouTube | `status` | `public`, `private`, or `unlisted`. |
  159. For example, a public TikTok post promoting your own business and an unlisted
  160. YouTube post with its own title can share one request:
  161. ```json
  162. {
  163. "settings": {
  164. "TikTok": {
  165. "status": "PUBLIC_TO_EVERYONE",
  166. "brand_organic_toggle": true,
  167. "comment_disabled": false
  168. },
  169. "YouTube": {
  170. "title": "Product walkthrough",
  171. "status": "unlisted"
  172. }
  173. }
  174. }
  175. ```
  176. These settings work with `--settings`, `--json`, SDK calls, and both MCP servers,
  177. for immediate and scheduled posts. They apply to all selected accounts on the
  178. corresponding platform. Omitted fields keep the usual posting behavior. These
  179. options apply only to the requested post. TikTok account restrictions still apply.
  180. Every command prints JSON so agents can parse results without scraping terminal text.
  181. ## MCP server
  182. Taisly is published in the official MCP Registry as:
  183. ```txt
  184. io.github.taisly/agent
  185. ```
  186. Display name: **Taisly Social Media Posting**
  187. Remote MCP endpoint:
  188. ```txt
  189. https://app.taisly.com/mcp
  190. ```
  191. The remote MCP server uses streamable HTTP and OAuth. Remote MCP tools can publish only from public `videoUrl` values because they cannot read local files from your machine.
  192. Codex remote MCP setup:
  193. ```bash
  194. codex mcp add taisly --url https://app.taisly.com/mcp
  195. codex mcp login taisly
  196. ```
  197. Claude Code remote MCP setup:
  198. ```bash
  199. claude mcp add --transport http taisly https://app.taisly.com/mcp
  200. ```
  201. Then ask Claude Code to verify the connection. If OAuth is needed, Claude Code can guide the browser login from the session. You can also authenticate explicitly with `claude mcp login taisly` if you want to complete the OAuth flow from the shell before using tools.
  202. Taisly Agent Kit also includes a local stdio MCP server in the same package. Use local MCP when your agent needs to read local video files:
  203. ```json
  204. {
  205. "mcpServers": {
  206. "taisly": {
  207. "command": "npx",
  208. "args": ["@taisly/agent", "mcp"]
  209. }
  210. }
  211. }
  212. ```
  213. If you already use a manual API key, you can still pass `TAISLY_API_KEY` in the MCP server `env` block.
  214. Codex local MCP setup:
  215. ```bash
  216. codex mcp add taisly -- npx @taisly/agent mcp
  217. ```
  218. Claude Code local MCP setup:
  219. ```bash
  220. claude mcp add taisly -- npx @taisly/agent mcp
  221. ```
  222. Then ask the agent:
  223. ```txt
  224. Use the local Taisly MCP server you just added and run the Taisly agent setup start tool with agentId: "<agent-slug>".
  225. Send me the login URL and wait for me to finish in the browser.
  226. Then run the Taisly agent checkin tool with agentId: "<agent-slug>".
  227. After checkin, run the Taisly auth status tool.
  228. Tell me if Taisly is connected and ready. If not, tell me what failed.
  229. ```
  230. Available MCP tools:
  231. - `taisly_agent_setup_start`
  232. - `taisly_agent_checkin`
  233. - `taisly_auth_status`
  234. - `taisly_platforms_list`
  235. - `taisly_platform_schema`
  236. - `taisly_platform_connect_start`
  237. - `taisly_platform_connect_check`
  238. - `taisly_posts_validate`
  239. - `taisly_posts_create`
  240. - `taisly_posts_status`
  241. - `taisly_posts_list`
  242. - `taisly_reposts_list`
  243. - `taisly_reposts_create`
  244. `taisly_posts_create` requires `confirmed: true`. Set it only after the user explicitly approves the video, destination accounts, caption, and schedule.
  245. ## JSON workflow for agents
  246. Agents can write a payload file and pass it to the CLI:
  247. ```json
  248. {
  249. "video": "./launch.mp4",
  250. "platforms": ["platform_id_1", "platform_id_2"],
  251. "description": "Launch day. Short demo, big update.",
  252. "scheduled": "2026-06-14T09:00:00+07:00"
  253. }
  254. ```
  255. Then run:
  256. ```bash
  257. taisly posts:validate --json ./campaign.json
  258. taisly posts:create --json ./campaign.json
  259. ```
  260. The `video` path must point to a real local file available to the agent. Supported local preflight extensions are `.mp4`, `.mov`, `.avi`, `.mkv`, `.webm`, `.flv`, `.mpeg`, and `.mpg`.
  261. ## Commands
  262. ```bash
  263. taisly auth:status
  264. taisly setup --agent <agent-slug>
  265. taisly checkin --agent <agent-slug>
  266. taisly platforms:list
  267. taisly integrations:list
  268. taisly platforms:schema --platform TikTok
  269. taisly posts:validate --video ./launch.mp4 --platforms platform_id_1 --description "Launch day"
  270. taisly posts:create --video ./launch.mp4 --platforms platform_id_1 --description "Launch day"
  271. taisly posts:create --json ./campaign.json
  272. taisly posts:list --page 1
  273. taisly posts:status --id <historyId>
  274. taisly reposts:list
  275. taisly reposts:create --from <platform_id> --to <platform_id_1,platform_id_2>
  276. taisly mcp
  277. ```
  278. `integrations:*` commands are aliases for `platforms:*` commands. Taisly calls connected social accounts platforms in the app, while many public APIs call them integrations.
  279. ## SDK
  280. ```js
  281. import { Taisly } from "@taisly/agent";
  282. const taisly = new Taisly({
  283. apiKey: process.env.TAISLY_API_KEY,
  284. });
  285. const platforms = await taisly.platforms.list();
  286. const validation = await taisly.posts.validate({
  287. video: "./launch.mp4",
  288. platforms: [platforms.data[0].id],
  289. description: "Launch day",
  290. });
  291. const post = await taisly.posts.create({
  292. video: "./launch.mp4",
  293. platforms: [platforms.data[0].id],
  294. description: "Launch day",
  295. scheduled: "2026-06-14T09:00:00+07:00",
  296. });
  297. console.log(validation.success);
  298. console.log(post.historyId);
  299. ```
  300. ## Use with AI agents
  301. Taisly Agent Kit is designed for agentic workflows where the user gives a high-level instruction and the agent executes a safe posting path.
  302. - Codex: let a coding agent publish demo videos, launch clips, or build updates after user confirmation.
  303. - Claude Code: add social posting to local content workflows and campaign scripts.
  304. - Cursor: ship video publishing from developer tools, content apps, and internal automation.
  305. - OpenClaw and other agents: connect planning, caption writing, and posting execution through a single CLI.
  306. Recommended agent path:
  307. ```txt
  308. auth:status -> platforms:list -> platforms:schema -> posts:validate -> user confirmation -> posts:create -> posts:status
  309. ```
  310. ## Agent recipes
  311. The `examples/` folder includes copy-paste workflows for common coding agents:
  312. - `examples/codex/post-video.md`
  313. - `examples/claude-code/schedule-video.md`
  314. - `examples/cursor/post-build-demo-video.md`
  315. - `examples/post-video.sh`
  316. - `examples/schedule-video.sh`
  317. ## What this package is not
  318. - It is not a social media dashboard.
  319. - It is not a video editor.
  320. - It does not replace a Taisly account.
  321. - It requires connected social accounts and a Taisly agent credential or API key.
  322. - It does not bypass platform rules, account permissions, or media validation.
  323. ## Current limits
  324. - `posts:create` uses the existing multipart `/post` API.
  325. - `posts:status` reads recent history because a single-post status endpoint is not available yet.
  326. - `posts:validate` is local preflight; final validation still happens in Taisly.
  327. - Local MCP uses stdio transport. Remote MCP uses streamable HTTP at `https://app.taisly.com/mcp`.
  328. - Remote MCP requires public video URLs; use local MCP or the CLI for local video files.
  329. - Media upload reuse is planned later.
  330. ## Links
  331. - Taisly: <https://taisly.com/en>
  332. - Agent Kit page: <https://taisly.com/en/ai-agent-kit>
  333. - API docs: <https://docs.taisly.com/en/docs>
  334. - npm package: <https://www.npmjs.com/package/@taisly/agent>
  335. - GitHub repo: <https://github.com/taisly/agent>
  336. - MCP Registry: <https://registry.modelcontextprotocol.io/v0.1/servers?search=io.github.taisly%2Fagent>
  337. - SEO guide: <https://taisly.com/en/blog/ai-agent-social-media-posting-api>

Version history

  • v0.2.1010/23/2026

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.