linkfox-fastmoss-top-selling

FastMoss - TikTok 売上上位ランキング

このスキルでは、FastMoss のデータソースを使用して TikTok の売上上位商品ランキングを照会・分析する方法を説明します。越境ECのセラーが、日別・週別・月別に TikTok の各国市場で売れている商品を特定できるよう支援します。

主な概念

TikTok 売上上位ランキングでは、世界 9 市場の TikTok Shop で特に好調な商品を確認できます。期間（日別、週別、月別）を指定すると、販売数量、GMV、成長率で上位の商品がわかります。TikTok のECにおける商品リサーチ、トレンド分析、競合調査に欠かせないツールです。

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

dateInfo の形式は重要です：

• type: "day" -> value: "2025-02-01" (YYYY-MM-DD)
• type: "week" -> value: "2025-18" (year-weekNumber)
• type: "month" -> value: "2025-02" (year-month)

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

パラメーターガイド

Parameter	Type	Required	Description
region	string	はい	市場の地域コード（US、GB、MX、ES、ID、VN、MY、TH、PH）
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

対応市場

Code	Market
US	アメリカ合衆国
GB	イギリス
MX	メキシコ
ES	スペイン
ID	インドネシア
VN	ベトナム
MY	マレーシア
TH	タイ
PH	フィリピン

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

API の使用方法

このツールは LinkFox ツールゲートウェイ API を呼び出します。呼び出し方法、リクエストパラメーター、レスポンスの構造については references/api.md を参照してください。また、scripts/fastmoss_product_rank_top_selling.py を直接実行してクエリを実行することもできます。

使用例

1. US の本日の売上上位商品（日別） 特定の日付を指定して US 市場を照会し、販売上位の商品を確認します。

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

2. UK の週別売上上位商品 UK 市場で週別の売上上位商品を確認します。

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	商品の一意な識別子
地域	region	市場地域コード
価格	price	商品価格
最低価格	minPrice	最低価格
最高価格	maxPrice	最高価格
通貨	currency	通貨コード
総販売数	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	ショップ販売者の一意な識別子
カテゴリー名	categoryName	商品カテゴリー
コミッション率	productCommissionRate	ベーシスポイントで表したコミッション率（1000 = 10%）
画像 URL	imageUrl	商品画像の URL
販売終了ステータス	offShelvesText	販売終了を示す値は「はい」、販売中を示す値は「いいえ」です

表示ルール

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のEコマースランキングが明らかであれば、このスキルが該当します。Amazon、Shopify、その他のプラットフォームについて尋ねている場合は該当しません。ランキングを閲覧するのではなく、キーワードで商品を検索したい場合は、代わりにlinkfox-fastmoss-product-searchを使用してください。

フィードバック：

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

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

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

大きな応答の処理

エージェントのコンテキストがあふれないように、応答をディスクに保存し、必要なフィールドだけを抽出してください。

python scripts/response_io.py run --script scripts/fastmoss_product_rank_top_selling.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で読み取ってください。

---

高品質でプロフェッショナルな越境Eコマーススキルについては、LinkFox Skillsをご覧ください。