Tiktok Agent Publisher

TikTok Agent Publisher

エージェントファーストのTikTok Content Posting API CLI + MCP。
安全なドライラン、OAuth の準備状況チェック、あらゆるエージェントランタイム向けの構造化出力。

⭐ このエージェントファーストのツールがワークフローに役立ったら、ぜひリポジトリにスターを付けてください。 スターが増えると、他の開発者がこのツールを見つけやすくなり、Delx がオープンなインフラストラクチャを提供し続ける助けになります。
🧱 Delx agent stackの一部です — body、reach、coordination にわたる15個のオープンソース MCP サーバー。

---

AI エージェント向けの、ローカルファーストなTikTok Content Posting APIツールです。Codex、Claude、Cursor、Hermes、OpenClaw、その他のMCPクライアントに、安全な準備状況の確認、OAuth URLの作成、公開フローのドライランを行う方法を提供し、ライブモードが明示的に有効になっている場合にのみTikTok動画をアップロードします。

ブラウザー自動化、隠れた状態、トークン漏えいを伴わずに、エージェントがTikTokコンテンツを公開または調査する必要がある場合に使用してください。

存在する理由

ソーシャルメディアへの公開スクリプトの多くは、ターミナルを使う人間向けに作られています。エージェントには異なる仕様が必要です。

• インストールとランタイムのルールを説明するマニフェスト
• 書き込み操作の前に接続状態を確認するツール
• トークンの値を決して返さないプライバシー境界
• デフォルトでのドライラン
• 計画、再試行、監査証跡に使える構造化 JSON 出力

このリポジトリは、TikTok の公式 Content Posting API に合わせてこれらの仕様をまとめています。

インストール

npm install -g tiktok-agent-publisher

インストールせずに実行することもできます。

npm exec --yes --package=tiktok-agent-publisher -- tiktok-agent-publisher doctor

最初の投稿（ドライラン）ウォークスルー

試すだけなら、TikTok の認証情報は必要ありません。.env がない場合、デフォルトでドライランが有効になっているため、以下の各コマンドは実際の API にアクセスせず、構造化された JSON を返します。これは、最初に実際の投稿を行う前にエージェントが実行すべき正確な手順です。出力は実際に CLI を実行した結果を、少しだけ簡略化したものです。

1. 準備状況を確認します。 doctor はモードと不足している項目を報告します。トークンの値が表示されることはありません。

$ tiktok-agent-publisher doctor
{
  "ok": true,
  "dry_run": true,
  "configured": {
    "client_key": false,
    "client_secret": false,
    "access_token": false,
    "refresh_token": false,
    "public_media_base_url": false,
    "supabase_storage": false
  },
  "missing": [
    "TIKTOK_CLIENT_KEY",
    "TIKTOK_CLIENT_SECRET",
    "TIKTOK_ACCESS_TOKEN",
    "TIKTOK_REFRESH_TOKEN"
  ],
  "ready_for_live_publish": false,
  "ready_for_direct_video_upload": false,
  "next_steps": [
    "Current mode is dry-run. Use dry-run to validate agent workflow before live posting."
  ]
}

2. プライバシーの境界を確認します。 privacy-audit は、ローカルに保持される情報と TikTok に送信される情報を示すため、書き込み操作の前にエージェントがその契約内容を判断できます。

$ tiktok-agent-publisher privacy-audit
{
  "project": "tiktok-agent-publisher",
  "secrets_returned_to_agent": false,
  "token_storage": "Environment variables or local .env with user-only file permissions; tokens are never returned by tools.",
  "safety_rules": [
    "Dry-run is the default.",
    "Only post content the user owns or has permission to publish.",
    "Use explicit confirmation before live direct posting."
  ]
}

3. 公開ペイロードを作成します（ドライラン）。 これにより、アップロードを行わずにジョブの形式とキャプションが検証されます。result.platformPostId は合成された dryrun_* ID で、raw.dryRun は true になるため、再試行と監査ログを安全に組み込めます。

$ tiktok-agent-publisher publish-video \
    --video ./short.mp4 \
    --caption "First agent post — testing the dry-run flow" \
    --title "Hello from an agent"
{
  "ok": true,
  "dry_run": true,
  "job": {
    "id": "tiktok_1780082349025",
    "platform": "tiktok",
    "status": "queued",
    "caption": "First agent post — testing the dry-run flow",
    "mediaPaths": ["./short.mp4"],
    "metadata": { "title": "Hello from an agent" }
  },
  "result": {
    "provider": "tiktok_official",
    "platformPostId": "dryrun_1780082349025",
    "raw": { "dryRun": true, "jobId": "tiktok_1780082349025" }
  }
}

