Agent

🚀 Taisly Agent Kit

ショート動画向けAIエージェントのソーシャルメディア投稿

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

✨ 開発者が選ぶ理由

• Codex、Claude Code、Cursor、OpenClaw、カスタム自動化ツールに AI エージェントのソーシャルメディア投稿を組み込む。
• 1 つのローカルファイルから複数の連携済みソーシャルアカウントへの動画投稿を自動化する。
• エージェントに安全な JSON ワークフローを提供する：アカウントを検出し、ペイロードを検証し、投稿を作成し、ステータスを確認する。
• 各プラットフォーム連携をすべて自分で構築することなく、TikTok API 投稿自動化、Instagram Reels 自動化、YouTube Shorts 投稿、クロスプラットフォームのソーシャルメディア自動化を追加する。

Taisly は連携済みアカウントと投稿実行を処理します。エージェントは計画、キャプション作成、キャンペーンロジック、ワークフローオーケストレーションを処理します。

🧩 エージェントスキル

このパッケージには、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_URL は、デフォルト以外の Taisly API 環境を対象にする必要がある場合を除き、任意です。

🚀 クイックスタート

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

🧪 エージェントレシピ

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