Back to Browse

Rakuten Japan MCP Server

Developer ToolsUse Caution4.6MCP RegistryLocal
Free

Server data from the Official MCP Registry

Search Rakuten Ichiba products and rankings via official Rakuten APIs.

About

Search Rakuten Ichiba products and rankings via official Rakuten APIs.

Security Report

4.6
Use Caution4.6High Risk

The server is a straightforward wrapper around the official Rakuten Ichiba search and ranking APIs, with credentials read from environment variables and no data sent to unexpected destinations. The main concerns are the spoofed Origin/Referer headers, the MCP HTTP endpoint listening on 0.0.0.0 without its own authentication, and the access key being passed as a URL query parameter, which can leak into logs. None of these are severe, and the permissions match the server's purpose. Supply chain analysis found 5 known vulnerabilities in dependencies (1 critical, 3 high severity).

7 files analyzed · 11 issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

HTTP Network Access

Connects to external APIs or services over the internet.

network_listen

Check that this permission is expected for this type of plugin.

env_vars

Check that this permission is expected for this type of plugin.

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "io-github-atushi1841-rakuten-japan-mcp": {
      "args": [
        "-y",
        "github:atushi1841/rakuten-japan-mcp"
      ],
      "command": "npx"
    }
  }
}

Documentation

View on GitHub

From the project's GitHub README.

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.

Apify Store


🚀 What This Does

This actor wraps the official Rakuten APIs and makes them available two ways:

  1. A traditional Apify actor — run it from the Apify Console, API, or schedule
  2. 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:

ParameterTypeDefaultDescription
rankingbooleanfalseSet true to fetch ranking instead of search
genreIdinteger—Restrict to genre (e.g. 101269=本・雑誌, 101347=おもちゃ)
rankingTypeselectitemitem, male, or female
erastring—Past-ranking era YYYYMMDD (e.g. 20190601)
maxResultsint30Max 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

Reviews

No reviews yet

Be the first to review this server!