Rakuten Japan Mcp

io.github.atushi1841由 GitHub 帳號 atushi1841 發布v0.1.0更新於 Oct 24, 2026

Search Rakuten Ichiba products and rankings via official Rakuten APIs.

已驗證STDIO僅桌面網頁搜尋與抓取商業與電商

概覽

AI 產生的概覽

透過樂天官方 API 搜尋樂天市場商品並取得目前排行榜，回傳結構化 JSON 資料。

可以做什麼
封裝樂天市場官方的商品搜尋與排行榜 API，並提供給 MCP 用戶端使用。search_rakuten 工具執行關鍵字商品搜尋，回傳標題、價格、連結、店鋪、評論與圖片資訊。search_rakuten_ranking 工具回傳依類別、男性或女性，或歷史時期的目前排行榜。get_actor_info 工具列出可用工具與定價。
適用情境
適合需要即時日本電商商品或排行榜資料的情境，例如比價、依關鍵字尋找商品，或查看樂天某類別的熱門商品。主要用於商品研究與購物相關查詢，而非一般網頁搜尋。
執行需求
以本機 stdio 程序在使用者電腦上執行。搜尋需要 RAKUTEN_APP_ID 與 RAKUTEN_ACCESS_KEY 憑證；排行榜只需 RAKUTEN_APP_ID。需要連線至樂天官方 API 的網路存取。README 亦說明了使用密鑰環境變數的 Apify actor 部署方式。
安裝前請注意
伺服器需要 RAKUTEN_APP_ID 與 RAKUTEN_ACCESS_KEY 憑證才能呼叫樂天 API。README 列出依事件計價的費用：每次搜尋 $0.001、每次排行榜 $0.001，使用可能產生費用。商品查詢會傳送至樂天官方 API。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Rakuten Japan Mcp，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

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

來源：README.md，提交 f1150e0

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包，因此其工具未知。

版本歷史

1
  1. v0.1.0最新Oct 13, 2026

評分

已滿足適用檢查項的 40%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分

    請在儲存庫或註冊中心條目中宣告授權條款。