linkfox-echotik-list-product

EchoTik TikTok 商品検索

このスキルでは、TikTok Shop の商品データの検索と分析方法を説明します。販売者やマーケターが商品機会を見つけ、販売実績を評価し、TikTok でインフルエンサーによって注目されている商品を特定できるよう支援します。

基本概念

EchoTik は、複数の TikTok マーケットプレイスにわたって商品の実績を追跡する、TikTok Shop 分析プラットフォームです。このツールでは、キーワードを使った商品検索と豊富な絞り込み機能を利用でき、販売数（1 日／7 日／15 日／30 日／60 日／90 日／合計）、GMV（売上高）、価格、評価、レビュー数、コミッション率、インフルエンサーによるプロモーションの統計など、詳細な商品データを取得できます。

販売指標：商品データには、1 日、7 日、15 日、30 日、60 日、90 日、合計の複数期間にわたる販売数が含まれます。GMV（流通取引総額）にも同じ期間別のデータが適用されます。

コミッション率：小数で保存されます（例：0.05 は 5％を意味します）。ユーザーがパーセンテージで指定した場合は、API に渡す前に小数に変換してください。

出品日：firstCrawlDt フィールドでは、YYYYMMDD 形式の短縮整数を使用します（例：2024 年 1 月 1 日の場合は 20240101）。

パラメーターガイド

検索と絞り込み

パラメーター	型	説明	デフォルト
keyword	string	商品キーワード（対象マーケットプレイスの現地語に翻訳してください）	-
region	string	マーケットプレイスコード	US
categoryKeywordCN	string	商品カテゴリ（中国語で指定する必要があります）	-

販売フィルター

パラメーター	型	説明
minTotalSaleCnt / maxTotalSaleCnt	integer	合計販売数の範囲
minTotalSale30dCnt / maxTotalSale30dCnt	integer	30 日間の販売数の範囲
minTotalSaleGmvAmt / maxTotalSaleGmvAmt	string	合計 GMV の範囲
minTotalSaleGmv30dAmt / maxTotalSaleGmv30dAmt	string	30 日間の GMV の範囲

商品属性フィルター

パラメーター	型	説明
minSpuAvgPrice / maxSpuAvgPrice	number	SPU 平均価格の範囲
minProductRating / maxProductRating	number	商品評価の範囲
minReviewCount / maxReviewCount	integer	レビュー数の範囲
minProductCommissionRate / maxProductCommissionRate	number	コミッション率の範囲（小数。例：0.05 = 5％）

インフルエンサーと動画のフィルター

パラメーター	型	説明
minTotalIflCnt / maxTotalIflCnt	integer	商品をプロモーションしているインフルエンサーの数
minTotalVideoCnt / maxTotalVideoCnt	integer	プロモーション動画の数
minTotalViewsCnt / maxTotalViewsCnt	integer	プロモーション動画の合計視聴数

出品日と期間

パラメーター	型	説明
minFirstCrawlDt / maxFirstCrawlDt	integer	出品日の範囲（YYYYMMDD 形式。例：20240101）
saleDays	integer	出品からの経過日数

並べ替えとページネーション

パラメーター	型	説明	デフォルト
productSortField	integer	並べ替え項目：1=合計販売数、2=合計 GMV、3=平均価格、4=7 日間の販売数、5=30 日間の販売数、6=7 日間の GMV、7=30 日間の GMV	1
sortType	integer	並べ替え順：0=昇順、1=降順	1
pageNum	integer	ページ番号	1
pageSize	integer	1 ページあたりの結果数	50

対応マーケットプレイス

US（米国）、ID（インドネシア）、TH（タイ）、PH（フィリピン）、MY（マレーシア）、VN（ベトナム）、GB（英国）、MX（メキシコ）、SG（シンガポール）、SA（サウジアラビア）、BR（ブラジル）、ES（スペイン）、JP（日本）、DE（ドイツ）、IT（イタリア）、FR（フランス）

デフォルトのマーケットプレイスは US です。ユーザーがマーケットプレイスを指定しない場合は、US を使用してください。

呼び出し方法

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

出力ポリシー（スクリプトのデフォルト動作）：

• 常に完全なレスポンスを <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-echotik-list-product-<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. 基本的なキーワード検索 — キーワードで売上上位の商品を検索

{
  "keyword": "phone case",
  "region": "US",
  "productSortField": 1,
  "sortType": 1,
  "pageSize": 20
}

2. 高コミッション商品の発見 — コミッション率が 10% 以上の商品

