linkfox-echotik-list-seller-product

EchoTik TikTok Seller Product List

このスキルでは、sellerId を指定して、単一の TikTok Shop セラー（ストア）の販売商品を一覧表示します。これにより、越境セラーやマーケターは、ストアが販売している商品と各商品の実績（複数期間の売上と GMV、価格、評価、レビュー数、コミッション率）を正確に確認できます。

主な概念

EchoTik は TikTok Shop の分析プラットフォームです。ストアの sellerId を指定すると、このツールはそのストアの商品カタログと、商品ごとの指標を返します。指標には、タイトル、画像、価格（SPU の平均／最低／最高価格を含む）、1d／7d／15d／30d／60d／90d／全期間の販売数量と GMV、評価、レビュー数、コミッション率、出品日、販売チャネル、カテゴリーが含まれます。

sellerId の取得方法：EchoTik TikTok Seller Search スキル（linkfox-echotik-list-seller）から取得します。このスキルでは、地域、カテゴリー、GMV、トレンド、ストアの種類で TikTok Shop のストアを一覧表示・絞り込みできます。または、EchoTik TikTok Seller Detail スキル（linkfox-echotik-seller-detail）から取得することもできます。

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

データフィールド

レスポンスの products 配列には、商品オブジェクトが含まれます。主なフィールドは次のとおりです。

フィールド	説明
productId / asin	商品の一意の ID
title / productName	商品タイトル
imageUrl / coverUrl	商品画像の URL
productImageUrls	商品画像の URL 一覧
price	商品価格
spuAvgPrice	SPU の平均価格
minPrice / maxPrice	最低価格／最高価格
currency	通貨
totalSaleCnt	累計販売数量
totalSale1dCnt / 7dCnt / 15dCnt / 30dCnt / 60dCnt / 90dCnt	販売数量（1d／7d／15d／30d／60d／90d、各期間の増分）
totalSaleGmvAmt	累計 GMV（売上高）
totalSaleGmv1dAmt / 7dAmt / 15dAmt / 30dAmt / 60dAmt / 90dAmt	GMV（1d／7d／15d／30d／60d／90d、各期間の増分）
monthlySalesUnits	月間販売数量
productRating	商品評価
ratings / reviewCount	レビュー数
productCommissionRate	コミッション率（小数。例：0.05 = 5%）
categoryName / categoryIds	商品カテゴリー名／ID 一覧
salesFlagText	主な販売チャネル（動画／ライブ配信）
salesTrendFlagText	販売トレンド
firstCrawlDt / availableDate	出品日（YYYYMMDD の整数／日付文字列）
discount / offMarkText / freeShippingText	割引／プロモーション表示／送料無料フラグ
isSShopText	S ストアのフラグ
salePropsInfo	販売属性情報（バリエーション：propId/propName/propValue）
region	マーケットプレイスのコード
sourceTool / sourceType	ソースツール／種類

トップレベルのフィールド：errcode、errmsg、total、columns、type、costToken。

パラメーターガイド

パラメーター	型	必須	デフォルト	説明
sellerId	string	はい	-	TikTok Shop ストア ID。Seller Search／Seller Detail スキルから取得します。最大長は 1000 です
sellerProductSortField	integer	いいえ	1	ソートフィールド：1=累計販売数量、2=累計 GMV、3=SPU 平均価格、4=7 日間の販売数量、5=7 日間の GMV
sortType	integer	いいえ	1	ソート順：0=昇順、1=降順
pageNum	integer	いいえ	1	ページ番号（1 から開始）
pageSize	integer	いいえ	50	ページサイズ。10 の倍数である必要があり、最大値は 100 です

呼び出し方法

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

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

• 常に完全なレスポンスを <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-echotik-list-seller-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. 店舗の総売上上位商品を一覧表示

{
  "sellerId": "7495514739648989419",
  "sellerProductSortField": 1,
  "sortType": 1,
  "pageSize": 20,
  "pageNum": 1
}

2. 店舗の商品を7日間の GMV 順に並べ替え（直近の勢い）

