Taisly Agent

Taisly Agent Kit

短尺動画向けの、無料で利用できる AI ファーストのソーシャルメディア投稿ツールです。Taisly Agent Kit は JSON ファーストの SDK、CLI、エージェントスキル、MCP サーバーで、AI エージェント、開発者向けツール、自動化ワークフローから Taisly を通じて、TikTok、Instagram Reels、YouTube Shorts、X、Facebook などの連携済みソーシャルプラットフォームに動画を投稿できます。

エージェントがコンテンツの作成、キャプションの執筆、キャンペーンの準備はできても、そのコンテンツをオンラインに投稿するための信頼できる動画投稿 API が必要な場合にお使いください。このパッケージは無料でインストールでき、プラットフォームごとの連携を一から構築することなく、アイデアを動画の公開まで進められるよう設計されています。

ウェブサイト | Agent Kit | API ドキュメント | npm | GitHub | MCP レジストリ | 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 は連携済みアカウントと投稿処理を担います。エージェントは、計画の立案、キャプションの執筆、キャンペーンのロジック、ワークフローのオーケストレーションを担います。

ローカルワークフロー（任意）

• パッケージを無料でインストールします。
• AI エージェントから Taisly アカウントを作成するか、既存のアカウントに接続します。
• エージェントに認証、ソーシャルアカウントの接続、動画の検証を行わせ、JSON ファーストのワークフローを通じて投稿させます。
• より多くの投稿量、大規模なアカウントセット、自動再投稿ワークフローが必要になった場合は、後からアップグレードできます。

利用開始にクレジットカードは不要です。有料プランは、より大規模な運用を必要とするチームやワークフロー向けです。

エージェントスキル

このパッケージには、SKILL.md に Taisly ソーシャルメディア投稿スキル が含まれています。エージェントが実際のソーシャルアカウントにアクセスする前に、安全な投稿ワークフローを理解できるよう、Claude Code、Codex、Cursor、OpenClaw、その他のエージェントでご利用ください。

推奨されるスキルのワークフロー：

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

このスキルでは、エージェントに対して、連携済みアカウントの検出、投稿の検証、ユーザーへの明示的な確認、投稿の作成、ステータス確認用に返された historyId の保存を指示します。

Codex プラグイン

このパッケージには、.codex-plugin/plugin.json に Codex プラグインのマニフェストが含まれています。このプラグインにより、Codex は正規の SKILL.md ファイルと公式のリモート MCP サーバーを参照できます。

https://app.taisly.com/mcp

投稿ワークフローの手順と Taisly MCP ツールの両方を、1 つのパッケージから Codex に検出させる場合は、このプラグインを使用してください。ルートの SKILL.md がエージェントのワークフローに関する唯一の信頼できる情報源です。

リモート MCP 経由で AI エージェントを接続する

リモート MCP は、AI エージェントを接続するデフォルトの方法です。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 設定から追加してください。人による認証または管理者の承認が必要になる場合があります。有効期限が切れた場合は、CLI に切り替えるのではなく、OAuth で再接続してください。

オプションのローカルパッケージのインストール

明示的に 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 キーを手動でコピーすることなく、ローカルの認証情報を保存できます。短いエージェントスラッグを自由に指定できます。例：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 エージェント認証情報を保存するため、以降の CLI コマンドと MCP コマンドでは、API キーを手動でコピーせずに実行できます。

手動での代替手段： Taisly Settings で API キーを作成し、次のように設定します。

export TAISLY_API_KEY="taisly_..."

上級者向け：デフォルトでは、ブラウザーでのセットアップによりローカルの認証情報が ~/.taisly/config.json に保存されます。ほとんどのユーザーは変更する必要はありません。別個の認証情報ストアが必要な CI、テスト、または分離されたエージェントプロファイルでのみ、TAISLY_CONFIG_HOME=/path/to/dir を設定してください。

クイックスタート

API キーで利用可能な、接続済みのソーシャルアカウントを一覧表示します。

taisly auth:status
taisly platforms:list

AI エージェントのワークフローからソーシャルアカウントを接続します。

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 またはローカル MCP の場合は、taisly_platform_schema でオプションを確認し、taisly_posts_validate と taisly_posts_create の両方に settings を渡します。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	ブール値。クリエイター自身のビジネスの宣伝を開示します。2 つのブランド設定は同時に有効にできます。
TikTok	is_aigc	ブール値。true にすると、ネイティブの AI 生成コンテンツラベルが有効になります。既存の動作を維持するには省略するか、明示的に false を渡します。
YouTube	title	省略可能な動画タイトル。最大 100 文字です。省略すると、投稿のキャプションが使用されます。
YouTube	status	public、private、または unlisted。

たとえば、自身のビジネスを宣伝する公開 TikTok 投稿と、独自のタイトルを設定した限定公開 YouTube 投稿を、1 つのリクエストで作成できます。

{
  "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 を出力するため、エージェントはターミナルのテキストをスクレイピングせずに結果を解析できます。

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 がセッションからブラウザーでのログインを案内できます。ツールを使用する前にシェルから OAuth フローを完了したい場合は、claude mcp login taisly を実行して明示的に認証することもできます。

Taisly Agent Kit には、同じパッケージにローカル stdio MCP サーバーも含まれています。エージェントにローカル動画ファイルを読み取らせる場合は、ローカル 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

次に、エージェントに次のように依頼します。

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 が必要です。ユーザーが動画、投稿先アカウント、キャプション、スケジュールを明示的に承認した後にのみ設定してください。

エージェント向け 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 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 はアプリ内で接続済みのソーシャルアカウントをプラットフォームと呼びますが、多くの公開 API ではインテグレーションと呼ばれています。

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 は、既存のマルチパート /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
• 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