linkfox-echotik-seller-detail

EchoTik TikTok Seller Detail

このスキルは、sellerId を指定して単一の TikTok Shop ストア（セラー）の完全なプロフィールを取得します。越境セラーやマーケターが、売上、複数期間の GMV、フォロワー数、評価、フルフィルメント、インフルエンサー／動画／ライブ配信のリーチなど、ストアのパフォーマンスを詳しく分析するのに役立ちます。

基本概念

EchoTik は TikTok Shop の分析プラットフォームです。このツールは、1 つのストアの詳細オブジェクト全体を返します。これには、合計および増分（1d／7d／30d／90d）の販売数量と GMV、フォロワー数、評価、レビュー数、肯定的なフィードバック率／応答率／配送率、商品数、価格帯、カテゴリー、プロモーションを行うインフルエンサー／動画／ライブ配信の件数が含まれます。

sellerId の取得方法：このスキルでは、ストアの sellerId が必要です。EchoTik TikTok Seller Search スキル（linkfox-echotik-list-seller）から取得してください。このスキルでは、地域、カテゴリー、GMV、トレンド、ストアタイプで TikTok Shop のストアを一覧表示および絞り込みできます。

出品日：firstCrawlDt は、YYYYMMDD のコンパクトな整数形式です（例：2024 年 5 月 4 日の場合は 20240504）。

データフィールド

レスポンスはフラットなストアオブジェクトです（トップレベルには errcode、errmsg、costToken、columns、type も含まれます）。

フィールド	説明
sellerId	ストア ID
sellerName	ストア名
sellerLink	ストアのリンク
coverUrl	ストアのカバー画像 URL
region	マーケットプレイスコード
categoryId / categoryL2Id / categoryL3Id	レベル 1／2／3 のカテゴリー ID
totalSaleCnt	販売数量の合計
totalSale1dCnt / 7dCnt / 30dCnt / 90dCnt	販売数量（1d／7d／30d／90d、増分）
totalSaleGmvAmt	GMV（売上）の合計
totalSaleGmv1dAmt / 7dAmt / 30dAmt / 90dAmt	GMV（1d／7d／30d／90d、増分）
followersCount	フォロワー数
rating	ストア評価
reviewCount	レビュー数
positiveFeedbackRate	肯定的なフィードバック率
responseRate	応答率
deliveryRate	配送率
totalProductCnt	商品数の累計（販売終了商品を含む）
totalCrawlProductCnt	現在ストアで販売中の商品数
spuAvgPrice	ストア内の平均 SKU 価格
minPrice / maxPrice	最低価格／最高価格
totalIflCnt	プロモーションを行うインフルエンサー数
totalVideoCnt	プロモーション動画数
totalLiveCnt	ライブ配信数
salesFlagText	主な販売チャネル（動画による販売／ライブ配信による販売）
salesTrendFlagText	販売トレンド（上昇／下降／安定）
shopIdentityLabel	ストアの認証ラベル（例：OFFICIAL SHOP）
shopTypeText	ブランドストアのフラグ（はい／いいえ）
fromFlagText	国内／越境のフラグ（国内／越境）
productCategoryList	商品カテゴリー（JSON 文字列）
mostProductCategoryList	商品カテゴリー TOP1（JSON 文字列）
firstCrawlDt	推定出品時期（YYYYMMDD）
userId	インフルエンサー UID
sourceType	ソースタイプ（例：Tiktok）
sourceTool	ソースツール
costToken	消費トークン数
columns	表示列の定義（表示メタデータ）
type	表示スタイル（例：tableListWorkbenches）

パラメーターガイド

パラメーター	型	必須	デフォルト	説明
sellerId	string	はい	-	TikTok Shop のストア ID。Seller Search スキルの結果から取得してください。最大長は 1000 です

呼び出し方法

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

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

• 常にレスポンス全体を <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-echotik-seller-detail-<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. ストアの詳細なプロフィールを取得する

{
  "sellerId": "7495514739648989419"
}

2. Seller Search で見つかったストアを詳しく調べる

先用店铺搜索列出美国GMV前列店铺，再查看其中 medicube US Store（sellerId 7495514739648989419）的完整详情

表示ルール

1. ストアプロフィールをわかりやすく表示する：ストア名、地域、セラーリンク、カバー画像、識別ラベル（例：OFFICIAL SHOP）を表示します。
2. 売上と GMV の内訳：売上合計と GMV 合計を表示し、数量と GMV の両方について期間別の内訳（1d／7d／30d／90d）を示し、ユーザーが勢いを把握できるようにします。
3. ストアの健全性指標：フォロワー数、評価、レビュー数、高評価率、応答率、配送率をまとめて表示します。
4. ストア属性：ベンチマーク用に fromFlagText（国内／越境）、salesFlagText（動画／ライブコマース）、salesTrendFlagText（トレンド）、shopTypeText（ブランドストア）を表示します。
5. リーチ指標：totalIflCnt（インフルエンサー数）、totalVideoCnt（動画数）、totalLiveCnt（ライブ配信数）、商品数を表示します。
6. ストアリンク：sellerLink がある場合は、ユーザーがストアを開けるように表示します。
7. 二次処理なし：結果はリアルタイムのクエリであり、データベースには保存されません。二次的な SQL／データ処理は利用できません。

重要な制限事項

1. sellerId が必須：sellerId は必須です。EchoTik TikTok Seller Search スキル（linkfox-echotik-list-seller）または既知のストアリンク／ID から取得してください。
2. 対象は単一ストアのみ：このスキルは 1 つのストアの詳細を返します。ストアの一覧表示や絞り込みには Seller Search スキルを使用してください。
3. 出店日の形式：firstCrawlDt は YYYYMMDD 形式の整数です（例：20240504）。
4. カテゴリ ID：categoryId／categoryL2Id／categoryL3Id は内部 ID であり、人間が読める名称ではありません。
5. データのリアルタイム性：結果はリアルタイムのクエリであり、データベースには保存されません。二次的な SQL／データ処理は利用できません。

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

適用対象 — TikTok Shop の 1 つのストアの詳細なプロフィールを詳しく調べる場合：

ユーザーの発言	シナリオ
「TikTok店铺详情」／「TikTok store detail」	sellerId を指定して、1 つのストアの詳細なプロフィールを取得する
「查看这个TikTok店铺的数据」	検索で見つかったストアを詳しく調べる
「分析medicube这家TikTok店」	単一ストアのパフォーマンス分析
「这个TikTok店铺的GMV和粉丝数」	ストア単位の売上／GMV／フォロワー指標

適用対象外 — 単一ストアの詳細を超える要件：

• 地域／GMV／トレンドによる TikTok Shop ストアの一覧表示や絞り込み（EchoTik TikTok Seller Search を使用）
• TikTok 商品検索または商品ランキング（EchoTik の商品検索／ランキングスキルを使用）
• TikTok クリエイター／インフルエンサー分析（クリエイターのフォロワー数やエンゲージメント）
• TikTok 動画のパフォーマンス分析（特定動画の再生数や「いいね」数）
• Amazon、Shopee、その他 TikTok 以外のプラットフォームのデータ
• ストア単位の運営業務：注文／物流／広告管理

適用範囲の判断：「分析这家店铺」や「查看店铺详情」と言われ、対象ストアが特定されている（sellerId またはストアリンクがある）場合は、このスキルが適用されます。条件に基づくストアの発見や一覧表示を希望している場合は、代わりに Seller Search スキルを使用してください。

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

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

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

フィードバック：

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

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

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

---

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