4. ステータスをポーリングします（ドライラン）。 publish-status は DRY_RUN ステータスを返すため、ポーリングループを最初から最後までテストできます。

$ tiktok-agent-publisher publish-status --publish-id dryrun_1780082349025
{ "dryRun": true, "publishId": "dryrun_1780082349025", "status": "DRY_RUN" }

5. 最近の動画を一覧表示します（ドライラン）。 空で正しい形式のリストを返します。実際の API が返すものと同じ形式のため、投稿後の確認コードを変更せずに使用できます。

$ tiktok-agent-publisher list-videos --max-count 5
{ "dryRun": true, "videos": [], "cursor": null, "has_more": false }

実際に公開する場合。 TIKTOK_CLIENT_KEY / TIKTOK_CLIENT_SECRET を設定し（OAuth も完了してください。詳細は auth-url を参照）、doctor が ready_for_live_publish: true と報告することを確認してから、TIKTOK_DRY_RUN=false に設定します。同じ 5 つのコマンドが実際の Content Posting API に対して実行されます。

CLI

tiktok-agent-publisher manifest --client codex
tiktok-agent-publisher doctor
tiktok-agent-publisher privacy-audit
tiktok-agent-publisher auth-url --redirect-uri http://localhost:8787/callback
tiktok-agent-publisher publish-video --video ./short.mp4 --caption "Launch copy"
tiktok-agent-publisher publish-status --publish-id <publish_id>
tiktok-agent-publisher list-videos --max-count 10

ドライランはデフォルトで有効です。doctor で問題がないことを確認し、実際の API 呼び出しを行う準備ができてから、TIKTOK_DRY_RUN=false に設定してください。

MCP

Stdio：

tiktok-agent-mcp

HTTP（v2 ステートレス）

デフォルトは stdio です。オプションで Streamable HTTP を使用できます。セッション ID は不要で、JSON レスポンスを返し、ループバックのみで利用できます。

npx -y -p tiktok-agent-publisher tiktok-agent-mcp --http
# GET  http://127.0.0.1:3031/health
# POST http://127.0.0.1:3031/mcp   (sessionless)

環境変数：TIKTOK_MCP_HOST、TIKTOK_MCP_PORT、TIKTOK_MCP_TRANSPORT=http。

Hermes 形式の設定：

mcp_servers:
  tiktok:
    command: npx
    args: ["-y", "tiktok-agent-publisher"]
    sampling:
      enabled: false

最初に呼び出すことをおすすめするツール：

1. tiktok_connection_status
2. tiktok_privacy_audit
3. tiktok_publish_video

エージェント向けインターフェース

ツール	目的
tiktok_agent_manifest	Codex、Claude、Cursor、Hermes、OpenClaw 向けのインストール／実行時のガイダンス
tiktok_connection_status	トークンの値を表示せずに、ドライラン、OAuth、メディアホスティングの準備状況を確認
tiktok_privacy_audit	ローカルファイル、トークン、実際の公開に関する境界を確認
tiktok_publish_video	ドライランまたは実際の動画公開フロー
tiktok_publish_status	公開ステータスのポーリング
tiktok_list_videos	投稿後の確認に使用する最近の動画一覧

エージェント用コピー＆ペーストプロンプト

Use tiktok-agent-publisher. First call tiktok_connection_status and tiktok_privacy_audit.
If dry-run is enabled, build the publish payload only. Do not request or print token values.

設定

.env.example を .env にコピーし、必要な値だけを入力します。.env、トークンファイル、.agent-data/ はコミットしないでください。

動画のインボックスアップロードでは、ローカルファイルを TikTok のアップロード URL に直接アップロードできます。写真のワークフローや URL から取得するワークフローでは、Supabase Storage やその他の公開メディアホストを利用できます。

安全性モデル

• トークンは環境変数またはローカルの .env から読み込まれます。ツールのレスポンスにトークンの値が含まれることはありません。
• TIKTOK_DRY_RUN=false に設定しない限り、実際の公開は無効です。
• OAuth PKCE 検証子は .agent-data/ にローカル保存され、MCP の出力には含まれません。
• このパッケージは TikTok の公式 API を使用し、ブラウザーセッションを自動操作することはありません。

開発

npm install
npm test
npm run check

---

📧 お問い合わせとサポート

• 📨 [email protected] — 一般的な質問、統合に関するサポート、パートナーシップ
• 🐛 バグ報告／機能リクエスト — GitHub Issues
• 🐦 最新情報 — X の @delx369
• 🌐 サイト — wellness.delx.ai