linkfox-echotik-batch-video-detail

Name: linkfox-echotik-batch-video-detail
Author: linkfox-ai

github.com/linkfox-aiマーケティング・グロース113175 回インストール2 週間前に更新

リポジトリ

linkfox-echotik-batch-video-detail について

IDまたはURLを指定してTikTok動画の詳細をまとめて取得するLinkFoxスキルです。販売者やマーケターが、エンゲージメント、推定販売数とGMV、クリエイター情報、累計・直近の再生数やいいね数を比較できます。

主な機能

01IDまたはURLによる動画検索
02最大1,000件の動画詳細取得
03期間別の再生数・いいね数比較
04エンゲージメント・推定販売指標の確認
05クリエイター情報と動画分類項目の確認

活用シーン

01指定した動画リストの実績比較
02直近の再生数・いいね数の推移確認
03動画の推定販売数・GMVの確認
04販売・広告・AI動画フラグの確認

インストール

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

$npx skills add https://github.com/linkfox-ai/linkfox-skills --skill linkfox-echotik-batch-video-detail

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

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

references/

api.md

onboarding.md

scripts/

echotik_batch_video_detail.py

onboarding.py

詳細

EchoTik TikTok 動画詳細の一括取得

このスキルでは、ID または URL がわかっている TikTok 動画の詳細なパフォーマンス指標を一括取得できます。再生数、いいね数、コメント数、シェア数、動画売上／GMV、クリエイターデータを使って、販売者やマーケターが動画を並べて比較できます。

基本概念

このツールは、1 回の呼び出しで TikTok 動画の詳細指標を一括取得します。動画は ID および／または TikTok 動画 URL で指定します。バックエンドは各 URL から videoId を抽出し、指定された ID と統合して、動画ごとの分析データを返します。

入力オプション（少なくとも 1 つ必要です。両方を組み合わせることもできます）：

videoIds — TikTok 動画 ID の配列（最大 1000 件）
videoUrls — TikTok 動画 URL の配列（例：https://www.tiktok.com/@<unique_id>/video/<videoId> または https://www.tiktok.com/video/<videoId>）。各 URL の末尾から videoId が抽出され、videoIds と統合されます（最大 1000 件）

複数期間の指標：再生数といいね数は、それぞれ累計値と 1d / 7d / 30d の増加数で報告されるため、長期的なパフォーマンスと直近の勢いの両方を確認できます。

エンゲージメントとアトリビューション：コメント数、シェア数、お気に入り数、推定動画売上（個数）、推定動画売上 GMV（金額）が動画ごとに返されます。

フラグフィールド（salesFlagText / isAdText / createdByAiText）：販売動画／広告動画／AI 生成動画かどうかを示す、人が読みやすい「はい／いいえ」（AI の場合は「はい／いいえ／不明」）のラベルです。

検索との違い：この機能は、ID／URL がわかっている動画の詳細を照会します。地域やフィルターで動画を見つける場合（ID は不要）は、linkfox-echotik-list-video を使用してください。

データフィールド

フィールド	型	説明
videoId	string	動画 ID
videoDesc	string	動画の説明／キャプション
officialUrl	string	TikTok 公式動画 URL
coverUrl	string	動画のカバー画像 URL
duration	integer	動画の長さ（秒）
width	string	動画の幅（px）
height	string	動画の高さ（px）
ratio	string	動画の解像度（例：540p/720p）
dataSize	string	動画ファイルサイズ
createDate	string	動画の公開日時（yyyy-MM-dd HH:mm:ss）
userId	string	クリエイター ID
uniqueId	string	TikTok アカウント ID（unique_id）
avatar	string	クリエイターのプロフィール画像 URL
totalViewsCnt	integer	総再生数
totalViews1dCnt	integer	直近 1 日間の再生数増加
totalViews7dCnt	integer	直近 7 日間の再生数増加
totalViews30dCnt	integer	直近 30 日間の再生数増加
totalDiggCnt	integer	総いいね数
totalDigg1dCnt	integer	直近 1 日間のいいね数増加
totalDigg7dCnt	integer	直近 7 日間のいいね数増加
totalDigg30dCnt	integer	直近 30 日間のいいね数増加
totalCommentsCnt	integer	総コメント数
totalSharesCnt	integer	総シェア数
totalFavoritesCnt	integer	総お気に入り数
totalVideoSaleCnt	integer	動画売上（個数、推定）
totalVideoSaleGmvAmt	integer	動画売上 GMV（推定金額）
salesFlagText	string	販売動画かどうか（はい／いいえ）
isAdText	string	広告配信動画かどうか（はい／いいえ）
createdByAiText	string	AI 動画かどうか（はい／いいえ／不明）
productCategoryList	string	関連商品のカテゴリ（JSON 文字列。空の場合は`[]`）
videoProducts	string	動画で販売されている商品（JSON 文字列。空の場合は`[]`）
region	string	動画の地域コード
sourceType	string	データソース（例：Tiktok）
sourceTool	string	ソースツール（例：EchoTik-動画一覧）

