Rakuten Japan Mcp

io.github.atushi1841Published by GitHub account atushi1841v0.1.0Updated Oct 24, 2026

Search Rakuten Ichiba products and rankings via official Rakuten APIs.

VerifiedSTDIODesktop onlyWeb Search & ScrapingBusiness & Commerce

Overview

AI-generated overview

Searches Rakuten Ichiba products and fetches current rankings through official Rakuten APIs, returning structured JSON.

What you can do
Wraps the official Rakuten Ichiba product search and ranking APIs and exposes them to MCP clients. The search_rakuten tool performs keyword product search and returns title, price, URL, shop, review, and image data. The search_rakuten_ranking tool returns current rankings by genre, male, or female, or for a historical era. A get_actor_info tool lists available tools and pricing.
When to use it
Useful when an assistant needs live Japanese e-commerce product or ranking data, such as comparing prices, finding items by keyword, or checking what is popular in a Rakuten genre. It is meant for product research and shopping-related queries rather than general web search.
Requirements
Runs as a local stdio process on the user's machine. Search requires the RAKUTEN_APP_ID and RAKUTEN_ACCESS_KEY credentials; ranking requires only RAKUTEN_APP_ID. Network access to the official Rakuten APIs is needed. The README also describes an Apify actor deployment with secret environment variables.
Before you install
The server needs the RAKUTEN_APP_ID and RAKUTEN_ACCESS_KEY credentials to call the Rakuten APIs. The README lists pay-per-event pricing of $0.001 per search and $0.001 per ranking, so usage may incur charges. Product queries are sent to Rakuten's official APIs.

Installation

In SourceWeft

  1. Open Rakuten Japan Mcp in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

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

bash
python -m pytest tests/ -vpython -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

Source: README.md at commit f1150e0

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.1.0LatestOct 13, 2026

Score

40% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

    Declare a license in the repository or the registry entry.