name: tiktok-publisher description: TikTok動画投稿。Content Posting API v2を使ったCLIベースの投稿ツール。「TikTokに投稿して」「TikTokにアップロードして」「この動画をTikTokに公開して」で発火。 metadata: {"openclaw": {"emoji": "🎵"}}

tiktok-publisher — TikTok動画投稿

Content StudioのCLIツールを使い、TikTok Content Posting API v2で動画を投稿するスキル。

📋 事前確認（必須）

LEARNINGS.md を読む
トークンが有効か確認（~/.config/content-studio/tiktok-tokens.json の expires_at）

🛡️ 重複投稿ガード（自動）

pnpm tiktok:publish は投稿前に VIDEO_INVENTORY.md を自動チェックする。

スラッグが「✅ 公開済み」→ 投稿を中断
スラッグが「📬 ドラフト」→ 投稿を中断
スラッグが「未投稿」→ 投稿を実行

このガードは inventory に書かれた重複 を止める。

ただし候補選定まで自動ではない。 VIDEO_INVENTORY.md が古い、または API 確認が失敗している状態では投稿しない。

いつ使うか

「TikTokに投稿して」「TikTokにアップロードして」
「この動画をTikTokに公開して」

🔗 ワークフローでの位置づけ

SNS（announce）ステージのスキルとして、動画コンテンツの投稿に使用。

Phase	スキル	内容
1	draft-writer	記事作成
2	content-manager	レビュー
3	note-publisher / zenn-publisher	記事公開
4	x-publisher / bluesky-publisher	SNS告知
5	tiktok-publisher	TikTok投稿

🏗️ アプリ構成

現在 Sandbox（未審査）。ドラフト（受信箱）モードのみ。直接投稿は不可。

詳細: references/app-config.md

🚀 投稿フロー

1. 認証（初回 or トークン切れ時）

source ~/.zshrc && pnpm tiktok:auth

ブラウザでTikTok認証画面が開く
認証後、content-studioのコールバックページにリダイレクト
表示されたURLをコピーしてターミナルに貼り付け
トークンが ~/.config/content-studio/tiktok-tokens.json に保存される

2. 動画投稿

# 基本（ドラフトモード、スマホの受信トレイに届く）
pnpm tiktok:publish --file video.mp4 --title "タイトル"

# 説明付き + 公開記録
pnpm tiktok:publish --file video.mp4 --title "タイトル" --description "説明文" --slug my-draft-slug

スクリプト: scripts/publish.sh — 環境変数チェック付きの投稿ヘルパー一括フロー: scripts/check-and-publish.sh — チェック→投稿の一連フロー

3. スマホで確認・公開

TikTokアプリ（スマホ）を開く
画面下部の 「受信トレイ」 をタップ
「システム通知」 を開く
「Your content from ... is ready」 の通知をタップ
編集画面で内容確認 → 投稿

4. 未投稿動画を確認（毎日運用では必須）

pnpm tiktok:list    # live状態を確認
pnpm tiktok:check   # 次候補を機械的に出す

運用ルール:

pnpm tiktok:list または pnpm tiktok:check がトークン切れで失敗したら、先に pnpm tiktok:auth --refresh
リフレッシュ後も live 確認ができないなら、その回は投稿しない
pnpm tiktok:check は候補出しの補助。最終判断は API と VIDEO_INVENTORY.md の両方で行う
VIDEO_INVENTORY.md は集計行より個別行を信じる

5. ステータス確認（任意）

pnpm tiktok:status {publish_id}

6. トークンリフレッシュ

pnpm tiktok:auth --refresh

📋 CLIオプション

オプション	説明	デフォルト
`--file`	ローカル動画ファイルパス	-
`--url`	動画URL	-
`--title`	動画タイトル（必須）	-
`--description`	動画の説明	-
`--privacy`	公開範囲（直接投稿時のみ）	`SELF_ONLY`
`--draft`	ドラフト（受信箱）モード	デフォルト
`--direct`	直接投稿モード（審査済みのみ）	-
`--aigc`	AI生成コンテンツとして開示	true（デフォルトON）
`--no-aigc`	AI生成コンテンツの開示を無効化	-
`--slug`	ドラフトslug（公開記録保存）	-
`--no-wait`	ステータス確認スキップ	false

✅ 投稿前チェックリスト

source ~/.zshrc で環境変数を読み込み済み
pnpm tiktok:auth で認証済み（トークンが有効）
pnpm tiktok:list か pnpm tiktok:check が成功している
動画ファイルがMP4形式
動画が最大時間制限内（600秒 = 10分）
タイトルが設定されている
投稿後、スマホのTikTokアプリで受信トレイを確認

📝 公開記録

--slug を指定すると、published/{slug}/tiktok.json に記録が保存される。

記録フォーマット: references/example-publish-record.json

🔧 トラブルシューティング

詳細: references/troubleshooting.md

🔗 関連スキル

x-publisher: X(Twitter)投稿
bluesky-publisher: Bluesky投稿
content-manager: コンテンツ管理

📂 実装ファイル

詳細: references/implementation-structure.md

✅ 完了チェックリスト

動画が正常にアップロードされた
スマホの受信トレイで確認できた
--slug 指定時は公開記録が保存された
LEARNINGS.md に学びを追記

⚠️ よくある落とし穴

AIGC開示の未設定: AI生成画像を含む動画で is_aigc: true を送信しないと、TikTokの自動検出でコミュニティガイドライン違反になる。デフォルトONになっているが、--no-aigc を不用意に使わないこと
重複投稿: VIDEO_INVENTORY.md の集計行と個別行の状態がズレることがある。必ず pnpm tiktok:list と pnpm tiktok:check の両方で確認してから投稿する。ファイル記録よりAPIの実状態を優先すること
トークン切れに気づかず投稿を試みる: tiktok:list / tiktok:check がトークン切れで失敗した場合、live確認ができない状態で投稿してはいけない。先に pnpm tiktok:auth --refresh を実行し、それでも確認できなければその回は投稿しない
Sandboxで直接投稿（--direct）を試す: 未審査アプリでは直接投稿は403エラーになる。デフォルトのドラフト（受信箱）モードを使う
PCで受信トレイを確認しようとする: ドラフトモードの動画はスマホのTikTokアプリの「受信トレイ → システム通知」からのみ確認可能。PC Webでは確認不可
PKCE パラメータなしでOAuth認証: TikTok OAuth v2は code_challenge + code_verifier が必須。PKCEなしだとエラーになる
Redirect URIにlocalhostを使用: Sandboxでも localhost は使えない。実ドメインのコールバックURL（content-studio.craftgarden.studio）が必要
環境変数の読み込み漏れ: Bashツールからは ~/.zshrc が自動では読み込まれない。source ~/.zshrc を実行するか、TIKTOK_CLIENT_KEY / TIKTOK_CLIENT_SECRET を直接指定する

動画でも届けよう。 🎵