linkfox-echotik-get-video-download-url

EchoTik TikTok 動画のダウンロード

このスキルでは、TikTok 動画の URL を直接ダウンロードリンクおよび再生リンクに解決する方法を説明します。販売者がインフルエンサーやプロモーション動画の素材を保存し、オフラインで分析したり再利用したりするのに役立ちます。

主な概念

このツールは単一の TikTok 動画 URL を受け取り、直接アクセスできるメディアアドレスに解決します。アドレスには、ウォーターマークなしのダウンロード URL（クリーンな素材に適しています）、ウォーターマーク付きのダウンロード URL、再生 URL、カバー画像（静止画と動的画像）が含まれます。販売者が EchoTik の商品動画ツールで見つけた成果の高いプロモーション動画をアーカイブしたい場合や、クリエイターの動画を録画し直さずに再利用したい場合に便利です。

必須入力：url は必須です。次の 2 種類の URL 形式を使用できます。

• 短縮リンク：https://vt.tiktok.com/xxxxxx
• 完全なリンク：https://www.tiktok.com/@user/video/1234567890

ダウンロード URL の条件：すべての動画でダウンロード可能なアドレスが返されるとは限りません。noWatermarkDownloadUrl と downloadUrl は、ソース動画がダウンロードを許可している場合にのみ返されます。一部の動画（地域、プライバシー、利用可否の制限がある動画）では、両方とも返されず、playUrl とカバー画像のみが返されます。ダウンロードリンクを提示する前に、必ず値が存在することを確認してください。ダウンロード関連フィールドがない場合は、再生用に playUrl を使用してください。

URL の有効期間：返されるダウンロード／再生アドレスは、時間が経つと期限切れになる場合があります。解決後は速やかに使用し、リンクが機能しなくなった場合は再度解決してください。

パラメーターガイド

パラメーター	型	必須	説明	デフォルト
url	string	はい	TikTok 動画 URL（短縮リンク vt.tiktok.com/xxx または完全なリンク tiktok.com/@user/video/xxx）。最大長 1000	-

呼び出し方法

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

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

• 常に完全なレスポンスを <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-echotik-get-video-download-url-<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. TikTok 動画の完全なリンクを解決する

{
  "url": "https://www.tiktok.com/@user/video/1234567890"
}

2. TikTok の短縮リンクを解決する

{
  "url": "https://vt.tiktok.com/Z123abc/"
}

表示ルール

1. ウォーターマークなしのリンクを最初に表示する：noWatermarkDownloadUrl がある場合は、クリーンな素材を求める販売者が多いため、主要なダウンロード方法として最初に提示してください
2. ウォーターマーク付きのリンクも提示する：ユーザーが元のブランド表示を必要とする場合に備えて、downloadUrl（ウォーターマーク付き）も、存在する場合は表示してください
3. ダウンロード URL がない場合の対応：noWatermarkDownloadUrl と downloadUrl の両方がない場合（一部の動画でよくあります）は、ダウンロードリンクを捏造せず、動画に直接ダウンロードアドレスがないことを伝え、代わりに再生／プレビュー用の playUrl を提示してください
4. 再生とカバー画像を提示する：すぐにプレビューできる playUrl と、サムネイル用の coverUrl／dynamicCoverUrl に言及してください
5. 有効期間に関する注意：解決した URL は期限切れになる場合があるため、速やかにダウンロードするようユーザーに伝えてください
6. データのみを提示する：動画の使い方に関する主観的な助言は加えず、解決したアドレスを明確に表示してください
7. エラー処理：解決に失敗した場合は、errcode／errmsg に基づいて理由を説明してください。400 は url がない、または無効であることを意味します。10000 はリンクが有効な、またはアクセス可能な TikTok 動画ではないことを意味します。URL 形式を確認するよう案内してください

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

対象となるシナリオ

ユーザーの発言	シナリオ
「このTikTok動画をダウンロードして」／「このTikTok動画を保存して」	動画URLをダウンロードリンクに変換する
「このTikTok動画のウォーターマークなしバージョンを取得して」	noWatermarkDownloadUrlを優先する
「このインフルエンサーのプロモーション動画を保存したい」	クリエイターの動画URLを解決して保存する
「このTikTok動画の再生可能なリンクを教えて」	playUrlを返す
「このTikTok動画のカバー画像／サムネイルを取得して」	coverUrl／dynamicCoverUrlを返す

対象とならないシナリオ

• TikTokの商品に関連するプロモーション動画の一覧表示（代わりにlinkfox-echotik-product-videoを使用してください。動画URLではなくproductIdが必要です）
• TikTok商品の検索（linkfox-echotik-product-searchを使用）
• TikTokの新商品ランキング（linkfox-echotik-new-product-rankを使用）
• TikTokのライブ配信データ
• 動画編集やコンテンツ作成に関するアドバイス
• TikTok以外のプラットフォームの動画ダウンロード

判定基準

ユーザーが「TikTok動画」と言った場合、ダウンロードしたい特定の動画URLをすでに持っているのか（このスキル）、それとも商品に関連する動画を探したいのか（商品動画スキル）を判断してください。ユーザーがtiktok.comまたはvt.tiktok.comのリンクを提示し、保存／ダウンロード／抽出を依頼した場合は、このスキルが対象です。商品IDに言及し、「この商品を宣伝している動画は何か」と尋ねた場合は、代わりにlinkfox-echotik-product-videoを使用してください。

算力消耗规则

5 算力を消費します。

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

フィードバック：

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

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

references/api.mdに記載されている方法でFeedback APIを呼び出してください。ユーザーの作業を中断しないでください。

---

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