linkfox-mpstats-ozon-brand-products

MPSTATS Ozon ブランド商品

このスキルは、指定したブランド表示名で販売されている Ozon（ロシア）の全商品を詳しく調査し、各 SKU の販売数、売上、価格、評価、在庫、回転日数、逸失利益などを返します。ブランド競合調査、ブランドの SKU 構成分析、ベストセラーの詳細分析向けに構築されています。

基本概念

ブランド表示名：brandName は、Ozon のストアフロントに表示されている名前と一致している必要があります。通常はロシア語（キリル文字）またはラテン文字（adidas、Xiaomi）です。カテゴリパス、販売者 ID、内部ブランドコードは指定しないでください。正確な表記が不明な場合は、まず mpstats-ozon-product-search で確認してください。

フィルターは AND 条件で結合されます：filters 配列では、複数の数値条件を AND 条件で結合できます。各フィルターは {field, op, value, value2?} です。一般的なフィールドと演算子については、以下のフィルターリファレンスを参照してください。

通貨と為替レート：デフォルトの通貨は RUB です。currency: "USD"（または別の通貨コード）を指定すると、金額フィールドがサーバー側で換算されます。必要に応じて、currencyRate でデフォルトのレートを上書きできます。

FBO / FBS の組み合わせ：includeFbs: true にすると、FBS（販売者からの発送）の在庫と販売数が数値に含まれます。false の場合は FBO のみになります。

パラメーター

パラメーター	型	必須	説明
brandName	string	はい	Ozon のブランド表示名（ロシア語またはラテン文字）
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、final_price、balance、rating、...
sortDirection	string	いいえ	asc または desc
currency	string	いいえ	通貨コード。デフォルトは RUB。例：USD、EUR、CNY
currencyRate	integer	いいえ	デフォルト以外の通貨を使用する際のカスタムレート
includeFbs	boolean	いいえ	FBS データを含める
filters	array	いいえ	数値フィルター条件（以下を参照）

フィルターリファレンス

各 filters エントリー：{"field": "<snake_case>", "op": "<OP>", "value": <num>, "value2": <num?>}。

一般的なフィールド：sales（月間販売数）、final_price（販売価格 RUB）、rating（0～5）、comments（レビュー数）、balance（在庫）、revenue（販売額 RUB）、days_in_stock、turnover_days、lost_profit、category_position。

演算子：GTE、LTE、GT、LT、EQ、NOT_EQ、BETWEEN（上限値として value2 が必要です）。

呼び出し方法

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

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

• 常に完全なレスポンスを <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-mpstats-ozon-brand-products-<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. ブランド adidas の販売数上位 50 件

{
  "brandName": "adidas",
  "sortField": "sales",
  "sortDirection": "desc",
  "pageSize": 50
}

2. 高評価かつ中価格帯のフィルター

{
  "brandName": "Xiaomi",
  "filters": [
    {"field": "rating", "op": "GTE", "value": 4.5},
    {"field": "final_price", "op": "BETWEEN", "value": 1000, "value2": 5000}
  ],
  "sortField": "revenue",
  "sortDirection": "desc"
}

3. USD 換算での出力

{
  "brandName": "Nike",
  "currency": "USD",
  "sortField": "revenue"
}

4. FBS を含め、在庫のある商品のみ

{
  "brandName": "adidas",
  "includeFbs": true,
  "filters": [{"field": "balance", "op": "GT", "value": 0}]
}

5. 逸失利益が大きい商品（在庫切れによる損失）

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

表示ルール

1. コンパクトなブランド表 — 主な列：productId、title、price、monthlySalesUnits、monthlySalesRevenue、rating、reviewCount、balance、turnoverDays、lostProfit。
2. 売上シェアの説明 — revenueSharePercent は、このブランドの結果セット内における SKU のシェア（0～100）です。表示する際は、シェアの基準を明記してください。
3. 通貨の表示 — 表のヘッダーには必ず通貨を記載してください。currency が上書きされている場合は「USD に換算済み」と記載してください。
4. ロシア語の商品名 — 原文を維持してください。ユーザーから依頼があった場合は翻訳します。
5. ページネーション — 総件数を報告し、総件数が取得したページを超える場合は、次のページへ進むか、フィルターを絞り込むよう案内してください。
6. ビジネス上の助言はしない — データを提示し、スナップショットから将来の売上を予測しないでください。

重要な制限事項

• ブランド名の完全一致 — あいまい検索には対応していません。入力ミスがあると結果は空になります。不明な場合は mpstats-ozon-product-search で確認してください。
• ページ上限 — 1ページあたり最大 100 行です。該当ブランドの商品数がそれを超える場合は、ページネーションしてください。
• 日付範囲 — endDate に今日または未来の日付は指定できません（データは T-1 まで）。
• 通貨換算 — サーバー側で行われます。過去の換算レートは、ユーザーが参照するレートと多少異なる場合があります。
• ロシア語のみの商品名 — 依頼があった場合にのみ翻訳してください。

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

該当するケース — Ozon のブランド単位の商品指標：

ユーザーの発言	シナリオ
「Ozon で adidas の売れ筋 SKU を表示して」	ブランドのベストセラー調査
「Ozon で Xiaomi は何を販売していますか？売上順で表示してください」	ブランドの売上構成
「評価が 4.5 以上で在庫が 0 より多い、brand-X の SKU はどれですか？」	ブランドの品質フィルター
「brand-X の在庫切れで大きな逸失利益が発生していますか？」	逸失利益の調査
「brand-X の Ozon 売上を USD に換算して」	通貨を統一した監査

該当しないケース — ブランド単位の詳細分析を超える場合：

• ブランド名が不明、または正確でない → まず mpstats-ozon-product-search を使用
• ブランド間のカテゴリー単位の比較 → mpstats-ozon-category-products を使用
• セラー単位の分析 → mpstats-ozon-seller-products を使用
• 単一 SKU の時系列分析 → mpstats-ozon-product-trend を使用
• Wildberries／その他のロシアのマーケットプレイス → 対象外

判断基準：質問の中心が1 つのブランドで、そのブランドの SKU ごとの集計データを確認したい場合に、このスキルを使用してください。「カテゴリー X でどのブランドが優勢か」を確認する場合は、カテゴリーの詳細分析を使用し、サーバー側でブランドごとの行を比較してください。

算力消耗规则

動的ルールに基づく課金：算力の消費量 = 12。一覧が空の場合は 0 を返します。

重要：このスキルのサービスは倍率に応じて動的に計算され、1 回の実行で大量の算力を消費する場合があります。必ずユーザーに通知し、続行するかどうかはユーザーに判断してもらってください。

フィードバック：

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

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

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

---

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