rakuten-pantry-mcp
A Rakuten Ichiba (Japan's largest e-commerce marketplace) MCP server for searching, browsing, and comparing products with enhanced pricing and shipping insights. Requires RAKUTEN_APP_ID and RAKUTEN_ACCESS_KEY for authentication.
Tools:
ichiba_item_search— Search products by keyword with optional filters for price range, genre, and shop. Returns enriched fields:quantity(parsed from product name, e.g. "24本入り×2ケース" → 48)unitPrice(price ÷ quantity)postageLabel(送料無料 / 送料別 / 要確認)estimatedTotalPrice(itemPrice when free shipping)shippingVerified(whether shipping cost is confirmed via API)
ichiba_genre_search— Browse the genre/category hierarchy; pass'0'for top-level genres or a specific genre ID to drill into subcategories.ichiba_tag_search— Look up details for a specific tag ID (facet attributes like size, color), including the tag's group, name, and parent tag.ichiba_item_ranking— Retrieve bestseller rankings, filterable by genre, time period (realtime/daily/weekly/monthly/yearly), age demographic, and gender. Returns the same enriched pricing/shipping fields as item search.ichiba_product_search— Cross-seller product search (Item Price Navi) comparing prices for identical products across multiple shops, returning min/max/average prices and number of sellers. Supports filtering by maker/brand code.
Prompt:
compare_ichiba_value— Guides agents through a structured unit-price and shipping-inclusive comparison workflow, including web-searching unconfirmed shipping costs and re-ranking by total cost, ensuring accurate cost-per-unit comparisons.
Provides tools for searching items, genres, tags, rankings, and product comparisons on Rakuten Ichiba, with enhanced fields like quantity, unit price, and shipping cost labels.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@rakuten-pantry-mcpfind the cheapest bulk pasta with free shipping and best unit price"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
rakuten-pantry-mcp
mrslbt/rakuten-mcp をベースにした楽天市場(Ichiba)向け MCP サーバーです。
upstream(npm の rakuten-mcp)にはない機能を追加しています。
追加機能(upstream にない)
フィールド / 機能 | 説明 |
| 商品名から総個数を解析(例: |
|
|
|
|
| 送料無料時は |
| 送料が API 上で確定しているか |
| 単価比較+送料ウェブ確認のガイドプロンプト |
改造の詳細は CHANGES.md。upstream へのパッチは patches/ を参照。
Related MCP server: rakuten-mcp
リポジトリ構成
rakuten-pantry-mcp/
├── src/
│ ├── index.ts # エントリポイント
│ ├── server.ts # MCP サーバー組み立て
│ ├── client.ts # 楽天 API クライアント
│ ├── config.ts / errors.ts / i18n.ts / auth.ts
│ ├── tools/
│ │ ├── ichiba.ts # ★ 改造の本体(5ツール)
│ │ ├── index.ts
│ │ ├── types.ts
│ │ └── meta.ts
│ ├── prompts/
│ │ ├── ichiba.ts # ★ compare_ichiba_value
│ │ ├── schema.ts # ★ プロンプト引数の型変換
│ │ └── index.ts
│ ├── transports/ # stdio / HTTP
│ └── resources/
├── test/ # ichiba / prompts / http のテスト
├── patches/ # upstream 向け差分
├── dist/ # ビルド成果物(npm run build)
├── package.json
├── README.md
├── CHANGES.md
├── AGENTS.md
└── LICENSEIchiba ツール 5個のみ(Books / Travel / Recipe / Kobo / GORA は含みません)。resources/ は現時点では未使用(空のレジストリ)です。
セットアップ
git clone https://github.com/yukin_co/rakuten-pantry-mcp.git
cd rakuten-pantry-mcp
npm install
npm run buildMCP クライアント設定
環境変数 RAKUTEN_APP_ID と RAKUTEN_ACCESS_KEY が必要です(楽天デベロッパーで取得)。
ローカル clone を使う場合
args には clone 先の dist/index.js への絶対パス を指定します。
{
"mcpServers": {
"rakuten-pantry": {
"command": "node",
"args": ["/path/to/rakuten-pantry-mcp/dist/index.js"],
"env": {
"RAKUTEN_APP_ID": "your-app-id",
"RAKUTEN_ACCESS_KEY": "your-access-key"
}
}
}
}npx で使う場合(npm 公開後)
{
"mcpServers": {
"rakuten-pantry": {
"command": "npx",
"args": ["-y", "rakuten-pantry-mcp"],
"env": {
"RAKUTEN_APP_ID": "your-app-id",
"RAKUTEN_ACCESS_KEY": "your-access-key"
}
}
}
}npm の
rakuten-mcp(mrslbt/rakuten-mcp)は別パッケージです。上記のrakuten-pantry-mcpを指定してください。
ツール(5)
ツール | 内容 |
| キーワード検索(quantity / unitPrice / 送料フラグ付き) |
| ジャンルツリー |
| タグ参照 |
| 売れ筋ランキング |
| 複数店舗横断の価格比較 |
プロンプト(1)
プロンプト | 内容 |
| 単価比較と送料確認の手順をエージェントに渡す |
開発
npm run typecheck
npm test
npm run buildライセンス
MIT — 元: mrslbt/rakuten-mcp(MIT)
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Servers
- Flicense-qualityDmaintenanceAn MCP server that enables users to search for products on the Mercari marketplace using keywords, categories, and specific filters like price and condition. It provides comprehensive tools for retrieving item details and browsing search results via standard or SSE protocols.
- AlicenseAqualityAmaintenanceMCP server for Rakuten APIs. Search products, books, hotels, and rankings across Japan's largest e-commerce platform.28885MIT
- Flicense-qualityBmaintenanceThis MCP server analyzes product photos using AI to generate listing drafts, publishes to Mercari Shops via GraphQL API, and exports drafts for other marketplaces.
- Flicense-qualityBmaintenanceMCP server to search Rakuten Ichiba (Japan's largest e-commerce platform) for products, returning names, prices, URLs, shop info, reviews, and images via the official Rakuten API.
Related MCP Connectors
Hosted Amazon Seller and Vendor MCP server for Claude, ChatGPT, Cursor, Codex, Gemini, Copilot.
Hosted Amazon Seller Central and Amazon Ads MCP server for Claude, ChatGPT, Cursor, and agents.
Get recommended by Amazon's AI. Hosted MCP server for Amazon listing compliance & generation.
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/yukincom/rakuten-pantry-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server