mpstats

MPSTATS API

MPSTATS は、Wildberries、Ozon、Yandex Market のデータを提供するロシアのマーケットプレイス分析プラットフォームです。商品調査、カテゴリー分析、販売者／ブランドのモニタリング、SKU 単位の売上、在庫、レビューのデータを扱えます。

scripts/ にある既製のシェルスクリプトを使用してください。HTTP コードを記述する代わりに、Bash ツール経由でスクリプトを呼び出します。references/ 内のファイルは API 契約のみを記載しています。

トークンの設定

スクリプトは scripts/common.sh を介して config/.env からトークンを自動的に読み込みます。コマンドごとの MPSTATS_TOKEN 環境変数がファイルの値より優先されます。

設定方法とトークンの取得先については、config/README.md を参照してください。

トークンがない場合は、続行する前にユーザーに以下の 2 つの選択肢を提示してください。

1. ユーザーがチャットでトークンを送信する → エージェントが config/.env を作成します。
2. ユーザーがローカルで cp config/.env.example config/.env を実行し、config/.env にトークンを貼り付けます。

トークンのページ：https://mpstats.io/userpanel（API token ブロック）。有効な MPSTATS サブスクリプションが必要です。

リファレンス

API 契約（エンドポイント、パラメーター、レスポンスの仕様）は必要に応じて参照してください。

• references/auth.md — ベース URL、認証ヘッダー、レスポンスコード、レート制限
• references/pagination-filter-sort.md — すべての POST エンドポイントに共通するリクエスト／レスポンスモデル
• references/wb-categories.md、references/wb-brands-sellers.md、references/wb-similar-sku.md — Wildberries
• references/ozon-categories.md、references/ozon-brands-sellers-sku.md — Ozon
• references/ym-categories.md — Yandex Market
• references/account.md — API の制限
• references/coverage.md — スクリプトで対応している範囲と、未対応の範囲
• references/presentation.md — 分析結果の回答と、ブランドスタイルの HTML／PDF レポートのフォーマット方法

結果のフォーマット

まず簡潔な結論を示し、その後に根拠を説明してください。複数の対象を比較する結果は簡潔な表で示し、推移、セグメンテーション、比較にはグラフを使用してください。求められない限り生の JSON をそのまま表示せず、数値が判断に何を意味するかを解釈してください。HTML／PDF レポートを作成する場合は、references/presentation.md の MPSTATS ブランドスタイルに従ってください。

整合性チェック — 異常値を明示し、鵜呑みにして報告しない

MPSTATS のデータには、外れ値、販売者側の誤り、単位の不一致、古い行が含まれることがあります。それらを事実として報告すると、ユーザーに誤解を与えます。数値を提示する前に、必ずその桁が妥当か確認してください。

以下のような場合は明示してください。

• カテゴリーの通常範囲から大きく外れた価格 — 例：ナプキンが 1 個 500 000 ₽、スマートフォンケースが 50 ₽、冷蔵庫が 200 ₽。カテゴリーの中央値と比較し、およそ 10 倍を超えて外れている場合は、ほぼ確実に販売者側の価格エラー、単位の不一致（パックと個）、または仮の値です。
• あり得ない販売量 — 小規模な販売者が突然 1 か月に 1 000 000 個販売している、販売数がないのに売上がある、売上 ≠ おおよそ price × units。
• 本来あるべきでないゼロ／null／負の値 — レビューがある SKU の評価が 0、在庫 = -5、明らかに販売が停止している SKU の「最終販売から 0 日」。
• 日付／期間の異常 — 要求した期間 ≠ 返された期間、日付ごとの系列に欠落がある、未来の日付の行がある。
• 単位の不一致 — パックあたりの価格を 1 個あたりの価格として扱っている、m² と個、リットルと ml。

以下の順序で明示してください。

1. 異常のある行を値が分かるように明確に示します（例：「1 упаковку за 500 000 ₽ — похоже на ошибку ценника продавца」）。
2. 原因として最も可能性の高いものを述べます（単位の不一致、販売者の誤り、古いデータ、仮の値）。
3. その行を集計から除外した場合はその旨を伝えるか、集計値がその行により偏っていることを記載します。
4. クリーニングしたデータで分析を続けます。

異常値を黙って除外したり、「丸め」たりしないでください。実際の値であるかのように報告し、ユーザーが異常に気づくのを待つこともしないでください。結論はクリーニング後のデータに基づくものとし、透明性を保つため、生の外れ値にも言及してください。

スクリプト

