linkfox-fastmoss-product-rank-top-selling

FastMoss - TikTok 売れ筋ランキング

このスキルでは、FastMoss のデータソースを使って TikTok の売れ筋商品ランキングを取得・分析する方法を説明します。越境ECの販売者が、日別・週別・月別に TikTok のグローバル市場で人気の商品を見つけるのに役立ちます。

主な概念

TikTok 売れ筋ランキングでは、世界 15 市場の TikTok Shop で特に好調な商品を追跡できます。期間（日別・週別・月別）を指定して、販売数、GMV、成長率の各指標でどの商品が上位にあるかを確認できます。TikTok コマースにおける商品リサーチ、トレンド分析、競合情報の把握に欠かせないツールです。

データ範囲：ランキングは TikTok Shop の 15 市場を対象とし、dateInfo パラメーターを使って日・週・月の 3 つの期間単位を指定できます。各商品の情報には、販売数、GMV、成長率、コミッション率、ショップ情報、カテゴリーなどが含まれます。

dateInfo の形式に注意してください：

• type: "day" -> value: "2025-02-01"（YYYY-MM-DD）
• type: "week" -> value: "2025-18"（年-週番号）
• type: "month" -> value: "2025-02"（年-月）

ページネーション：結果はページ分割されています。page（ページ番号。1 から開始）と pageSize（1 ページあたりの件数。最大 10、デフォルト 10）を使って結果を確認してください。

パラメーターガイド

パラメーター	型	必須	説明
region	string	はい	市場の地域コード（US、GB、MX、ES、DE、IT、FR、ID、VN、MY、TH、PH、BR、JP、SG）
dateInfo	object	はい	type（day/week/month）と value（上記の形式を参照）を指定する日付情報
category	string	いいえ	TikTok のカテゴリー ID に対応する英語のカテゴリー名。英語以外の入力は、事前に翻訳する必要があります
orderby	object	いいえ	並べ替え：field（units_sold/gmv/total_units_sold/total_gmv/growth_rate）+ order（desc/asc）。デフォルト：desc
page	integer	いいえ	ページ番号。デフォルトは 1
pageSize	integer	いいえ	1 ページあたりの件数。最大 10、デフォルトは 10

対応市場

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

デフォルトの市場は US です。ユーザーが市場を指定していない場合は、US を使用してください。

呼び出し方法

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

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

• 必ず完全なレスポンスを <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-fastmoss-product-rank-top-selling-<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. 米国の本日の売れ筋商品（日別） 特定の日付の米国市場を照会して、販売数上位の商品を確認します。

region: "US", dateInfo: {"type": "day", "value": "2026-04-15"}

2. 英国の週別売れ筋商品 英国市場の週別ランキングで、好調な商品を確認します。

region: "GB", dateInfo: {"type": "week", "value": "2026-15"}

3. 東南アジアの月別 GMV 上位商品 インドネシア市場の月別売れ筋商品を、GMV 順に確認します。

region: "ID", dateInfo: {"type": "month", "value": "2026-03"}, orderby: {"field": "gmv", "order": "desc"}

4. カテゴリー別ランキング 指定したカテゴリーの売れ筋商品を見つけます。

region: "US", dateInfo: {"type": "day", "value": "2026-04-15"}, category: "Beauty"

データフィールド（レスポンス）

