mcpField
T
tiktok

tiktok

github.com/hyperfx-aiマーケティング・グロース107210 回インストール2 日前に更新
リポジトリ

tiktok について

オーガニックコンテンツをTikTokへ投稿するためのHyper MCPスキルです。コンテンツ共有ガイドラインに準拠したフォームを先に使う手順を定め、手動投稿用の下書き送信にも対応します。

主な機能

  1. 01コンプライアンス対応フォーム
  2. 02動画と写真の投稿
  3. 03最大35枚の写真カルーセル
  4. 04アカウント情報と投稿機能の確認
  5. 05公開済み動画と投稿状況の照会
  6. 06TikTok受信箱への下書き送信

活用シーン

  1. 01プライバシーと交流設定を選んで動画を投稿
  2. 02TikTok用の写真カルーセルを準備
  3. 03手動投稿用にメディアを下書きへ送信

MCP 対応

Hyper MCPツールを使い、TikTok連携の接続が必要です。投稿時は最初にフォームを開き、送信後に公開ツールを呼び出します。

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/hyperfx-ai/marketing-skills --skill tiktok

インストール後、Claude Code で/tiktokを入力して読み込まれたか確認します。

詳細

TikTok

TikTok コンテンツ共有ガイドラインに準拠したインタラクティブな投稿フォームを通じて、TikTok にオーガニックコンテンツを公開するためのエンドツーエンドのスキルです。

対象外 — 他のスキルに引き継いでください

リクエスト引き継ぎ先
TikTok 広告キャンペーン、Spark Ads、有料プロモーションtiktok-ads
Instagram の投稿／リール／ストーリーズinstagram
LinkedIn のドキュメント投稿またはカルーセル投稿linkedin

要件

  • Hyper MCP がインストールされ、接続されていること。 https://app.hyperfx.ai/mcp
  • https://app.hyperfx.ai/apps で TikTok インテグレーションが接続されていること — このスキルでは TikTok Login Kit／Content Posting API を使用します（TikTok Marketing API ではありません）。

search("tiktok_post_form_open") で tiktok_post_form_open が見つからない場合は、そこで停止し、Hyper MCP を有効にして TikTok を接続するようユーザーに伝えてください。

このスキルのツールの実行方法

このスキルの各ツールには、正式なツール名が付けられています。利用するサーフェスに応じて、次の呼び出しを実行してください。

サーフェスツールを探す実行する
MCP クライアント（Claude、Cursor、Codex、ChatGPT）search("<what you want to do>")、続けて describe("<name>")call("<name>", {...})
Hyper CLIhyperai search "<what you want to do>"、続けて hyperai describe <name>hyperai call <name> --json '{...}'

ツールが見つからない場合、そのインテグレーションは接続されていないか、ワークスペースで有効になっていません。そこで停止し、接続すべきインテグレーションをユーザーに伝えてください。

ツールの一覧

ツール用途
tiktok_post_form_openユーザーが投稿を希望した場合の唯一の開始点です。 コンプライアンスフォームを開きます。
tiktok_videos_send_from_url、tiktok_post_video_from_file、tiktok_photos_send最終投稿ツール — ユーザーがフォームを送信した後にのみ呼び出してください。
tiktok_current_user_get認証済みユーザーのプロフィール（フォームは不要です）。
tiktok_creator_info_get投稿機能と制限を確認します。
tiktok_videos_list、tiktok_videos_queryユーザーが公開した動画を閲覧します。
tiktok_posts_status_get以前に送信した投稿のステータスを確認します。
tiktok_videos_upload_from_url、tiktok_videos_upload_from_file、tiktok_photos_upload下書きとして受信トレイに送信します（ユーザーは TikTok アプリで手動投稿します — 意図的にフォームを省略します）。

重要なルール

重要：ユーザーが TikTok への投稿を希望した場合は、必ず tiktok_post_form_open を使用してください。ユーザーのリクエストに応じて、tiktok_videos_send_from_url、tiktok_photos_send、tiktok_post_video_from_file を直接呼び出してはいけません。TikTok のコンプライアンス上、投稿フォームの使用が必須です。

重要：フォームを開く前に、プライバシー、ポリシー、キャプション、ブランドコンテンツの設定についてユーザーに尋ねてはいけません。これらはすべてフォーム上で対話的に設定します。

重要：ユーザーが投稿を希望したら、すぐに tiktok_post_form_open を呼び出してください。先に情報を集めてはいけません。

ユーザーが投稿を希望した場合

ユーザーが次のいずれかを言った場合：

  • 「この動画／写真を TikTok に投稿して」
  • 「これを TikTok でシェアして」
  • 「TikTok にアップロードして」
  • 「これを自分の TikTok に載せて」

