Rakuten Mcp

io.github.mrslbt由 GitHub 账号 mrslbt 发布v1.3.0更新于 Oct 25, 2026

Rakuten Web Service for AI: Ichiba, Books, Travel, Recipe, Kobo, GORA — bilingual, read-only.

已验证STDIO仅桌面位置与生活商业与电商

概览

AI 生成的概览

非官方 MCP 服务器，提供 27 个只读的乐天 Web 服务工具，覆盖购物、图书、旅行、食谱、Kobo 电子书和高尔夫球场。

可以做什么
搜索乐天市场商品，支持价格筛选、排序和品类/店铺限定。
适用场景
适合需要让助手通过乐天官方 API 查询日本电商商品、图书音像、酒店空房、食谱、Kobo 电子书或高尔夫预约方案的场景，工具说明提供英日双语。
运行要求
通过 npm 本地运行（全局安装或 npx）。需要乐天 Web 服务应用：环境变量 RAKUTEN_APP_ID 和 RAKUTEN_ACCESS_KEY；可选 RAKUTEN_AFFILIATE_ID 和 RAKUTEN_MAX_RETRIES。需访问乐天 API 的网络；若应用启用 IP 白名单，需登记调用方出口 IP。
安装前请注意
需要乐天 API 凭据（RAKUTEN_APP_ID、RAKUTEN_ACCESS_KEY），会保存在客户端配置中。设置 RAKUTEN_AFFILIATE_ID 后，返回的每个商品链接都会附带你的推广 ID。所有工具均为只读 GET，但结果是推广性商品信息，行动前应核实价格与库存。适用乐天服务条款与速率限制；项目为非官方。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Rakuten Mcp，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

rakuten-mcp

[npm version] [npm downloads] [rakuten-mcp MCP server] [MCP Badge] [License: MIT]

A Model Context Protocol server for the Rakuten Web Service API. 27 read-only tools across six Rakuten product families: Ichiba (marketplace), Books, Travel, Recipe, Kobo, and GORA (golf).

Every tool description ships in English and Japanese. Every endpoint was re-verified against the live Rakuten API and its documentation on 2026-10-04.

Install

bash
npm install -g rakuten-mcp

Or npx rakuten-mcp on demand.

Configuration

  1. Register at Rakuten Web Service.
  2. Create an application. You get a UUID Application ID and a pk_-prefixed Access Key.
  3. Optional: register an Affiliate ID to monetize product links. Item URLs in tool responses will carry it.
VariableRequiredDescription
RAKUTEN_APP_IDyesApplication ID (UUID format on the new platform)
RAKUTEN_ACCESS_KEYyesAccess Key (starts with pk_)
RAKUTEN_AFFILIATE_IDnoAffiliate ID appended to every item URL
RAKUTEN_MAX_RETRIESnoRetries on 429 / 5xx. Default 3.

IP allow list. A Rakuten app can restrict which IP addresses may call it. If your IP changes (new network, router restart), every tool fails with CLIENT_IP_NOT_ALLOWED; the server reports this as an IP problem, not a key problem. Fix it under Edit for the app at webservice.rakuten.co.jp/app/list. Servers and CI runners need their egress IP on the list too.

Claude Desktop

Edit claude_desktop_config.json:

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

Claude Code

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

Cursor / Cline / Continue

Same JSON shape as Claude Desktop, under each client's MCP config path.

Tools

Ichiba (4)

ToolWhat it does
ichiba_item_searchKeyword search on Rakuten Ichiba with price filters, sort, genre/shop restrictions.
ichiba_genre_searchBrowse the genre tree. Returns current, ancestors, siblings, and children.
ichiba_item_rankingRealtime bestseller ranking: overall, by genre, or by age / gender (genre and demographics cannot be combined, per Rakuten).
ichiba_product_searchItem Price Navi: same product across multiple sellers with min/max/avg price.

ichiba_tag_search was removed in 1.3.0: Rakuten retired the Tag Search endpoint.

Books (9)

Only books_total_search takes free text. The per-category tools search by title / author / artist / JAN / ISBN / genre, because that is all Rakuten's endpoints accept.

ToolWhat it does
books_total_searchCross-category search across all of Rakuten Books.
books_book_searchPrinted books by title, author, ISBN, publisher.
books_cd_searchMusic CDs by title, artist, label, JAN.
books_dvd_searchDVDs / Blu-ray.
books_foreign_book_searchNon-Japanese books. Returns japaneseTitle when a translation exists.
books_magazine_searchMagazines by title, publisher, JAN.
books_game_searchVideo games by title, hardware platform, JAN.
books_software_searchComputer software by title, OS, JAN.
books_genre_searchBrowse the Books genre tree (000 = top).

Travel (7)

ToolWhat it does
travel_simple_hotel_searchHotels by area code or lat/lon.
travel_vacant_hotel_searchHotels with rooms available on specific check-in / check-out dates. Returns plans with one-night pricing and chargeBasis (per_person or per_room).
travel_hotel_detail_searchFull details for one hotel by hotelNo.
travel_get_area_classThe area-code hierarchy: 日本 → 47 prefectures → cities → districts.
travel_keyword_hotel_searchFree-text hotel search by name / landmark / area.
travel_get_hotel_chain_listAll 307 hotel chains registered on Rakuten Travel.
travel_hotel_rankingTop hotels by ranking genre (all / onsen / ryokan / city / resort / business / pension / publichouse).

Recipe (2)

ToolWhat it does
recipe_category_listThe full Rakuten Recipe category tree (43 large → ~540 medium → ~1500 small). Pass level to fetch one tier.
recipe_category_rankingTop recipes in a category with title, ingredient list, prep time, cost estimate, image, and author.

Kobo (2)

ToolWhat it does
kobo_ebook_searchSearch Rakuten Kobo's eBook catalogue. Returns title, series, author, publisher, language code, price, and sale URL.
kobo_genre_searchBrowse the Kobo genre tree. Top-level is 101 (電子書籍).

GORA (3)

ToolWhat it does
gora_golf_course_searchGolf courses by area code, keyword, or coordinates.
gora_golf_course_detailFull course profile: designer, hole/par, course distance, green type, dress code, facilities, base prices.
gora_plan_searchReservation plans on a specific play date. Returns per-plan prices, cart/caddie/lunch inclusions, player-count constraints.

Example queries

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

Architecture

Modular: one file per API family under src/tools/. Stdio and HTTP transports both supported. Typed error tree with 9 classes covering Config / Auth / IpNotAllowed / RateLimit / Server / NotFound / BadRequest / MalformedResponse / Unknown. Retry-with-backoff on 429 and 5xx, parses Retry-After as both seconds and HTTP-date. See AGENTS.md for the architecture brief, conventions, and how to add a new tool.

Safety

All 27 tools are read-only HTTP GETs against the Rakuten Web Service API. No tool creates, modifies, or deletes anything. Rakuten's terms of service and rate limits apply. Returned items are promotional listings — verify prices and availability on Rakuten before acting on them.

Disclaimer

Unofficial. Not affiliated with, endorsed by, or sponsored by Rakuten Group, Inc. Rakuten, Rakuten Ichiba, Rakuten Books, Rakuten Travel, Rakuten Recipe, Rakuten Kobo, and Rakuten GORA are trademarks of Rakuten Group, Inc. Use at your own risk.

License

MIT

来源：README.md，提交 412410a

工具

0
SourceWeft 尚未在沙箱中启动过该软件包，因此其工具未知。

版本历史

2
  1. v1.3.0最新Oct 4, 2026
  2. v1.2.2Sep 16, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手；SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分