パラメーターガイド

パラメーター	型	必須	デフォルト	説明
videoIds	array<string>	いいえ*	-	TikTok 動画 ID のリスト。最大 1000 件
videoUrls	array<string>	いいえ*	-	TikTok 動画 URL のリスト（形式：`https://www.tiktok.com/@<unique_id>/video/<videoId>` または `https://www.tiktok.com/video/<videoId>`）。各 URL の末尾からvideoIdを抽出してvideoIdsに統合します。videoIdsとの併用も可能です。最大1000件

* videoIds / videoUrls の少なくとも一方を指定してください。両方を同時に渡すこともでき、サーバー側で統合・重複排除してから照会します。

呼び出し方法

API エンドポイント：POST /echotik/batchVideoDetail（完全なパラメーター／レスポンス／エラーコードについては references/api.md を参照）
Python スクリプト：python scripts/echotik_batch_video_detail.py '<JSON 参数>' [--inline]
コスト上の制約：このツールは計算リソースを消費します。同一セッションで同じパラメーターの組み合わせを指定した場合、デフォルトでは1回のみ呼び出されます。スクリプトには24時間のローカルキャッシュがあります。失敗または空の結果が返された場合、キーワードを自動で変更したり、ページをめくったり、郵便番号を変えて連続して試したりしてはいけません。検索を続ける必要がある場合は、追加のコストが発生することを先にユーザーに説明してください。

出力方法（スクリプトのデフォルト動作）：

必ず完全なレスポンスを <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-echotik-batch-video-detail-<timestamp>.json に書き込みます（<cwd> はスクリプト実行時の作業ディレクトリです。Claude Code では現在のプロジェクトディレクトリにあたります。<session> は環境変数 SESSION_ID から取得し、ユーザーのタスクごとに自動的に集約されます。/tmp への書き込みは禁止です。現在のディレクトリに書き込めない場合はエラーになります）
レスポンス本文が8 KB以下の場合：ファイルに書き込んだ後、完全な JSON を stdout に出力します
レスポンス本文が8 KBを超える場合：ファイルに書き込んだ後、stdout には概要のみを出力します（トップレベルのフィールド、total／costToken などの一般的なカウント、最も長いリストフィールドの長さと先頭3件のサンプル）
--inline を追加すると、stdout に全内容を強制的に出力します（同様にファイルにも書き込みます）

データの読み取りに関する推奨事項：まず概要を確認して、必要な情報が含まれているか判断してください。具体的なフィールドが必要な場合は、保存した json ファイルから jq または ConvertFrom-Json を使って必要なデータを抽出し、JSON 全体がコンテキストに入らないようにしてください。

認証と計算リソースに関する問題の解決

以下の異常が発生した場合は、references/onboarding.md を参照して問題を解決してください。

異常な状況

API Key が未設定：環境変数 LINKFOX_AGENT_API_KEY も LINKFOXAGENT_API_KEY も設定されていません。
レスポンスのステータスコードが401または402
計算リソースまたは残高不足の通知：メッセージに「計算リソースの残高不足／課金不足／残高不足／quota exceeded／insufficient balance／プランの有効期限切れ／チャージが必要／チャージしてください」または同様の意味の内容が含まれている場合。

使用例

1. 動画IDによる一括検索

{
  "videoIds": ["7030893014180531462", "6768504823336815877", "7425631540178160939"]
}

2. 動画URLによる一括検索

{
  "videoUrls": [
    "https://www.tiktok.com/@sageandintuition/video/7030893014180531462",
    "https://www.tiktok.com/@<unique_id>/video/6768504823336815877"
  ]
}

3. IDとURLの混在（サーバー側で統合）

{
  "videoIds": ["7030893014180531462"],
  "videoUrls": ["https://www.tiktok.com/@<unique_id>/video/6768504823336815877"]
}

表示ルール

