rakuten-mcp

rakuten-mcp

Un servidor de Protocolo de Contexto de Modelo (MCP) para la API de Servicios Web de Rakuten. 28 herramientas de solo lectura en seis familias de productos de Rakuten: Ichiba (mercado), Books, Travel, Recipe, Kobo y GORA (golf).

Cada descripción de herramienta se incluye en inglés y japonés. Cada endpoint fue verificado contra la API en vivo de Rakuten el 2026-06-04 antes de su publicación.

Instalación

npm install -g rakuten-mcp

O npx rakuten-mcp bajo demanda.

Configuración

1. Regístrate en Rakuten Web Service.
2. Crea una aplicación. Obtienes un ID de aplicación UUID y una clave de acceso con prefijo pk_.
3. Opcional: registra un ID de afiliado para monetizar enlaces de productos. Las URL de artículos en las respuestas de las herramientas lo incluirán.

Variable	Requerida	Descripción
RAKUTEN_APP_ID	sí	ID de aplicación (formato UUID en la nueva plataforma)
RAKUTEN_ACCESS_KEY	sí	Clave de acceso (comienza con pk_)
RAKUTEN_AFFILIATE_ID	no	ID de afiliado añadido a cada URL de artículo
RAKUTEN_MAX_RETRIES	no	Reintentos en 429 / 5xx. Predeterminado: 3.

Claude Desktop

Edita claude_desktop_config.json:

{
  "mcpServers": {
    "rakuten": {
      "command": "npx",
      "args": ["-y", "rakuten-mcp"],
      "env": {
        "RAKUTEN_APP_ID": "your-app-id",
        "RAKUTEN_ACCESS_KEY": "your-access-key"
      }
    }
  }
}

Claude Code

claude mcp add rakuten -e RAKUTEN_APP_ID=... -e RAKUTEN_ACCESS_KEY=... -- npx -y rakuten-mcp

Cursor / Cline / Continue

Misma estructura JSON que Claude Desktop, en la ruta de configuración MCP de cada cliente.

Herramientas

Ichiba (5)

Herramienta	Qué hace
ichiba_item_search	Búsqueda por palabras clave en Rakuten Ichiba con filtros de precio, orden, restricciones de género/tienda.
ichiba_genre_search	Explora el árbol de géneros. Devuelve el actual, ancestros, hermanos e hijos.
ichiba_tag_search	Consulta una etiqueta específica por ID. Devuelve el grupo de etiquetas y el nombre.
ichiba_item_ranking	Ranking de más vendidos, general o por género / período / edad / sexo.
ichiba_product_search	Item Price Navi: mismo producto en varios vendedores con precio mínimo/máximo/promedio.

Books (9)

Herramienta	Qué hace
books_total_search	Búsqueda entre categorías en todos los Rakuten Books.
books_book_search	Libros impresos por título, autor, ISBN, editorial.
books_cd_search	CDs de música por título, artista, sello, JAN.
books_dvd_search	DVDs / Blu-ray.
books_foreign_book_search	Libros no japoneses. Devuelve japaneseTitle cuando existe una traducción.
books_magazine_search	Revistas por título, editorial, JAN.
books_game_search	Videojuegos por título, plataforma de hardware, JAN.
books_software_search	Software de computadora por título, sistema operativo, JAN.
books_genre_search	Explora el árbol de géneros de Books (000 = superior).

Travel (7)

Herramienta	Qué hace
travel_simple_hotel_search	Hoteles por código de área o lat/lon.
travel_vacant_hotel_search	Hoteles con habitaciones disponibles en fechas específicas de entrada/salida. Devuelve planes con precios por noche y total.
travel_hotel_detail_search	Detalles completos de un hotel por hotelNo.
travel_get_area_class	La jerarquía de códigos de área: 日本 → 47 prefecturas → ciudades → distritos.
travel_keyword_hotel_search	Búsqueda de hoteles por texto libre: nombre / punto de referencia / área.
travel_get_hotel_chain_list	Las 307 cadenas hoteleras registradas en Rakuten Travel.
travel_hotel_ranking	Mejores hoteles por género de ranking (todos / onsen / ryokan / ciudad / resort / negocio / pensión / casa pública).

Recipe (2)

Herramienta	Qué hace
recipe_category_list	El árbol completo de categorías de Rakuten Recipe (43 grandes → ~540 medianas → ~1500 pequeñas). Pasa level para obtener un nivel.
recipe_category_ranking	Recetas principales en una categoría con título, lista de ingredientes, tiempo de preparación, costo estimado, imagen y autor.

Kobo (2)

Herramienta	Qué hace
kobo_ebook_search	Busca en el catálogo de eBooks de Rakuten Kobo. Devuelve título, serie, autor, editorial, código de idioma, precio y URL de venta.
kobo_genre_search	Explora el árbol de géneros de Kobo. El nivel superior es 101 (電子書籍).

GORA (3)

Herramienta	Qué hace
gora_golf_course_search	Campos de golf por código de área, palabra clave o coordenadas.
gora_golf_course_detail	Perfil completo del campo: diseñador, hoyos/par, distancia del campo, tipo de green, código de vestimenta, instalaciones, precios base.
gora_plan_search	Planes de reserva en una fecha de juego específica. Devuelve precios por plan, inclusiones de carrito/caddie/almuerzo, restricciones de número de jugadores.

Consultas de ejemplo

楽天で1万円以下のワイヤレスイヤホンを探して。レビュー4以上。
村上春樹の楽天Kobo電子書籍を新着順で。
東京駅近くのホテル、7月1〜2日、2名で1泊1万5千円以下の空室。
今週末東京近郊のゴルフ場で安いプランは？
楽天レシピで人気の鶏胸肉料理を5件、材料と所要時間込みで。
JANコード 4988601009447 のCDの取扱店舗。

Arquitectura

Modular: un archivo por familia de API en src/tools/. Se admiten transportes Stdio y HTTP. Árbol de errores tipado con 8 clases que cubren Config / Auth / RateLimit / Server / NotFound / BadRequest / MalformedResponse / Unknown. Reintento con retroceso en 429 y 5xx, analiza Retry-After tanto en segundos como en fecha HTTP. Consulta AGENTS.md para el resumen de arquitectura, convenciones y cómo añadir una nueva herramienta.

Seguridad

Las 28 herramientas son GET HTTP de solo lectura contra la API de Servicios Web de Rakuten. Ninguna herramienta crea, modifica o elimina nada. Se aplican los términos de servicio y los límites de tasa de Rakuten. Los artículos devueltos son listados promocionales: verifica precios y disponibilidad en Rakuten antes de actuar sobre ellos.

Aviso legal

No oficial. No afiliado, respaldado ni patrocinado por Rakuten Group, Inc. Rakuten, Rakuten Ichiba, Rakuten Books, Rakuten Travel, Rakuten Recipe, Rakuten Kobo y Rakuten GORA son marcas comerciales de Rakuten Group, Inc. Úsalo bajo tu propio riesgo.

Licencia

MIT