Rms

楽天RMS APIのMCPサーバー — 売上ダッシュボード & 受注管理

できること

Claude Code（または任意のMCPクライアント）から楽天RMSのデータを取得:

ツール	説明
rms_daily_sales	日別売上サマリー（件数・税・クーポン・送料）
rms_product_ranking	商品別ランキング（数量・売上・平均単価）
rms_order_detail	注文番号指定で全詳細JSON
rms_cancel_rate	キャンセル率・件数

セットアップ

git clone https://github.com/yasuhidekoizumi-afk/rms-mcp.git
cd rms-mcp
uv sync

認証

RMS管理画面 → API設定 で serviceSecret と licenseKey を発行。

export RMS_SERVICE_SECRET="SP404839_xxxxxxxxxx"
export RMS_LICENSE_KEY="SL404839_xxxxxxxxxx"

動作確認

RMS_SERVICE_SECRET="SP404839_xxx" RMS_LICENSE_KEY="SL404839_xxx" uv run python -c "
from rms_mcp.order_api import OrderAPI
from rms_mcp.client import RMSClient
c = RMSClient('SP404839_xxx', 'SL404839_xxx')
api = OrderAPI(c)
nums = api.search_orders('2026-05-01T00:00:00+0900','2026-05-08T23:59:59+0900').get('orderNumberList', [])
orders = api.get_order(nums).get('OrderModelList', [])
total = sum(o.get('totalPrice', 0) or 0 for o in orders)
print(f'接続成功！ {len(nums)}件  {total:,}円')
c.close()
"

Claude Code 設定

.mcp.json:

{
  "mcpServers": {
    "rms-mcp": {
      "command": "uv",
      "args": ["run", "rms-mcp"],
      "cwd": "/path/to/rms-mcp",
      "env": {
        "RMS_SERVICE_SECRET": "SP404839_xxx",
        "RMS_LICENSE_KEY": "SL404839_xxx"
      }
    }
  }
}

クイックリファレンス

• 日別売上: 今日の楽天の売上見せて → rms_daily_sales
• 商品ランキング: 今月の楽天TOP10は？ → rms_product_ranking(top_n=10)
• キャンセル率: 今月のキャンセル率は？ → rms_cancel_rate
• 注文詳細: この注文の詳細 → rms_order_detail(order_numbers=[...])

APIカバレッジ

• RakutenPayOrderAPI (searchOrder, getOrder)
• PurchaseItemAPI (searchOrderItem)
• InventoryAPI
• ProductAPI
• CouponAPI

📖 導入マニュアル

詳しい導入手順は SETUP.md を参照してください。

開発・テスト

uv sync --extra dev
uv run pytest                       # ユニット + 統合テスト
RMS_SERVICE_SECRET=SP_xxx RMS_LICENSE_KEY=SL_xxx \
  uv run pytest tests/test_live_smoke.py   # 実API疎通

License

MIT — ORYZAE Inc.