linkfox-fastmoss-product-search

FastMoss - TikTok 商品検索

このスキルでは、FastMoss を使って TikTok Shop の商品データを検索・絞り込む方法を案内します。販売者やマーケターが、世界15の TikTok マーケットにおける商品機会の発見、販売実績の評価、インフルエンサー主導の商品特定を行うのに役立ちます。

基本概念

FastMoss は、複数の TikTok マーケットプレイスにわたって商品のパフォーマンスを追跡する、よく知られた TikTok eコマースデータプラットフォームです。このツールでは、キーワードによる商品検索と豊富な絞り込み機能を利用でき、複数期間（7日間／28日間／90日間／累計）の販売数、GMV（売上高）、価格、評価、レビュー数、コミッション率、インフルエンサーによるプロモーション統計、ショップ情報など、詳細な商品データを取得できます。

販売指標：商品データには、7日間、28日間、90日間、累計の複数期間の販売数が含まれます。同じ期間ごとの粒度で GMV（総流通取引総額）も確認できます。

コミッション率：小数として保存されます（例：0.10 は10％を意味します）。ユーザーに表示する際は、パーセント形式に変換してください。

ショップの種類：ショップの種類で商品を絞り込めます。ローカルショップ（1）または越境ショップ（2）を指定できます。isCrossBorder フィールド（1=越境、0=ローカル）と isSShopText フィールド（TikTok の完全管理ショップ）で、ショップをさらに分類できます。

パラメーターガイド

検索と絞り込み

パラメーター	型	必須	説明
keyword	string	いいえ	検索キーワード（商品タイトルのあいまい一致）
region	string	いいえ	マーケット地域コード。対応：US, GB, MX, ES, DE, IT, FR, ID, VN, MY, TH, PH, BR, JP, SG
category	string	いいえ	TikTok のカテゴリ ID に照合する英語のカテゴリ名。英語以外の名称は先に翻訳してください
shopType	integer	いいえ	ショップの種類：1=ローカルショップ、2=越境ショップ

ブール値フィルター

パラメーター	型	必須	説明
isTopSelling	boolean	いいえ	売れ筋商品のみを絞り込みます
isNewListed	boolean	いいえ	新商品だけを絞り込みます
isSshop	boolean	いいえ	TikTok 完全管理（S-shop）商品のみを絞り込みます
isFreeShipping	boolean	いいえ	送料無料商品のみを絞り込みます
isLocalWarehouse	boolean	いいえ	現地倉庫の商品だけを絞り込みます

範囲フィルター

パラメーター	型	必須	説明
unitsSoldRange	object	いいえ	販売数量の範囲フィルター：{min, max}
commissionRateRange	object	いいえ	コミッション率の範囲フィルター：{min, max}
creatorCountRange	object	いいえ	クリエイター／インフルエンサー数の範囲フィルター：{min, max}

並べ替えとページネーション

パラメーター	型	必須	説明
orderField	string	いいえ	並べ替えフィールド：day7_units_sold, day7_gmv, commission_rate, total_units_sold, total_gmv, creator_count。デフォルト：降順
page	integer	いいえ	ページ番号。デフォルトは1
pageSize	integer	いいえ	1ページあたりの項目数。最大10、デフォルトは10

対応マーケット（15）

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

呼び出し方法

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

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

• 必ず完全なレスポンスを <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-fastmoss-product-search-<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/套餐到期/需充值/请充值」、または類似の意味の内容が含まれています。

データフィールド

各商品で返される主なフィールド：

フィールド	説明
title	商品名
productId	商品の一意識別子
region	市場地域コード
price, minPrice, maxPrice	商品価格と価格帯
currency	通貨コード
totalSaleCnt	累計販売数
totalSale1dCnt, totalSale7dCnt, totalSale28dCnt, totalSale90dCnt	期間別の販売数
totalSaleGmvAmt, totalSaleGmv7dAmt, totalSaleGmv28dAmt	期間別の GMV
totalVideoCnt, totalLiveCnt, totalIflCnt	動画数、ライブ配信数、インフルエンサー数
productCommissionRate	コミッション率（小数。0.10 = 10%）
productRating, reviewCount	評価、レビュー数
skuCount	SKU 数
shopName, shopSellerId, shopTotalUnitsSold	ショップ情報
isCrossBorder	1=越境、0=現地
isSShopText, freeShippingText	フルマネージドショップのフラグ、送料無料のフラグ
salesTrendFlagText	販売動向ラベル
categoryName	商品カテゴリー
tiktokUrl, fastmossUrl, imageUrl	リンクと画像

