io.github.atushi1841/rakuten-japan-mcp
Search Rakuten Ichiba products and rankings via official Rakuten APIs.
Rakuten Japan MCP — 楽天市場商品検索・ランキング
Search Rakuten Ichiba (楽天市場) products and fetch the current ranking via the official Rakuten APIs.
Extract item names, prices, URLs, shop info, reviews, and images in clean structured JSON.
🚀 What This Does
This actor wraps the official Rakuten APIs and makes them available two ways:
- A traditional Apify actor — run it from the Apify Console, API, or schedule
- An MCP server — connect AI agents (Claude, Cursor, ChatGPT) to query Rakuten in real-time
Two data access modes:
- Product search —
IchibaItem/Searchofficial API (keyword search) - Ranking —
IchibaItem/Rankingofficial API (what's hot, genre ranking, historical eras)
Why use this? Rakuten is Japan's largest e-commerce platform with millions of products. This actor gives you programmatic access to product and ranking data without scraping HTML or managing proxies — both via TOS-compliant official APIs.
🔧 Usage
As an Apify Actor
1. Product Search — set searchKeyword (e.g. "ポケモン", "フィギュア", "PS5") and optional filters.
2. Ranking — set ranking to true, optionally narrow with genreId:
| Parameter | Type | Default | Description |
|---|---|---|---|
ranking | boolean | false | Set true to fetch ranking instead of search |
genreId | integer | — | Restrict to genre (e.g. 101269=本・雑誌, 101347=おもちゃ) |
rankingType | select | item | item, male, or female |
era | string | — | Past-ranking era YYYYMMDD (e.g. 20190601) |
maxResults | int | 30 | Max results (ranking max 30 per call) |
As an MCP Server
Connect any MCP-compatible client to the actor's standby endpoint.
Tools:
search_rakuten— keyword product search, returns title/price/URL/shop/review/imagesearch_rakuten_ranking— current Rakuten ranking (genre / male / female / historical era)get_actor_info— list of tools and pricing
🧹 Official API Details
- Search:
https://openapi.rakuten.co.jp/ichibams/api/IchibaItem/Search/20260701 - Ranking:
https://app.rakuten.co.jp/services/api/IchibaRanking/Ranking/20220601
Search requires RAKUTEN_APP_ID and RAKUTEN_ACCESS_KEY; ranking requires only RAKUTEN_APP_ID. These are Secret environment variables set on the Apify actor.
🧪 Tests & Type Checking
python -m pytest tests/ -v
python -m mypy src/ --strict
Deploy happens automatically on push to master/main via GitHub Actions.
🔒 Pricing (pay-per-event)
rakuten-search: $0.001 / searchrakuten-ranking: $0.001 / ranking
MCP Registry
This server is registered on the official MCP Registry. Find it via search: rakuten-japan-mcp
Setup from the maintainer
This listing does not have a supported local package template. Use the maintainer’s documentation for its hosted endpoint, authentication, and client-specific setup. No install command has been inferred.
Package
https://github.com/atushi1841/rakuten-japan-mcp/releases/download/v0.1.0/rakuten-japan-mcp.mcpbotherCompatible MCP Clients
io.github.atushi1841/rakuten-japan-mcp works with any MCP-compatible client. Copy the config snippet from the Configuration section above and add it to the file shown for your client, then restart the application.
- Claude Desktop
~/Library/Application Support/Claude/claude_desktop_config.jsonRestart Claude Desktop completely for changes to take effect. - Cursor
~/.cursor/mcp.jsonRestart Cursor for changes to take effect. - VS Code
.vscode/mcp.jsonReload VS Code window for changes to take effect. - Windsurf
~/.codeium/windsurf/mcp_config.jsonRestart Windsurf for changes to take effect. - Claude Code
.mcp.jsonSave at the project root, then start Claude Code in that project and review the MCP server approval prompt. Keep real credentials out of shared files.