scripts/ にすぐに使えるシェルスクリプトがあります。Bash ツール経由で呼び出し、HTTP を書き直さないでください。各スクリプトの使用例とルーティングのガイダンスを含むカタログ全体は scripts/README.md を参照してください。パラメーターを確認するには、任意のスクリプトを --help 付きで実行してください。

スクリプト	目的	使用方法
account/account-limits.sh	API の残りの利用上限を確認	./scripts/account/account-limits.sh
wb/wb-categories-list.sh	WB の全カテゴリー階層	./scripts/wb/wb-categories-list.sh
wb/wb-category.sh	WB カテゴリーの商品	./scripts/wb/wb-category.sh "Электроника/Смартфоны" 2024-01-01 2024-03-01
wb/wb-category-stats.sh	WB カテゴリーの内訳（サブカテゴリー／ブランド／販売者／トレンド）	./scripts/wb/wb-category-stats.sh "Электроника" subcategories
wb/wb-sku.sh	WB SKU 分析（全データ／売上／在庫／キーワード／コメント）	./scripts/wb/wb-sku.sh 152490541 sales
wb/wb-card-content.sh	WB の商品カード内容（説明、特徴、寸法）— MPSTATS ではなく WB CDN を使用	./scripts/wb/wb-card-content.sh 290784358 .description
wb/wb-brand.sh	WB ブランドの商品または分析	./scripts/wb/wb-brand.sh "Nike" products
wb/wb-seller.sh	WB 販売者の商品または分析	./scripts/wb/wb-seller.sh 123456 products
wb/wb-search.sh	リサーチ用の WB 商品分野／ニッチ一覧	./scripts/wb/wb-search.sh
wb/wb-subject.sh	WB 商品分野のエンドポイント（products、categories、brands、sellers、trends、by_date、price_segmentation、keywords、similar、geography、warehouses）	./scripts/wb/wb-subject.sh 70 products
wb/wb-similar.sh	WB の類似商品群（identical、identical_wb、similar、in_similar）	./scripts/wb/wb-similar.sh similar 72124874 products
wb/wb-analytics.sh	WB の AI 予測と季節性の影響	./scripts/wb/wb-analytics.sh category forecast/daily "Женщинам/Платья и сарафаны"
wb/wb-warehouses.sh	ブランド／販売者別の WB 倉庫分布	./scripts/wb/wb-warehouses.sh brand "Mango"
wb/wb-compare.sh	カテゴリー／ブランド／販売者／商品分野の WB 期間比較	./scripts/wb/wb-compare.sh subject 70 2024-01-01 2024-01-15 2024-01-16 2024-01-31
ozon/ozon-categories-list.sh	Ozon の全カテゴリー階層	./scripts/ozon/ozon-categories-list.sh
ozon/ozon-category.sh	Ozon カテゴリーの商品または統計	./scripts/ozon/ozon-category.sh "Автотовары" products
ozon/ozon-sku.sh	Ozon SKU レポート（sales、by_day、balance、categories、keywords、full、by_period、search_stats、stores、comments）	./scripts/ozon/ozon-sku.sh 123456789 keywords 2023-11-27 2023-12-26
ozon/ozon-brand.sh	Ozon ブランドの商品または分析	./scripts/ozon/ozon-brand.sh "Samsung" categories
ozon/ozon-seller.sh	販売者 ID または名前による Ozon 販売者の商品または分析	./scripts/ozon/ozon-seller.sh 987654 products
ozon/ozon-compare.sh	カテゴリー／ブランド／販売者の Ozon 期間比較	./scripts/ozon/ozon-compare.sh category "Автотовары/..." 2024-01-01 2024-01-15 2024-01-16 2024-01-31
ym/ym-category.sh	Yandex Market カテゴリーの商品または統計	./scripts/ym/ym-category.sh "Электроника/Смартфоны"
ym/ym-brand.sh	Yandex Market ブランドの商品または分析	./scripts/ym/ym-brand.sh "Samsung" categories
ym/ym-seller.sh	Yandex Market 販売者の商品または分析	./scripts/ym/ym-seller.sh "Эльдорадо" products
ym/ym-sku.sh	日付を指定できる Yandex Market 商品の販売履歴	./scripts/ym/ym-sku.sh 12345678 2024-01-01 2024-01-31
ym/ym-compare.sh	カテゴリー／ブランド／販売者の Yandex Market 期間比較	./scripts/ym/ym-compare.sh category "Электроника/Смартфоны" 2024-01-01 2024-01-15 2024-01-16 2024-01-31
request.sh	任意の MPSTATS メソッド／パスに対応する汎用の API 呼び出し	./scripts/request.sh POST subject/items 'path=70&d1=2024-01-01&d2=2024-01-31'