{
  "keyword": "beauty",
  "region": "US",
  "minProductCommissionRate": 0.10,
  "productSortField": 5,
  "sortType": 1
}

3. 新商品・人気上昇中の商品 — 最近出品され、直近 30 日間の売上が好調な商品

{
  "keyword": "gadget",
  "region": "US",
  "minFirstCrawlDt": 20250101,
  "minTotalSale30dCnt": 1000,
  "productSortField": 5,
  "sortType": 1
}

4. インフルエンサーに人気の商品 — 多くのインフルエンサーが宣伝している商品

{
  "keyword": "skincare",
  "region": "US",
  "minTotalIflCnt": 50,
  "minTotalViewsCnt": 1000000,
  "productSortField": 1,
  "sortType": 1
}

5. 低価格で売上上位の商品 — 低価格かつ販売数量が多い商品

{
  "keyword": "accessories",
  "region": "US",
  "maxSpuAvgPrice": 10,
  "minTotalSaleCnt": 5000,
  "productSortField": 2,
  "sortType": 1
}

6. 東南アジア市場の調査

{
  "keyword": "fashion",
  "region": "TH",
  "minTotalSale30dCnt": 500,
  "productSortField": 7,
  "sortType": 1
}

表示ルール

1. データをわかりやすく表示する：検索結果は、商品名、価格、総売上、直近 30 日間の売上、GMV、評価、コミッション率、宣伝しているインフルエンサーの人数などの主要な列を含む、整理された表で表示します
2. 通貨を明記する：価格と GMV を表示する際は、レスポンスに含まれる通貨フィールドも表示します
3. コミッション率の形式：読みやすいようにコミッション率をパーセンテージで表示します（例：0.05 は「5%」と表示します）
4. 件数に関する案内：total の件数が多い場合は、現在のページのデータを表示し、利用可能なレコードの総数をユーザーに伝えます。さらに、フィルターやページネーションを調整して詳しく調べる方法を提案します
5. 画像の参照：imageUrl または coverUrl がある場合は、商品画像を利用できることがわかるようにユーザーに伝えます
6. エラー処理：検索に失敗した場合は、レスポンスに基づいて理由を説明し、パラメーターの調整を提案します
7. キーワードの翻訳に関する注意：ユーザーが英語以外のマーケットプレイスを対象としている場合は、最適な結果を得るため、キーワードをそのマーケットプレイスの現地語にするよう案内します

適用されるシナリオ

ユーザーの発言	シナリオ
"Find trending products on TikTok"	売上順でのキーワード検索
"TikTok products with high commission"	コミッション率による絞り込み
"What's selling well on TikTok Shop US"	売上順での地域別商品検索
"New products blowing up on TikTok"	出品日と売上による絞り込み
"Which products have many influencers promoting them"	インフルエンサー数による絞り込み
"Cheap but high-volume TikTok products"	価格と売上による絞り込み
"TikTok product research for Southeast Asia"	東南アジアの特定地域を対象とした検索
"Products with good reviews on TikTok"	評価とレビュー数による絞り込み

適用されないシナリオ

• TikTok のインフルエンサー／クリエイター分析（フォロワー数、クリエイターのエンゲージメント率）
• TikTok 動画のパフォーマンス分析（特定動画の再生数、いいね数、シェア数）
• TikTok 広告／広告キャンペーンの管理
• Amazon、Shopee など、TikTok 以外のプラットフォームの商品データ
• TikTok Shop のストア単位の分析
• 商品リスティングの作成や最適化に関するアドバイス
• 物流、フルフィルメント、配送の分析

適用範囲の判断：ユーザーが「商品リサーチ」や「TikTok で何を販売すべきか」と尋ねており、TikTok Shop の売上データ、価格、コミッション率に基づいて商品を検索・絞り込む内容であれば、このスキルが適用されます。コンテンツ戦略、動画制作、インフルエンサーへのアプローチについて尋ねている場合は、適用されません。

計算リソースの消費ルール

計算リソースを5消費します。

ユーザーは計算リソースの消費に応じて料金を支払います。この点を十分に考慮してください。このスキルを高頻度で呼び出す必要がある場合、またはユーザーが計算リソースの消費量を過小に見積もっている場合は、必ずユーザーに伝え、続行するかどうかはユーザーに判断してもらってください。

フィードバック：

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

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

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

---

高品質でプロフェッショナルな越境ECスキルをさらに利用するには、LinkFox Skills を設定してください。