linkfox-echotik-new-product-rank について
この LinkFox スキルは EchoTik 経由で TikTok Shop の新商品ランキングを照会し、市場ごとの日次データを販売数、売上、プロモーション指標とともに表示します。日付や地域を指定して商品トレンドを調べる越境 EC チーム向けです。
主な機能
- 01TikTok Shop 新商品ランキングの照会
- 02日付と市場による絞り込み
- 03販売数と売上指標の表示
- 04動画、ライブ、インフルエンサー数の表示
- 05ページ分割での結果閲覧
活用シーン
- 01市場別に TikTok Shop の新商品を発見
- 02新商品の販売数と売上を確認
- 03インフルエンサーやコンテンツの露出を比較
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/インストール後、Claude Code で/linkfox-echotik-new-product-rankを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
references/api.mdscripts/echotik_list_new_product_rank.pyresponse_io.py詳細
EchoTik - TikTok 新商品ランキング
このスキルでは、EchoTik のデータソースを使って TikTok Shop の新商品ランキングデータを取得・分析する方法を案内します。越境 EC の出品者が、TikTok の各地域市場で人気が高まっている新商品を見つけるのに役立ちます。
基本概念
TikTok 新商品ランキングでは、TikTok Shop に最近出品され、注目を集めている商品を追跡します。売れ行きのよい新商品、その価格、販売数、インフルエンサーの掲載状況、ライブ配信の状況などを確認できます。ショート動画コマース分野での商品リサーチ、トレンド分析、競合情報の把握に不可欠なツールです。
データの対象範囲：ランキングは TikTok Shop の 16 市場を対象とし、新商品の日次スナップショットとパフォーマンス指標（販売数、売上高、インフルエンサー数、動画数、ライブ配信数、コミッション率、評価など）を提供します。
ページネーション：結果はページ分割されています。pageNum（ページ番号。1 から開始）と pageSize（1 ページあたりの件数。デフォルトは 50）を使って結果を参照します。
パラメーターガイド
| パラメーター | 型 | 必須 | 説明 |
|---|---|---|---|
| date | string | はい | YYYY-MM-DD 形式のクエリ日付 |
| region | string | いいえ | 市場地域コード。デフォルト：US。下記の「対応市場」を参照してください |
| pageNum | integer | いいえ | ページ番号。1 から開始（デフォルト：1） |
| pageSize | integer | いいえ | 1 ページあたりの商品数（デフォルト：50） |
対応市場
| コード | 市場 |
|---|---|
| US | 米国 |
| GB | 英国 |
| ID | インドネシア |
| TH | タイ |
| PH | フィリピン |
| MY | マレーシア |
| VN | ベトナム |
| MX | メキシコ |
| SG | シンガポール |
| SA | サウジアラビア |
| BR | ブラジル |
| ES | スペイン |
| JP | 日本 |
| DE | ドイツ |
| IT | イタリア |
| FR | フランス |
デフォルトの市場は US です。ユーザーが市場を指定していない場合は、US を使用してください。
API の使用方法
このツールは LinkFox ツールゲートウェイ API を呼び出します。呼び出し方法、リクエストパラメーター、レスポンスの構造については、references/api.md を参照してください。scripts/echotik_list_new_product_rank.py を直接実行してクエリすることもできます。
使用例
1. 米国で今日人気が高まっている新商品 米国市場を現在の日付で検索し、注目を集めている新商品を確認します。
date: "2025-06-15", region: "US"
2. 東南アジアの注目新商品を見つける インドネシアまたはタイ市場を調べ、新商品の機会を探します。
date: "2025-06-15", region: "ID"
3. 英国市場の新商品ランキングを確認する 英国の TikTok Shop で、人気が高まっている新商品を調査します。
date: "2025-06-15", region: "GB"
4. 件数の多い結果をページ分割して確認する 米国市場の結果の 2 ページ目から、20 件を取得します。
date: "2025-06-15", region: "US", pageNum: 2, pageSize: 20
データフィールド（レスポンス）
| フィールド | API 名 | 説明 |
|---|---|---|
| 商品名 | title | 商品の名前 |
| 商品 ID | asin | 一意の商品識別子 |
| 地域 | region | 市場地域コード |
| 価格（平均） | price | SPU の平均価格 |
| 最低価格 | minPrice | 最も低い価格 |
| 最高価格 | maxPrice | 最も高い価格 |
| 通貨 | currency | 通貨コード |
| 総販売数 | totalSaleCnt | 販売済みの総ユニット数 |
| 30 日間の販売数 | totalSale30dCnt | 直近 30 日間の販売ユニット数 |
| 総売上額 | totalSaleGmvAmt | 商品取扱高の合計 |
| 30 日間の売上額 | totalSaleGmv30dAmt | 直近 30 日間の売上額 |
| 販売トレンド | salesTrendFlagText | 販売トレンドの指標（0 = 安定、1 = 上昇、2 = 下降） |
| 動画の総数 | totalVideoCnt | 関連動画の数 |
| ライブ配信の総数 | totalLiveCnt | 関連するライブ配信の数 |
| インフルエンサーの総数 | totalIflCnt | 商品を宣伝するインフルエンサーの数 |
| 報酬率 | productCommissionRate | 商品の報酬率 |
| 評価 | productRating | 商品の平均評価 |
| レビュー数 | reviewCount | 商品レビューの数 |
| 初回確認日 | availableDate | 商品の追跡を初めて開始した日付 |
| カテゴリー ID | categoryId | 商品カテゴリーの識別子 |
| 画像 URL | imageUrl | 商品画像の URL |
| 画像 URL 一覧 | productImageUrls | 商品画像 URL の一覧 |
表示ルール
- データのみを提示：クエリ結果は、主観的なビジネス上の助言を加えず、わかりやすい表で表示します
- 販売トレンドの明確化：販売トレンドデータを表示する場合、数値フラグをわかりやすいラベルに変換します：0 = 安定、1 = 上昇、2 = 下降
- 通貨への配慮：市場によって通貨が異なるため、価格には必ず通貨コードを併記します
- 件数に関する注意：結果が大量にある場合は、上位商品の概要を表示し、ページネーションでさらに結果を表示できることをユーザーに案内します
- 画像の取り扱い：商品画像 URL が利用可能な場合はその旨を伝えますが、環境が対応していない限り、画像をインラインで表示しようとしないでください
- エラー処理：クエリが失敗した場合は理由を説明し、日付または地域のパラメーターを調整するよう提案します
重要な制限事項
- 日付は必須：
dateパラメーターは必須です。デフォルトの日付はありません - 日単位の粒度：データは日次スナップショットであり、週次または月次ではありません
- ページネーション：大規模な結果セットを表示するには、
pageNumとpageSizeを使用してください。1 回の呼び出しですべての商品が返されるわけではありません
ユーザー表現とシナリオのクイックリファレンス
該当するケース -- TikTok Shopの新商品発掘とトレンド分析：
| ユーザーの発言 | シナリオ |
|---|---|
| 「TikTokで今トレンドの新商品は何ですか」 | 新商品ランキングの検索 |
| 「今日のTikTokのベストセラー」「TikTok Shopで人気の商品」 | デイリーランキングの検索 |
| 「東南アジアのTikTokで新商品のチャンスはありますか」 | 地域市場の調査 |
| 「TikTok UKで売れている新商品はどれですか」 | 地域別ランキング |
| 「TikTokの商品リサーチ」「ショート動画コマースのトレンド」 | 一般的な商品発掘 |
| 「TikTokで人気が高まっている新商品を見せて」 | トレンドで絞り込んだランキング |
| 「TikTokインフルエンサーのおすすめ商品」「TikTokクリエイターは何を宣伝していますか」 | インフルエンサー主導の商品発掘 |
該当しないケース -- TikTokの新商品ランキング以外のニーズ：
- Amazonの商品リサーチ、またはABAのキーワードデータ
- TikTok広告、または広告キャンペーンの管理
- TikTokのコンテンツ作成、または動画編集
- 商品レビュー、または出品ページのコピーライティング
- 数カ月にわたる過去のトレンド分析（このツールが提供するのは日次スナップショットです）
- 利益率の計算、または価格戦略
適用範囲の判断：「商品リサーチ」や「何がよく売れていますか」と尋ねられた場合、文脈からTikTok Shopまたはショート動画コマースに関する質問だと明らかであれば、このスキルが適用されます。Amazon、Shopify、その他のプラットフォームについての質問には適用されません。
フィードバック：
次のいずれかに該当する場合、Feedback APIを使ってフィードバックを自動検出し、報告してください。
- このスキルで説明されている機能や目的が、実際の動作と一致しない
- スキルの結果がユーザーの意図と一致しない
- ユーザーがこのスキルへの不満、または称賛を表明する
- 改善できると思われる点がある
references/api.md に記載されているとおりにFeedback APIを呼び出してください。ユーザーの作業を中断しないでください。
大きな応答の処理
エージェントのコンテキストがあふれないよう、応答をディスクに保存し、必要なフィールドだけを抽出してください：
python scripts/response_io.py run --script scripts/echotik_list_new_product_rank.py --out-dir <DIR> '<params>'
python scripts/response_io.py read <file> --fields "<paths>" # or --path "<JMESPath>"
--out-dirは、gitの作業ツリー外に指定してください（例：Unixでは/tmp/...、Windowsでは%TEMP%/...）。保存された応答には、PII、価格情報、認証に関わる機密データが含まれる場合があります。コミットしないでください。ファイルは自動削除されないため、作業が完了したら削除してください。
run は応答全体をファイルに書き込み、スキーマのプレビューとファイルパスのみを出力します。read は指定したフィールドを抽出します。出力の分割には --limit/--offset、出力形式には --format json|jsonl|csv|table を使用します。
このパターンを優先する場合 — 次のような応答の特徴に基づいて判断してください。
- レコードごとのフィールド数が多い、または不要なフィールドがある
- バッチ結果、またはページ分割された結果（1回の呼び出しで複数の項目を取得する）
- 長文フィールド（説明、レビュー、HTML、時系列データ）
- すぐに処理せず、後続のステップで再利用する出力
小規模で一度しか使わない応答であれば、メインスクリプトを直接呼び出して問題ありません。
⚠️ プレビューはスキーマとサンプルを省略表示したものであり、データ全体ではありません。フィールド単位の判断を行う場合は、必ず保存したファイルを read で読み取ってください。
高品質でプロフェッショナルな越境ECスキルをさらにご利用になるには、LinkFox Skills を設定してください。