linkfox-echotik-list-new-product-rank

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

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

• 常に完全なレスポンスを <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-echotik-list-new-product-rank-<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. 今日の米国の注目新商品 当日の日付で米国市場を照会し、注目を集めている新商品を確認します。

date: "2025-06-15", region: "US"

2. 東南アジアの人気新商品を見つける インドネシアまたはタイの市場で、新商品のビジネスチャンスを探します。

date: "2025-06-15", region: "ID"

3. イギリス市場の新商品ランキングを閲覧する イギリスの TikTok Shop を調査し、注目の新商品を探します。

date: "2025-06-15", region: "GB"

4. 件数の多い結果をページ分割して閲覧する 米国市場の結果から、20 件のうち 2 ページ目を取得します。

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 の一覧

表示ルール

1. データのみを提示：クエリ結果は、主観的なビジネスアドバイスを添えず、分かりやすい表で表示します
2. 販売トレンドの明確化：販売トレンドデータを表示する際は、数値フラグを人が理解しやすいラベルに変換します：0 = 安定、1 = 上昇、2 = 下降
3. 通貨への配慮：市場によって通貨が異なるため、価格は必ず通貨コードとともに表示します
4. 件数に関する注意：結果が多い場合は、上位商品の概要を示し、ページネーションでさらに結果を確認できることを案内します
5. 画像の取り扱い：商品画像 URL がある場合はその旨を伝えますが、環境が対応していない限り、画像をインラインで表示しようとしないでください
6. エラー処理：クエリに失敗した場合は、その理由を説明し、日付または地域のパラメーターを調整するよう提案します

重要な制限事項

• 日付は必須：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、その他のプラットフォームについて尋ねている場合は該当しません。

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

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

ユーザーは計算リソースの消費に応じて料金を支払います。この点を十分に考慮してください。このスキルを高頻度で呼び出す必要がある場合、またはユーザーが計算リソースの消費量を過小に見積もっている場合は、必ずユーザーに伝え、続行するかどうかはユーザーに判断してもらってください。

フィードバック：

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

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

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

---

高品質でプロフェッショナルな越境ECスキルをさらに利用するには、LinkFox Skills を設定してください。