English Français العربية

io.github.atushi1841/rakuten-japan-mcp

Registre officiel Recherche et web

Search Rakuten Ichiba products and rankings via official Rakuten APIs.

Code source Documentation

Que pouvez-vous faire avec io.github.atushi1841/rakuten-japan-mcp ?

  • 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
  • Product search — IchibaItem/Search official API (keyword search)
  • Ranking — IchibaItem/Ranking official API (what's hot, genre ranking, historical eras)

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).

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

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  1. Rakuten Japan MCP — 楽天市場商品検索・ランキング
  2. 🚀 What This Does
  3. 🔧 Usage
  4. 🧹 Official API Details
  5. 🧪 Tests & Type Checking
  6. 🔒 Pricing (pay-per-event)
  7. MCP Registry
  8. Data & Store

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:

  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

Data & Store

Questions fréquentes

Qu'est-ce que io.github.atushi1841/rakuten-japan-mcp ?

Search Rakuten Ichiba products and rankings via official Rakuten APIs.

Comment installer io.github.atushi1841/rakuten-japan-mcp ?

Suivez les étapes d'installation de sa documentation, affichée sur cette page et dans son dépôt.

Faut-il une clé API pour io.github.atushi1841/rakuten-japan-mcp ?

Son entrée au registre n'indique aucune clé ni secret obligatoire. Certaines fonctions peuvent tout de même demander un compte auprès du service auquel il se connecte.

io.github.atushi1841/rakuten-japan-mcp est-il open source ?

Son code est public sur GitHub, mais le dépôt ne déclare pas de licence standard.

Qui maintient io.github.atushi1841/rakuten-japan-mcp ?

Il est publié par atushi1841. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.