Communitygithub.com

TeamWiseFlow/tiktok-post

ブラウザを使って動画(または画像カルーセル)をTikTokにアップロードして公開します。

tiktok-post とは?

このスキルは、ブラウザベースの自動操作を活用して、TikTokへの動画投稿を効率的に行うためのツールです。ユーザーが「動画をTikTokに投稿したい」「video-producerで生成した短い動画をクロス投稿したい」「キャプション、ハッシュタグ、カバー画像を設定したい」という要望に応えます。対応プラットフォームはTikTok(国際版)で、操作対象はPCブラウザです。事前にブラウザセッションでtiktok.comにログインしている必要があります。ワークフローは、Cookieのウォームアップ、ファイルのアップロード、キャプションとカバーの設定、投稿実行、URL確認の一連の流れで構成されています。アップロードタイムアウトなどの一般的なエラーに対する具体的なハンドリング手順と、信頼性を高めるための対処法を提供します。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/TeamWiseFlow/wiseflow/tree/master/addons/officials/crew/selfmedia-operator/skills/tiktok-post

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

TikTok 公開スキル

このスキルは以下の場合に使用します。

  • ユーザーがTikTok(国際版)に動画を公開したい場合
  • video-producerで生成した動画をクロス投稿する必要がある場合
  • TikTok投稿のキャプション、ハッシュタグ、カバー画像を設定する必要がある場合

前提条件: ブラウザセッションがtiktok.comにログインしていること。


一般制約

  • ファイルをアップロードする前に、必ず /tmp/openclaw/uploads/ にコピーする必要があります(browser ツールのサンドボックス制限)。
  • browser upload ツールは「タイムアウトエラー」を返すことがありますが、これはアップロード失敗を意味しません。アップロード後はスナップショットでページの状態(プログレスバー、処理状況のテキスト)を確認してください。
  • input.files.length が0かどうかでアップロードの成否を判断しないでください! input.files.length == 0 はアップロード失敗を意味しません。
  • browser failed: timed out. Restart the OpenClaw gateway ... エラーが発生した場合でも、再起動やエラー報告は不要です。30秒待ってから元のページで操作を続けてください。それでも操作できない場合は、さらに30秒待ちます。それでもダメな場合は、ブラウザを閉じて開き直します。閉じて開き直してもエラーが続く場合のみ、本当のエラーなので停止してユーザーにフィードバックしてください。
  • キャプションの入力には type + slowly: true を使用し、fill() は使用しないでください。

Cookie 準備

まず https://www.tiktok.com に移動します。ログインページにリダイレクトされた場合はセッションが期限切れです — ユーザーにその旨を伝えてください。


ワークフロー: 動画をアップロード

1. https://www.tiktok.com/creator-center/upload に移動
   (フォールバック: https://www.tiktok.com/upload)
2. アップロードページが読み込まれるのを待つ
3. 「Select video」をクリックするか、動画ファイルをアップロードゾーンにドラッグ&ドロップする
   - 対応形式: MP4, MOV, WebM
   - 推奨: 9:16 縦向き、1080×1920、500MB未満
   - 長さ: 15秒~10分
4. アップロードと処理が完了するまで待つ(プログレスバーが100%になる)
5. キャプションエリアをクリックしてキャプションを入力する:
   - プレーンテキスト + ハッシュタグ(#タグ形式)
   - 最大2200文字
   - 発見性を高めるため、関連するハッシュタグを3~5個含める
6. カバー画像を設定:
   - 「Cover」をクリックし、動画からフレームを選択
   - またはカスタムカバー画像をアップロード
7. 「Post」ボタンをクリック
8. 確認を待つ — TikTokに「Your video has been posted」などの表示が出る
9. 投稿URLをコピーして報告する

ワークフロー: 投稿を予約(利用可能な場合)

上記手順6の後:
1. 「Schedule」をオンにして即時投稿ではなく予約にする
2. 日時を選択(タイムゾーンはアカウント設定から自動検出)
3. 「Schedule」をクリック

キャプションのベストプラクティス

  • 最初の行にフック(閲覧者の興味を引く文言)を配置する(フィードで「もっと見る」で切り詰められる前に表示される部分)
  • ハッシュタグは文中ではなく末尾に追加する
  • 広いタグ(#ai #technology)とニッチなタグ(#aitools #wiseflow)を混ぜる
  • ハッシュタグ前の本文は100文字以内に収める

エラーハンドリング

状況アクション
ログインページセッション期限切れ — ユーザーに再ログインを依頼
動画拒否(ポリシー違反)理由をユーザーに報告; 自動再試行しない
アップロードが途中で止まる最大3分待機; それでも止まっている場合はページをリロード
キャプションが長すぎるまずハッシュタグを削減し、次にキャプションを削る
カバー選択に失敗カバーカスタマイズをスキップし、自動生成カバーを使用

注意事項

  • TikTokのアップロードUIは頻繁に変更されます — ボタンや要素が見つからない場合は、意図に基づいて同等のUIを探してください。
  • 投稿完了後は必ず投稿URLを確認してください。
  • TikTokのコミュニティガイドラインに違反するコンテンツは投稿しないでください。

関連スキル