使用例

1. 基本的なキーワード検索 — 売れ筋商品を探す

{
  "keyword": "phone case",
  "region": "US",
  "orderField": "total_units_sold",
  "pageSize": 10
}

2. 高コミッション商品の検索 — コミッション率10%以上の商品

{
  "keyword": "beauty",
  "region": "US",
  "commissionRateRange": {"min": 0.10},
  "orderField": "commission_rate"
}

3. 越境ショップの商品 — ショップの種類で絞り込む

{
  "keyword": "gadget",
  "region": "US",
  "shopType": 2,
  "orderField": "day7_units_sold"
}

4. インフルエンサーに人気の商品 — 多くのクリエイターがプロモーションする商品

{
  "keyword": "skincare",
  "region": "US",
  "creatorCountRange": {"min": 50},
  "orderField": "creator_count"
}

5. TikTok の新しい売れ筋商品

{
  "keyword": "fashion",
  "region": "GB",
  "isTopSelling": true,
  "isNewListed": true,
  "orderField": "day7_gmv"
}

表示ルール

1. データのみを提示：検索結果は、商品名、価格、累計販売数、7日間の販売数、GMV、評価、コミッション率、プロモーションを行うインフルエンサー数などの主要な列を含む、整理された表で表示してください。主観的なビジネスアドバイスはしないでください
2. コミッション率の形式：コミッション率は小数（0.10 = 10%）です。読みやすいよう、必ずパーセンテージで表示してください
3. 越境情報の明示：isCrossBorder：1 = 越境ショップ、0 = 現地ショップ。明確に表示してください
4. 通貨の明示：価格と GMV を表示する際は、レスポンスの通貨フィールドを含めてください
5. トレンドラベル：トレンド指標として salesTrendFlagText をそのまま表示してください
6. ショップのフラグ：freeShippingText と isSShopText をそのまま表示してください（値はテキストとして読み取れます）
7. エラー処理：検索に失敗した場合は、レスポンスに基づいて理由を説明し、パラメーターの調整を提案してください

重要な制限事項

• 必須パラメーターはありません（すべて任意）ですが、有意義な結果を得るには、少なくともキーワードまたはカテゴリーを指定してください
• 1ページあたり最大10件

該当するシナリオ

ユーザーの発言	シナリオ
「TikTokでトレンドの商品を探して」	売上順でキーワード検索
「TikTokでコミッション率の高い商品」	コミッション率の範囲で絞り込み
「TikTok Shop USでよく売れている商品は？」	売上順で地域別に商品を検索
「TikTokの越境ショップの商品を検索して」	shopType=2 で絞り込み
「多くのインフルエンサーが宣伝している商品は？」	クリエイター数の範囲で絞り込み
「TikTokの完全委託型ショップの商品」	isSshop=true で絞り込み
「東南アジア向けのTikTok商品リサーチ」	東南アジアの特定地域を検索
「TikTokで新しく売れ筋になっている商品」	isTopSelling + isNewListed フラグを使用
「FastMossの商品データ」	プラットフォームを直接指定

該当しないシナリオ

• TikTokインフルエンサー／クリエイターの分析（フォロワー数、クリエイターのエンゲージメント率）
• TikTok動画のパフォーマンス分析（特定動画の再生数、いいね数、シェア数）
• TikTok広告／広告キャンペーンの管理
• Amazon、Shopeeなど、TikTok以外のプラットフォームの商品データ
• TikTok Shopの店舗レベルの分析
• 商品リスティングの作成や最適化に関するアドバイス
• 物流、フルフィルメント、配送の分析

適用範囲の判断：「商品リサーチ」や「TikTokで何を販売すればよいか」と尋ねられた場合でも、TikTok Shopの売上データ、価格、コミッション率を基に商品を検索・絞り込みする内容であれば、このスキルが適用されます。コンテンツ戦略、動画制作、インフルエンサーへのアプローチについて尋ねている場合は適用されません。

算力消耗规则

11算力を消費します。

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

フィードバック：

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

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

references/api.md の指定に従ってフィードバックAPIを呼び出してください。ユーザーの作業を中断しないでください。

---

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