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 分