linkfox-mpstats-ozon-seller-products

MPSTATS Ozon Seller Products

指定した販売者が販売する Ozon（ロシア）の全商品を詳しく分析し、SKU ごとの販売数、売上高、価格、評価、在庫、回転期間、逸失利益などを返します。店舗構成の監査、店舗内のベストセラー分析、競合店舗との直接比較を目的としています。

主な概念

名前ではなく販売者 ID：sellerId は、Ozon／MPSTATS がショップを識別するために使用する sellerId フィールドの数値文字列である必要があります。ブランド名、カテゴリーパス、人が読める販売者名を指定しないでください。販売者名しかわからない場合は、mpstats-ozon-product-search（販売者で絞り込み）で ID を特定し、結果から sellerId を取得してください。

フィルターと演算子：brand-products および category-products と同じ、AND で結合される数値フィルターモデルです。「フィルターリファレンス」を参照してください。

通貨：デフォルトは RUB です。currency／currencyRate を指定すると、USD／EUR／CNY 表示に切り替えられます。

FBO／FBS：includeFbs: true の場合は FBS の数値を含めます。false の場合は FBO のみです。

パラメーター

パラメーター	型	必須	説明
sellerId	string	はい	数値文字列の Ozon 販売者 ID。例："3628678"
startDate	string	いいえ	統計期間の開始日。YYYY-MM-DD。最新日は昨日です
endDate	string	いいえ	統計期間の終了日。YYYY-MM-DD。最新日は昨日です
page	integer	いいえ	ページ番号。1 から開始します
pageSize	integer	いいえ	1 ページあたりの行数。1～100、デフォルトは 100
sortField	string	いいえ	snake_case 形式の列（sales、revenue など）
sortDirection	string	いいえ	asc／desc
currency	string	いいえ	通貨コード。デフォルトは RUB
currencyRate	integer	いいえ	デフォルト以外の通貨に使用するカスタムレート
includeFbs	boolean	いいえ	FBS データを含めるかどうか
filters	array	いいえ	数値フィルターのリスト

フィルターリファレンス

filters の各項目は次の形式です：{"field": "<snake_case>", "op": "<OP>", "value": <num>, "value2": <num?>}。

よく使われるフィールド：sales、final_price、rating、comments、balance、revenue、days_in_stock、turnover_days、lost_profit、category_position。

演算子：GTE、LTE、GT、LT、EQ、NOT_EQ、BETWEEN（value2 が必要です）。

呼び出し方法

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

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

• 常に完全なレスポンスを <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-mpstats-ozon-seller-products-<timestamp>.json に書き込みます（<cwd> はスクリプト実行時の作業ディレクトリで、Claude Code では現在のプロジェクトディレクトリです。<session> は環境変数 SESSION_ID から取得され、ユーザーのタスクごとに自動で集約されます。/tmp への書き込みは禁止です。現在のディレクトリに書き込めない場合はエラーになります）
• レスポンス本文が 8 KB 以下の場合：ファイルに保存した後、完全な JSON を stdout に出力します
• レスポンス本文が 8 KB を超える場合：ファイルに保存した後、stdout には要約のみを出力します（トップレベルのフィールド、total／costToken などの一般的な件数、最大のリストフィールドの長さと先頭 3 件のサンプル）
• --inline を追加すると、stdout に全量を強制的に出力します（同様にファイルにも保存します）

データの読み取りに関する推奨事項：まず要約を確認し、十分かどうか判断してください。具体的なフィールドが必要な場合は、保存された JSON ファイルから jq または ConvertFrom-Json を使って必要なデータを抽出し、JSON 全体がコンテキストに入るのを避けてください。

認証と計算リソースの問題の解決

次の異常が発生した場合は、references/onboarding.md の案内に従って問題を解決してください。

異常な状況

• API Key が未設定：環境変数 LINKFOX_AGENT_API_KEY と LINKFOXAGENT_API_KEY のどちらも設定されていません。
• レスポンスのステータスコードが 401 または 402
• 計算リソースまたは残高が不足しているというレスポンス：メッセージに「算力余额不足／计费不足／余额不足／quota exceeded／insufficient balance／套餐到期／需充值／请充值」または同様の意味の内容が含まれています。

