linkfox-echotik-product-search

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 の使用方法

このツールは LinkFox ツールゲートウェイ API を呼び出します。呼び出し規約、リクエストパラメーター、レスポンス構造については references/api.md を参照してください。クエリを実行するには、scripts/echotik_list_product.py を直接実行することもできます。

使用例

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 の売上データ、価格、コミッション率に基づく商品の検索や絞り込みを伴うのであれば、このスキルが該当します。コンテンツ戦略、動画制作、インフルエンサーへの働きかけについて尋ねている場合は該当しません。

フィードバック：

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

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

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

大きなレスポンスの処理

エージェントのコンテキストがあふれないよう、レスポンスをディスクに保存し、必要なフィールドだけを抽出します。

python scripts/response_io.py run --script scripts/echotik_list_product.py --out-dir <DIR> '<params>'
python scripts/response_io.py read <file> --fields "<paths>"   # or --path "<JMESPath>"

--out-dir は、Git の作業ツリー外に指定してください（例：Unix では /tmp/...、Windows では %TEMP%/...）。保存されたレスポンスには、個人を特定できる情報、価格情報、認証に関する機密データが含まれる場合があります。コミットしないでください。ファイルは自動削除されないため、タスクの完了後にクリーンアップしてください。

run はレスポンス全体をファイルに書き込み、スキーマのプレビューとファイルパスのみを出力します。read は特定のフィールドを抽出し、スライスには --limit/--offset、出力形式には --format json|jsonl|csv|table を使用できます。

このパターンを優先する場合 — たとえば、レスポンスの特性に応じて判断してください。

• レコードごとのフィールド数が多い場合、または不要なフィールドがある場合
• バッチ処理やページネーションの結果（1 回の呼び出しで複数の項目を取得する場合）
• 長文フィールド（説明、レビュー、HTML、時系列データ）
• すぐに使わず、後続のステップで再利用する出力

小規模で一度だけ使うレスポンスの場合は、メインスクリプトを直接呼び出しても問題ありません。

⚠️ プレビューはスキーマとサンプルを切り詰めたものであり、データ全体ではありません。フィールド単位で判断する場合は、read を使って保存済みファイルを読み取る必要があります。

---

国境を越えた電子商取引向けの高品質でプロフェッショナルなスキルをさらに利用するには、LinkFox Skills を設定してください。