linkfox-echotik-list-seller

EchoTik TikTok Seller Search

このスキルは TikTok Shop のセラー（ストア）データを検索・分析し、越境セラーやマーケターが、好調なストアを見つけ、競合と比較し、TikTok の各マーケットプレイスでストア単位のパフォーマンスを評価できるようにします。

基本概念

EchoTik は TikTok Shop の分析プラットフォームです。このツールは、詳細なフィルターを使って TikTok Shop のストア（セラー）を一覧表示し、総販売数、GMV（1日／7日／30日／90日）、フォロワー数、評価、レビュー数、肯定的なフィードバック率、配送率、応答率、プロモーションを行っているインフルエンサー数、動画数、ライブ配信数、商品数などのストア指標を返します。

掲載日：firstCrawlDt／minFirstCrawlDt／maxFirstCrawlDt は、YYYYMMDD のコンパクトな整数形式を使用します（例：2024年1月1日は 20240101）。

ページネーションに関する注意点：pageSize は10の倍数である必要があります（最大100）。公式の上流 API では1ページあたり最大10件ですが、このツールは内部で10件ずつ複数のページを取得して統合するため、pageSize=50 では最大50件のセラーが統合されて返されます。

データフィールド

フィールド	説明
sellerId	ストア ID
sellerName	ストア名
sellerLink	ストアのリンク
coverUrl	ストアのカバー画像 URL
region	マーケットプレイスコード
totalSaleCnt	総販売数
totalSale1dCnt / 7dCnt / 30dCnt / 90dCnt	販売数（1日／7日／30日／90日、増分）
totalSaleGmvAmt	総 GMV（売上高）
totalSaleGmv1dAmt / 7dAmt / 30dAmt / 90dAmt	GMV（1日／7日／30日／90日、増分）
followersCount	フォロワー数
rating	ストア評価
reviewCount	レビュー数
positiveFeedbackRate	肯定的なフィードバック率
responseRate	応答率
deliveryRate	配送率
totalProductCnt	過去の商品数（販売終了商品を含む）
totalCrawlProductCnt	現在ストアで販売中の商品数
spuAvgPrice	ストア内 SKU の平均価格
minPrice / maxPrice	最低価格／最高価格
totalIflCnt	プロモーションを行っているインフルエンサー数
totalVideoCnt	プロモーション動画数
totalLiveCnt	ライブ配信数
salesFlagText	主な販売チャネル（動画／ライブ配信）
salesTrendFlagText	販売傾向（横ばい／上昇／下降）
shopIdentityLabel	ストアの識別ラベル
shopTypeText	ブランドストアのフラグ
fromFlagText	現地／越境のフラグ
productCategoryList	商品カテゴリー
mostProductCategoryList	最上位の商品カテゴリー
firstCrawlDt	推定掲載日
userId	インフルエンサーの UID

パラメーターガイド

必須パラメーターと地域

パラメーター	型	必須	デフォルト	説明
region	string	はい	-	マーケットプレイスコード。以下の対応リストを参照してください

カテゴリーフィルター

パラメーター	型	説明
categoryId	string	レベル1のストアカテゴリー ID
categoryL2Id	string	レベル2のストアカテゴリー ID
categoryL3Id	string	レベル3のストアカテゴリー ID

GMV と販売傾向

パラメーター	型	説明
minTotalSaleGmv30dAmt / maxTotalSaleGmv30dAmt	number	30日間の GMV 範囲
salesTrendFlag	integer	7日間の販売傾向：0＝横ばい、1＝上昇、2＝下降

セラー種別と販売チャネル

パラメーター	型	説明
fromFlag	integer	ストアの所在：1＝現地ストア、2＝越境ストア
salesFlag	integer	主な販売チャネル：1＝動画、2＝ライブ配信

掲載日

パラメーター	型	説明
minFirstCrawlDt / maxFirstCrawlDt	integer	推定掲載日の範囲（YYYYMMDD、例：20240101）

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

パラメーター	型	デフォルト	説明
sellerSortField	integer	2	並べ替えフィールド：1＝総販売数、2＝総 GMV、3＝平均 SKU 価格
sortType	integer	1	並べ替え順：0＝昇順、1＝降順
pageNum	integer	1	ページ番号（1から開始）
pageSize	integer	50	ページサイズ — 10の倍数である必要があります（最大100）

対応マーケットプレイス

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