すぐに tiktok_post_form_open を呼び出してください：

tiktok_post_form_open(
    media_type="video",            # or "photo"
    media_url="<url>",             # single video / single photo URL
    media_urls=["<url>", ...]      # for photo carousels (max 35)
)

次のことをしてはいけません：

  • フォームを開く前にプライバシー設定について尋ねる。
  • フォームを開く前にキャプション／タイトルについて尋ねる。
  • フォームを開く前にポリシーへの同意について尋ねる。
  • メタデータを要求する — フォームを開くだけにしてください。
  • tiktok_videos_send_from_url または tiktok_photos_send を直接呼び出す。

フォームで設定できる内容

インタラクティブな投稿フォームはTikTokのコンテンツ共有ガイドラインに準拠しており、次の項目を設定できます。

  • クリエイターの情報表示（ユーザー名、アバター）。
  • メディアのプレビュー（動画プレーヤーまたは写真グリッド）。
  • 文字数制限付きのキャプション／タイトル入力（#hashtags と @mentions）。
  • プライバシーレベルの選択（アカウントで利用可能なオプションに絞り込み）。
  • インタラクション設定（コメント、デュエット、スティッチ）。
  • AI生成コンテンツのラベル付け。
  • 商用コンテンツの開示（ブランドコンテンツ／プロモーション）。
  • 音楽使用確認への同意。
  • ブランドコンテンツポリシーへの同意。
  • 投稿制限／禁止の検出。
  • 動画の長さの検証。

事前入力パラメーター

tiktok_post_form_open を呼び出す際は、把握している情報を指定してください。

パラメーター指定する場合
media_type常に指定します（"video" または "photo"）。
media_url動画1本または写真1枚の場合。
media_urls写真カルーセルの場合（URLのリスト、最大35枚）。
video_duration_sec判明している場合。動画の長さを検証できます。
titleユーザーがキャプションに言及した場合。
is_aigcメディアを生成した場合（Veo、Seedance、画像生成など）。

フォーム送信後

ユーザーがフォームに入力して送信すると、選択した設定をすべて含むメッセージが届きます。その時点で、送信内容に含まれる正確なパラメーターを使用して、適切な投稿ツールを呼び出してください。

  • URLから動画を投稿：tiktok_videos_send_from_url
  • ファイルから動画を投稿：tiktok_post_video_from_file
  • 写真を投稿：tiktok_photos_send

投稿ツールはステータスを自動的にポーリングし、完了メッセージを返します。

メディア形式の要件

動画：

  • 形式：MP4 + H.264を推奨。
  • 解像度：最低720p、最大4K。
  • アスペクト比：9:16、16:9、または1:1。
  • 長さ：最低3秒。最大値はアカウントによって異なります（フォームで確認されます）。

写真：

  • 形式：WebPまたはJPEGのみ（PNGには対応していません）。
  • 解像度：最大1080p。
  • サイズ：写真1枚につき最大20MB。
  • カルーセル：最大35枚。

ドメインの検証：

  • すべてのメディアURLは、TikTok Developer Portalで検証済みのドメインから取得する必要があります。
  • 未検証のドメインでは認証エラーが発生します。

フローの例

  1. ユーザー：「この動画をTikTokに投稿して」。
  2. あなた：tiktok_post_form_open(media_type="video", media_url="<url>") を呼び出します。
  3. 投稿フォームがアーティファクトパネルに表示されます。
  4. ユーザーがプライバシー、キャプション、ポリシーなどを設定します。
  5. ユーザーが「Post to TikTok」をクリックします。
  6. 設定内容を含むメッセージが届きます。
  7. あなた：送信されたパラメーターを指定して tiktok_videos_send_from_url(...) を呼び出します。
  8. ツールがステータスを自動的にポーリングし、結果（完了、失敗、またはタイムアウト）を返します。

受信トレイ／下書き経由（フォーム不要）

これらのツールは意図的にフォームを介さず、ユーザーが手動で投稿できるよう、コンテンツをユーザーのTikTokアプリに送信します。

  • tiktok_videos_upload_from_url — 動画を下書きとして受信トレイに送信します。
  • tiktok_videos_upload_from_file — ファイルを下書きとして受信トレイにアップロードします。
  • tiktok_photos_upload — 写真を下書きとして受信トレイに送信します。

これらを使用するのは、ユーザーが「TikTokの下書きに送って」または「アプリで手動投稿したい」と明示的に依頼した場合のみです。それ以外の場合は、フォーム経由のフローをデフォルトで使用してください。

コメント

Markdown 対応