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 分

    请在仓库或注册中心条目中声明许可证。