ユーザーがマーケットプレイスを指定しない場合は、確認するか、US をデフォルトとして使用します。

呼び出し方法

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

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

• 常に完全なレスポンスを <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-echotik-list-seller-<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. 総GMV上位の米国ストア

{
  "region": "US",
  "sellerSortField": 2,
  "sortType": 1,
  "pageSize": 20,
  "pageNum": 1
}

2. 東南アジアで成長中の越境ストア

{
  "region": "ID",
  "fromFlag": 2,
  "salesTrendFlag": 1,
  "sellerSortField": 2,
  "sortType": 1
}

3. ライブ配信主導のGMVが高いストア

{
  "region": "US",
  "salesFlag": 2,
  "minTotalSaleGmv30dAmt": 100000,
  "sellerSortField": 2,
  "sortType": 1
}

4. 最近出品されたストア

{
  "region": "GB",
  "minFirstCrawlDt": 20250101,
  "sellerSortField": 1,
  "sortType": 1
}

表示ルール

1. データをわかりやすく提示する：ストア名、地域、総売上、30日間のGMV、フォロワー数、評価、レビュー件数、プロモーションを行っているインフルエンサー数など、主要な列を含む表で結果を表示します
2. GMVと売上の粒度：該当する場合は、30日間のGMVと総売上を表示します。複数期間（1d／7d／30d／90d）の内訳は、保存された JSON で確認できることも伝えてください
3. ストアリンク：sellerLink がある場合は、ユーザーがストアを開けるようにリンクを表示します
4. ストア属性：競合のベンチマークに役立つよう、fromFlagText（ローカル／越境）、salesFlagText（動画／ライブ配信）、salesTrendFlagText（トレンド）を表示します
5. 結果件数：total のレコード数と現在のページを必ずユーザーに伝えてください。結果セットが大きい場合は、ページ送りまたはフィルターの絞り込みを提案します
6. 二次処理なし：結果はリアルタイムのクエリで取得され、データベースには保存されません。二次的な SQL／データ処理には対応していません

重要な制限事項

1. 地域は必須：region は必須です。API ではデフォルト値は適用されません。
2. pageSize の規則：10の倍数である必要があり、最大値は100です。それ以外の値は拒否または調整される場合があります。
3. カテゴリ ID：categoryId／categoryL2Id／categoryL3Id は内部 ID であり、人が読める名前ではありません。以前の結果またはカテゴリの分類体系から取得してください。
4. 出品日の形式：minFirstCrawlDt／maxFirstCrawlDt は YYYYMMDD 形式の整数です（例：20240101）。
5. データのリアルタイム性：結果はリアルタイムのクエリで取得され、データベースには保存されません。二次的な SQL／データ処理には対応していません。
6. 単一ストアの詳細情報：1つのストアの完全なプロフィールを確認するには、ここで返される sellerId を使用して、ストア詳細スキルを利用してください。

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

該当するケース — TikTok Shop の店舗・販売者の検索とベンチマーク：

ユーザーの発言	シナリオ
「TikTok 店舗ランキング」／「TikTok top stores」	GMV／売上順に店舗を一覧表示
「TikTok の販売店を探して」	販売チャネル（動画／ライブ配信）で絞り込み
「TikTok の現地店舗／越境店舗を分析して」	fromFlag で絞り込み
「最近オープンした TikTok 店舗」	出店日で絞り込み
「売上が伸びている TikTok 店舗」	salesTrendFlag=rising で絞り込み
「東南アジアの TikTok 店舗」	地域別に店舗を一覧表示

該当しないケース — 店舗一覧の範囲を超えるリクエスト：

• 商品単体の検索や商品ランキング（EchoTik の商品検索／ランキングスキルを使用）
• TikTok クリエイター／インフルエンサーの分析（フォロワー数、クリエイターのエンゲージメント）
• TikTok 動画のパフォーマンス分析（特定の動画の再生数、いいね数）
• Amazon、Shopee など、TikTok 以外のプラットフォームのデータ
• 店舗単位の運営業務：注文／物流／広告管理

適用範囲の判断：「店舗を探して」や「競合店舗」と言われた場合、意図が売上、GMV、店舗属性で TikTok Shop の店舗を一覧表示して絞り込むことであれば、このスキルが適用されます。特定の店舗の詳細なプロフィールを求めている場合は、既知の sellerId を使用して店舗詳細スキルを利用してください。

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

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

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

フィードバック：

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

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

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

---

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