How do I install Rakuten Japan?

Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does Rakuten Japan need an API key?

No required environment variable is listed on this record.

What transport does Rakuten Japan use?

Rakuten Japan runs locally over stdio.

When was Rakuten Japan last checked?

Last checked 2026-11-09. Search Rakuten Ichiba products and rankings via official Rakuten APIs.

Rakuten Japan MCP server

Power your agent

Add this server

The publisher's own command. Not a PlugMCP endpoint.

Add to Cursor Add to VS Code Run on PlugMCP

Host a copy with our keys and logs.

Local command

mcpb https://github.com/atushi1841/rakuten-japan-mcp/releases/download/v0.1.0/rakuten-japan-mcp.mcpb

Claude Code has no install link for a local command. Copy the command below and run it in a terminal.

shClaude Code

1claude mcp add io.github.atushi1841-rakuten-japan-mcp -- mcpb https://github.com/atushi1841/rakuten-japan-mcp/releases/download/v0.1.0/rakuten-japan-mcp.mcpb

Run in a terminal.

jsonClaude Desktop

1{2  "mcpServers": {3    "io.github.atushi1841-rakuten-japan-mcp": {4      "command": "mcpb",5      "args": [6        "https://github.com/atushi1841/rakuten-japan-mcp/releases/download/v0.1.0/rakuten-japan-mcp.mcpb"7      ]8    }9  }10}

claude_desktop_config.json

Local · mcpbPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Local

Transport: stdio
Version: 0.1.0
Last checked

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

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/Search official API (keyword search)
Ranking — IchibaItem/Ranking official 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/image
search_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 / search
rakuten-ranking: $0.001 / ranking

MCP Registry

This server is registered on the official MCP Registry. Find it via search: rakuten-japan-mcp

Data & Store

Apify Store: https://apify.com/fruitful_quintessence
Gumroad datasets: https://atushi5.gumroad.com/l/kutuxe

Add this server

Host a copy with our keys and logs.

Server facts

Tools

Questions

How do I install Rakuten Japan?

Does Rakuten Japan need an API key?

What transport does Rakuten Japan use?

When was Rakuten Japan last checked?

Documentation

Rakuten Japan MCP — 楽天市場商品検索・ランキング

🚀 What This Does

🔧 Usage

As an Apify Actor

As an MCP Server

🧹 Official API Details

🧪 Tests & Type Checking

🔒 Pricing (pay-per-event)

MCP Registry

Data & Store