比較表を表示：動画ごとに1行を表示し、動画の説明（長い場合は省略）、再生数、いいね数、コメント数、シェア数、動画の売上、動画の GMV、公開日、クリエイターを含めます
元の動画へのリンク：officialUrl が利用可能な場合は、TikTok で動画を表示できるようにリンクを提示します
カバー画像：coverUrl がある場合は、動画のサムネイルを表示できることを伝えます
再生時間の形式：duration（秒）を読みやすい形式に変換します（例：165秒の場合は「2:45」）
期間別指標：関連する場合は、生涯合計とともに1日／7日／30日ごとの再生数といいね数の内訳を表示します
推定値に関する注意：動画の売上と GMV は推定値です。概算であることをユーザーに伝えてください
フラグバッジ：salesFlagText（商品紹介）、isAdText（広告配信）、createdByAiText（AI）を表示し、ユーザーが動画の種類を一目で確認できるようにします
動画が見つからない場合：リクエストした動画の記録が返されない場合は、データが見つからなかった ID／URL を列挙し、ユーザーが確認できるようにします
結果件数：返されたレコードの total を必ずユーザーに伝えます

重要な制限事項

一括リクエスト上限：1リクエストあたり最大1000件の動画
検索のみ：このツールは地域やフィルターによる動画の検索・発見には対応していません。すでに把握している特定の ID／URL を解決するためのツールです。動画を見つけるには linkfox-echotik-list-video を使用してください
URL の抽出：videoUrls から抽出されるのは末尾の videoId のみです。各 URL が動画 ID で終わっていることを確認してください
推定データ：売上、GMV、アトリビューションの数値は分析による推定値であり、プラットフォームの正確な数値ではありません
JSON 文字列フィールド：productCategoryList／videoProducts は JSON 文字列として返されます（データがない場合は空で、例：[]）。必要に応じて表示前に解析してください
二次処理なし：結果はリアルタイムのクエリであり、データベースには保存されません。二次的な SQL／データ処理は利用できません

ユーザーの表現とシナリオのクイックリファレンス

適用されるシナリオ

ユーザーの発言	シナリオ
「これらのTikTok動画の詳細を調べて」	動画IDによる一括詳細検索
「これらのTikTok動画リンクの再生数／売上を取得して」	動画URLによる一括詳細検索
「これらのTikTok動画のパフォーマンスを一括分析して」	一括検索、指標を表示
「これらのTikTok動画で再生数／売上が最も高いのはどれ？」	一括検索、列を比較
「これらのTikTok動画は商品紹介／広告配信／AIのどれ？」	一括検索、フラグフィールドを確認

適用されないシナリオ

地域／フィルターによる動画の検索（linkfox-echotik-list-video を使用）
TikTok 商品の詳細検索（linkfox-echotik-batch-product-detail を使用）
TikTok 動画のダウンロードリンクの取得（linkfox-echotik-get-video-download-url を使用）
TikTok クリエイター／販売者（店舗）の分析（linkfox-echotik-seller-detail／linkfox-echotik-list-seller を使用）
TikTok 以外のプラットフォームの動画データ

境界の判断

ユーザーが「これらのTikTok動画を分析して」と言った場合、具体的な動画 ID または TikTok 動画 URL をすでに持っているか（このスキル）、それとも地域やフィルターを指定して動画を検索したいのか（動画一覧スキル）を確認してください。ID や URL のリストを貼り付けて、再生数、いいね数、売上、GMV の詳細を知りたい場合は、このスキルが適しています。「人気のTikTok動画を探して」や「地域別に動画を検索して」と頼まれた場合は該当しません。まず linkfox-echotik-list-video を使って動画を見つけてください。

算力の消費ルール

算力を 5 消費します。

ユーザーは算力の消費に応じて料金を支払います。十分に検討してください。このスキルを高頻度で呼び出す必要がある場合や、ユーザーが算力の消費量を十分に把握していない場合は、必ずユーザーに知らせ、続行するかどうかをユーザーに判断してもらってください。

フィードバック：

次のいずれかに該当する場合は、Feedback API を通じてフィードバックを自動検出し、報告してください。

このスキルで説明されている機能や目的が、実際の動作と一致しない
スキルの結果がユーザーの意図と一致しない
ユーザーがこのスキルへの不満や称賛を表明した
改善できると思われる点がある

references/api.md の指定に従って Feedback API を呼び出してください。ユーザーの作業を中断しないでください。

高品質でプロフェッショナルな越境ECスキルをお探しの場合は、LinkFox Skills をご覧ください。

Markdown 対応

ログインしてコメント

基本情報

作者: linkfox-ai
リポジトリ: linkfox-ai/linkfox-skills
カテゴリ: マーケティング・グロース
インストール数: 175
GitHub スター: 113

問題を報告