{
  "sellerId": "7495514739648989419",
  "sellerProductSortField": 5,
  "sortType": 1
}

3. 店舗の最安商品（価格の昇順）

{
  "sellerId": "7495514739648989419",
  "sellerProductSortField": 3,
  "sortType": 0
}

表示ルール

1. データをわかりやすく表示する：商品画像、タイトル、価格、総売上、30日間の売上／GMV、評価、レビュー数、コミッション率などの主要な列を含む表で商品を表示します
2. 売上と GMV の粒度：関連する場合は総売上と総 GMV を表示してください。複数期間の内訳（1d／7d／15d／30d／60d／90d）は保存された JSON で確認できることを伝えてください
3. コミッションの表示形式：productCommissionRate は、見やすいようにパーセンテージで表示します（例：0.05 を「5%」と表示）
4. 通貨に関する注意：価格と GMV を表示するときは currency フィールドも含めます
5. 画像の参照：imageUrl がある場合は表示し、ユーザーが商品を視覚的に比較できるようにします
6. 結果件数：total のレコード数と現在のページを必ずユーザーに伝えてください。結果が大量にある場合は、ページネーションまたは条件を絞った並べ替えを提案してください
7. 二次処理不可：結果はリアルタイムのクエリであり、データベースには保存されません。二次的な SQL／データ処理は利用できません

重要な制限事項

1. sellerId は必須：sellerId は必須です。EchoTik TikTok Seller Search スキル（linkfox-echotik-list-seller）、Seller Detail スキル（linkfox-echotik-seller-detail）、または既知の店舗リンク／ID から取得してください。
2. 店舗単位のみ：このツールでは1店舗の商品を一覧表示します。TikTok Shop 全体の商品を検索または絞り込むには、EchoTik TikTok Product Search スキル（linkfox-echotik-list-product）を使用してください。
3. pageSize のルール：10の倍数である必要があります（最大100）。それ以外の値は拒否または調整される場合があります。
4. 出品日の形式：firstCrawlDt は YYYYMMDD 形式の整数を使用します（例：20240504）。
5. 地域／キーワードによる絞り込み不可：このツールが受け取るのは sellerId、並べ替え、ページネーションのみです。キーワード、地域、カテゴリによる絞り込みには対応していません（店舗のマーケットプレイスは seller から推定されます）。
6. データのリアルタイム性：結果はリアルタイムのクエリであり、データベースには保存されません。二次的な SQL／データ処理は利用できません。

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

適用対象 — 特定のTikTok Shop店舗が何を販売しているか確認します。

ユーザーの発言	シナリオ
"TikTok店铺商品" / "TikTok store products"	sellerIdで店舗の商品を一覧表示する
"这个TikTok店铺在卖什么"	店舗の商品カタログを表示する
"查看这家TikTok店铺的商品"	検索または詳細から見つかった店舗を詳しく調べる
"TikTok店铺销量最高的商品"	店舗の商品を総売上順に並べ替える
"TikTok店铺近期爆款"	7日間の売上／GMV順に並べ替える
"这家店哪些商品佣金高"	商品ごとのコミッション率を確認する

適用対象外 — 1店舗の商品リストを超える内容が必要な場合：

• TikTok Shop全体の商品を検索／絞り込みする（EchoTik TikTok Product Searchを使用）
• TikTok Shopの店舗を一覧表示／絞り込みする（EchoTik TikTok Seller Searchを使用）
• 1店舗のプロフィール全体を確認する（EchoTik TikTok Seller Detailを使用）
• TikTokクリエイター／インフルエンサーや動画の分析
• Amazon、Shopee、その他TikTok以外のプラットフォームのデータ

適用範囲の判断：ユーザーが既知の店舗（sellerIdまたは店舗リンク）について「この店铺卖什么」や「查看店铺商品」と言った場合、このスキルが適用されます。キーワード／地域／カテゴリーでTikTok Shop全体の商品を検索したい場合は、代わりにProduct Searchスキルを使用してください。

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

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

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

フィードバック：

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

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

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

---

高品質で専門的な越境ECスキルについては、LinkFox Skillsをご覧ください。