使用例

1. 販売者の商品を販売数順に上位 100 件表示

{
  "sellerId": "3628678",
  "sortField": "sales",
  "sortDirection": "desc",
  "pageSize": 100
}

2. 店舗の商品を売上高順に上位 20 件表示

{
  "sellerId": "3628678",
  "sortField": "revenue",
  "sortDirection": "desc",
  "pageSize": 20
}

3. 回転率の高い主力商品

{
  "sellerId": "3628678",
  "filters": [
    {"field": "sales", "op": "GTE", "value": 30},
    {"field": "turnover_days", "op": "LTE", "value": 20}
  ],
  "sortField": "revenue",
  "sortDirection": "desc"
}

4. 店舗の欠品に関する課題

{
  "sellerId": "3628678",
  "filters": [{"field": "lost_profit", "op": "GTE", "value": 100000}],
  "sortField": "lost_profit",
  "sortDirection": "desc"
}

5. USD 換算による店舗監査

{
  "sellerId": "3628678",
  "currency": "USD",
  "sortField": "revenue",
  "sortDirection": "desc"
}

表示ルール

1. コンパクトなストアテーブル — 主な列：productId、title、brand、price、monthlySalesUnits、monthlySalesRevenue、rating、balance、turnoverDays、lostProfit、position。
2. 売上構成比 = この販売者の検索結果内での割合 — 0～100％です。基準を明記してください。
3. ロシア語の商品名 — そのまま保持してください。ユーザーから依頼があった場合は翻訳します。
4. 通貨表記 — 換算した場合は、「已按 USD 换算」と記載してください。
5. ページネーション — SKU が数千件あるストアでは、深いページまで進む前に絞り込み条件を厳しくするよう提案してください。
6. 購入に関する助言はしない — このスキルはストアの商品構成を表示するもので、SKU を模倣する価値があるかどうかは示しません。

重要な制限事項

• 数値の販売者 ID のみ対応 — 販売者の名前を渡しても解決できません。まず mpstats-ozon-product-search を使用してください。
• ページ上限 — 1ページあたり最大 100 行です。
• T-1 データ — endDate に今日以降の日付は指定できません。
• 事業上の助言はしない — データのみを提供します。
• Ozon のみ対応 — Wildberries などのロシアのマーケットプレイスは対象外です。

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

適用対象 — 販売者単位の Ozon 商品指標：

ユーザーの発言	シナリオ
「販売者 3628678 の販売商品を、売上順にすべて表示して」	ストア SKU マップ
「この Ozon ストアの売上上位商品は？」	ストアの売れ筋商品の詳細確認
「在庫回転日数が 20 日未満の商品を、このストアはいくつ扱っている？」	運用状況の健全性フィルター
「このストアはどの商品で欠品による損失が出ている？」	損失利益の確認
「2 つの Ozon ストアの SKU 数と売上を比較して」	ストア間のベンチマーク（2 回呼び出す）

適用対象外 — 販売者単位の詳細確認を超えるニーズ：

• 販売者の名前しかわからない → mpstats-ozon-product-search を使って ID を特定する
• ブランド単位の詳細確認 → mpstats-ozon-brand-products
• カテゴリ単位の詳細確認 → mpstats-ozon-category-products
• 単一 SKU の時系列データ → mpstats-ozon-product-trend
• Wildberries などのロシアのマーケットプレイス → 対象外

判断基準：対象が特定の販売者で、そのショップの商品ごとのテーブルが必要な場合にこのスキルを使用してください。「カテゴリ X の販売上位の販売者は？」の場合は、カテゴリの詳細確認を使い、クライアント側で販売者ごとにグループ化してください。

算力消耗规则

動的ルールに基づいて課金されます：算力消耗 = 12。リストが空の場合は 0 を返します。

重要：本スキルのサービスは倍率に応じて動的に計算されるため、一度に大量の算力を消耗する可能性があります。必ずユーザーに知らせ、続行するかどうかをユーザーに判断してもらってください。

フィードバック：

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

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

references/api.md に記載された手順に従ってフィードバック API を呼び出してください。ユーザーの操作を妨げないでください。

---

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