linkfox-echotik-product-video

EchoTik - TikTok 商品動画

このスキルでは、TikTok Shop の商品に関連付けられたプロモーション動画を検索できます。販売者が動画マーケティングのパフォーマンスを分析し、効果的なインフルエンサーコンテンツ戦略を特定するのに役立ちます。

コアコンセプト

このツールは、特定の TikTok 商品に関連付けられたプロモーション動画の一覧を取得します。各動画レコードには、エンゲージメント指標（視聴数、いいね数、コメント数、シェア数、お気に入り数）、推定販売貢献（動画経由の販売数と GMV）、動画のメタデータ（長さ、解像度、公開日）、クリエイター（インフルエンサー）ID が含まれます。これにより、販売者は、どの動画が商品販売に最も貢献しているか、どのようなコンテンツの傾向が最も効果的かを把握できます。

必須入力：productId は必須です。商品 ID は、EchoTik の商品検索ツール（linkfox-echotik-product-search）または新商品ランキングツール（linkfox-echotik-new-product-rank）から取得できます。

並べ替えフィールド：動画は、視聴数（1）、いいね数（2）、シェア数（3）、動画経由の販売数（4）、動画 GMV（5）、公開日（6）で並べ替えられます。

ページネーション：pageSize は 10 の倍数にする必要があり、最大値は 100 です。バックエンドは 10 件ずつ取得し、結果を統合します。

パラメーターガイド

パラメーター	型	必須	説明	デフォルト
productId	string	はい	TikTok 商品 ID	-
userId	string	いいえ	インフルエンサー ID で絞り込み	-
productVideoSortField	integer	いいえ	並べ替えフィールド：1=視聴数、2=いいね数、3=シェア数、4=動画経由の販売数、5=動画 GMV、6=公開日	1
sortType	integer	いいえ	並べ替え順：0=昇順、1=降順	1
minCreateTime	integer	いいえ	動画公開開始時刻（Unix タイムスタンプ、秒単位）	-
maxCreateTime	integer	いいえ	動画公開終了時刻（Unix タイムスタンプ、秒単位）	-
pageNum	integer	いいえ	ページ番号	1
pageSize	integer	いいえ	1 ページあたりの結果数（10 の倍数、最大 100）	50

呼び出し方法

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

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

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

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

認証と計算リソースの問題の解決

以下の異常が発生した場合は、references/onboarding.md の手順に沿って解決してください。

異常

• API Key が未設定：環境変数 LINKFOX_AGENT_API_KEY も LINKFOXAGENT_API_KEY も設定されていません。
• レスポンスのステータスコードが 401 または 402
• レスポンスに計算リソースまたは残高不足のメッセージが含まれる：メッセージに「算力余额不足／计费不足／余额不足／quota exceeded／insufficient balance／套餐到期／需充值／请充值」、または同様の意味の内容が含まれる場合。

使用例

1. 商品の動画を視聴数順に表示

{
  "productId": "1729382310407603945",
  "productVideoSortField": 1,
  "sortType": 1,
  "pageSize": 20
}

2. 最もコンバージョン率の高い動画を検索（動画経由の販売数順）

{
  "productId": "1729382310407603945",
  "productVideoSortField": 4,
  "sortType": 1,
  "pageSize": 20
}

3. 商品について、特定のインフルエンサーの動画を検索

{
  "productId": "1729382310407603945",
  "userId": "7234567890123456789",
  "productVideoSortField": 1,
  "sortType": 1
}

4. 指定した期間内の最近の動画を検索（GMV 順）

{
  "productId": "1729382310407603945",
  "minCreateTime": 1717200000,
  "maxCreateTime": 1719792000,
  "productVideoSortField": 5,
  "sortType": 1
}

5. 動画を公開日順に並べ替え（新しい順）

{
  "productId": "1729382310407603945",
  "productVideoSortField": 6,
  "sortType": 1,
  "pageSize": 50
}

表示ルール

1. データを表で表示する：動画の説明（長い場合は省略）、再生数、いいね数、コメント数、シェア数、動画の販売数、動画のGMV、公開日、インフルエンサーIDを表示します
2. 元の動画にリンクする：officialUrl がある場合は、ユーザーがTikTokで動画を視聴できるように表示します
3. 推定値に関する注意書き：動画の販売数とGMVは推定値であり、概算であることをユーザーに伝えます
4. カバー画像：coverUrl がある場合は、動画のサムネイルが利用できることをユーザーに伝えます
5. 再生時間の形式：duration（秒）を読みやすい形式（例：90秒の場合は「1:30」）に変換します
6. ハッシュタグの表示：hashTag がある場合は、コンテンツのテーマがわかるように表示します
7. 再生URLに関する注意：playAddr フィールドはすぐに期限切れになる可能性があるため、共有には officialUrl を優先してください

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

該当するシナリオ

ユーザーの発言	シナリオ
「このTikTok商品を宣伝している動画を見せて」	商品IDで動画を検索
「この商品の売上に最も貢献している動画はどれ？」	動画の販売数（フィールド4）で並べ替え
「この商品を宣伝しているインフルエンサーの動画はどれ？」	動画一覧を一般検索
「この商品の特定のクリエイターによる動画を見せて」	userId で絞り込み
「この商品の最近の宣伝動画」	期間で絞り込むか、日付で並べ替え
「この商品のGMVが最も高いTikTok動画はどれ？」	動画のGMV（フィールド5）で並べ替え
「この商品の動画マーケティングの実績を分析して」	動画一覧を包括的に検索

該当しないシナリオ

• 商品の検索（代わりに linkfox-echotik-product-search を使用）
• TikTokの新商品ランキング（代わりに linkfox-echotik-new-product-rank を使用）
• インフルエンサーのプロフィール分析（フォロワー数、自己紹介、全体的な実績）
• TikTokのライブ配信データ
• 動画コンテンツの作成や編集に関するアドバイス
• TikTok広告／広告キャンペーンの管理
• TikTok以外のプラットフォームの動画データ

適用範囲の判断

ユーザーが「TikTok動画」について尋ねた場合、特定の商品に関連する動画を求めているのか（このスキル）、一般的なTikTok動画の分析を求めているのか（このスキルの対象外）を判断してください。商品IDに言及している場合や、「商品Xを宣伝している動画はどれ？」と尋ねている場合は、このスキルが該当します。商品に関する文脈なしで、一般的な人気動画について尋ねている場合は、このスキルは該当しません。

算力消耗ルール

算力を5消費します。

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

フィードバック：

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

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

references/api.md に記載された方法でフィードバック API を呼び出してください。ユーザーの作業を中断しないでください。

---

高品質でプロフェッショナルな越境ECスキルについては、LinkFox Skills をご覧ください。