フィールド	API 名	説明
商品タイトル	title	商品名
商品 ID	productId	商品を一意に識別する ID
地域	region	市場地域コード
価格	price	商品価格
最低価格	minPrice	最低価格。任意項目で、価格帯のある商品にのみ含まれます
最高価格	maxPrice	最高価格。任意項目で、価格帯のある商品にのみ含まれます
通貨	currency	API が返す通貨記号または通貨名
総販売数	totalSaleCnt	販売された商品の総数
1 日間の販売数	totalSale1dCnt	過去 1 日間の販売数（dateType=day の場合）
7 日間の販売数	totalSale7dCnt	過去 7 日間の販売数（dateType=week の場合）
30 日間の販売数	totalSale30dCnt	過去 30 日間の販売数（dateType=month の場合）
総 GMV	totalSaleGmvAmt	総流通取引額
1 日間の GMV	totalSaleGmv1dAmt	過去 1 日間の GMV（dateType=day の場合）
7 日間の GMV	totalSaleGmv7dAmt	過去 7 日間の GMV（dateType=week の場合）
30 日間の GMV	totalSaleGmv30dAmt	過去 30 日間の GMV（dateType=month の場合）
成長率	growthRate	販売成長率（パーセンテージ）
ショップ名	shopName	販売者のショップ名
ショップの総販売数	shopTotalUnitsSold	ショップによる販売数の合計
ショップ販売者 ID	shopSellerId	ショップ販売者を一意に識別する ID
カテゴリー名	categoryName	商品カテゴリー
カテゴリー ID	categoryIds	レベル 1 からレベル 3 までのカテゴリー ID の階層
コミッション率	productCommissionRate	ベーシスポイント単位のコミッション率（1000 = 10%）
画像 URL	imageUrl	商品画像の URL
カバー URL	coverUrl	商品カバー画像の URL リスト
ショップアバター	shopAvatar	ショップアバターの URL
ソースツール	sourceTool	ソースツール識別子
ソースタイプ	sourceType	商品ソースタイプ
販売停止ステータス	offShelvesText	販売停止を示す値（「是」= 販売停止、「否」= 販売中）

トップレベルのレスポンスには、errcode、errmsg、page、pageSize、total、products、columns、type、costTime が含まれます。レスポンスの種類によっては、costToken、matchedCategoryIdPath、matchedCategoryNamePath も含まれる場合があります。利用側では、これらを任意項目として扱ってください。

表示ルール

1. データのみを提示：クエリ結果は、主観的なビジネス上の助言を含めず、分かりやすい表で表示してください
2. 成長率：成長率はパーセンテージです。% 記号を付けて表示してください
3. コミッション率：コミッション率はベーシスポイント単位です（1000 = 10%）。表示時にはパーセンテージに変換してください
4. 通貨への配慮：市場によって通貨が異なるため、価格には必ず通貨を併記してください
5. dateInfo の形式：選択した時間粒度に応じて、正しい形式であることを確認し、ユーザーに案内してください
6. 販売停止ステータス：offShelvesText の値「是」は販売停止、「否」は販売中を意味します。ユーザーに分かるように説明してください

重要な制限事項

• dateInfo は必須：type と value の両方を、指定された形式で入力する必要があります
• キーワード検索には非対応：このツールはキーワード検索に対応していません（キーワード検索には linkfox-fastmoss-product-search を使用してください）
• 1 ページあたり最大 10 件：pageSize パラメーターには 10 を超える値を指定できません
• データの遅延：データには T+1 の統計遅延があります

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

該当する場合 -- TikTok の売れ筋商品ランキングとトレンド分析：

ユーザーの発言	シナリオ
"TikTokで最も売れている商品は何ですか"	売れ筋ランキングの検索
"今週のTikTokのベストセラー"、「TikTok Shopの人気商品」	週間／日次ランキングの検索
"TikTokのGMVランキング"、「TikTokで最も売上の高い商品」	GMVに基づくランキング
"TikTokのカテゴリー別人気商品"、「TikTokで最も売れている美容商品」	カテゴリー別ランキング
"TikTokの週間商品レポート"、「月間売れ筋商品」	期間別分析
"FastMossの売れ筋商品"、「FastMossのランキングデータ」	データソースの直接指定
"TikTokで最も急速に売上が伸びている商品はどれですか"	成長率順のランキング

該当しない場合 -- TikTokの売れ筋ランキング以外のニーズ：

• Amazonの商品リサーチまたはABAキーワードデータ
• TikTok広告／広告キャンペーンの管理
• TikTokコンテンツの作成または動画編集
• 商品レビューまたは商品リスティングのコピーライティング
• TikTokの商品キーワード検索（代わりにlinkfox-fastmoss-product-searchを使用）
• 利益率の計算または価格戦略

適用範囲の判断：「商品リサーチ」や「何がよく売れていますか」と尋ねられた場合、文脈からTikTok ShopまたはTikTokのECランキングに関する内容だと明確に判断できれば、このスキルが該当します。Amazon、Shopify、その他のプラットフォームについて尋ねている場合は該当しません。ランキングを閲覧するのではなく、キーワードで商品を検索したい場合は、代わりにlinkfox-fastmoss-product-searchを使用してください。

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

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

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

フィードバック：

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

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

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

---

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