内容
乐天MCP
[](https.com/package/rakcp)
[
[](https://glama.ai/mcp/servers/mrslbt/rakuten-mcp)
[](https://lob/mrslbtuten-mcp)
[](LICENSE)
一个适用于 [乐天网络服务 API](https://webservice.rakuten.co.jp/) 的模型上下文协议（MCP）服务器。 涵盖乐天六大产品系列的28种只读乐天市场（Ichiba）、书籍、旅行、食Kobo 和 GORA（高尔夫）。
所有工具描述均以英文和日文提供。点均在 2026-06-04 在线验证通过乐天 API。
## 安装
```bash
npm install -g-mcp
```
或按需使用 `npx rakuten-mcp`。
## 配置
1. 在 [乐天网络服务://webservice.rakuten/) 注册。
2. 创建一个应用程序。您将获得一个应用程序 ID 和一个以 `pk_` 开头的访问密钥。
3. 可选：注册联盟 ID 以实现产品链接的货币化响应中的商品 URL 将携带此 ID。
| 变量 | 必需 | 描述 |
|---|---|---|
| `RAKUTEN_APP_ID` | 是 | 应用程序 ID（新平台上的 UUID 格式） |
| `RAKUTEN_ACCESS_KEY` | 是 | 访问以 `pk_` 开头） |
| `RAKUTFFILIATE_ID` | 否 | 附加到每个商品联盟 ID |
| `RAKUTEN_MAX_RETRIES` | 否 | 429 / 5xx 重试。默认 3。 |
### 克劳德桌面
编辑 `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 }
}
}
}
```
### 克劳德```bash
claude mcp add rakuten -e RAKUTEN_APP_ID=... -e RAKUTEN_ACCESS_KEY -- npx -y rakuten-mcp
```
### 光标 / 克莱恩 / 继续
与克劳德桌面相同的结构，位于每个客户端的 MCP 配置路径下。
## ### 乐天市场（5）
| 工具 | 功能 |
|---|---|
| `ichiba_item_search` | 乐天市场的关键词搜索，支持价格筛选、排序、类别/店铺 |
| `ichiba_genre_search` | 浏览类别树。返回当前、祖先、兄弟和子类别。 |
| `ichiba_tag_search` | 按 ID 查找特定标签。返回标签组和名称。 |
| `ichiba_item_ranking` | 畅销书排行榜，整体或按类别/时间段/年龄/性别。 |
| `ichiba_product_search` | 商品价格导航：同一商品在多个卖家处的最低/最高/平均价格。 |
### 书籍（9）
| 工具 | 功能 |
|---|---|
| `books_total_search` | 跨类别搜索整个乐天图书。 |
| `books_book_search` | 按标题、作者、ISBN、出版社搜索印刷书籍。 |
| `books_cd_search` | 按标题、艺术家、标签、JAN 搜索音乐 CD。 |
| `books_dvd_search` | DVD / 蓝光。 |
| `books_foreign_book_search` | 非日语书籍。如果有译本，则返回日语标题。 |
| `books_magazine_search` | 按标题、出版社、JAN 搜索杂志。 |
| `books_game_search` | 按标题、硬件平台、JAN 搜索电子游戏。 |
| `books_software_search` | 按标题、操作系统、JAN 搜索计算机软件。 |
| `books_genre_search` | 浏览图书类别树（`000` = 顶级）。 |
### 旅行（7）
| 工具 | 功能 |
|---|---|
travel_simple_hotel_search 按地区代码或经纬度搜索酒店。 |
| `travel_vacant_hotel_search` | 搜索特定入住/退房日期的可用酒店房间。返回每晚和总费用。 |
| `travel_hotel_detail_search` | 按 `hotelNo` 获取一家酒店的完整详情。 |
| `travel_get_area_class` | 地区代码层次结构：日本 → 47 个都道府县 → 城市 → 区。 |
| `travel_keyword_hotel_search` | 按名称/地标/地区进行自由文本酒店搜索。 |
| `travel_get_hotel_chain_list` | 乐天旅行上注册的所有 307 家酒店连锁。 |
| `travel_hotel_ranking` | 按排名类别（全部/温泉/旅馆/城市/度假村/商务/养老院/公共房屋）获取顶级酒店。 |
### 食谱（2）
| 工具 | 功能 |
|---|---|
| `recipe_category_list` | 完整的乐天食谱类别树（43 个大类别 → 约 540 个中类别 → 约 1500 个小类别）。传递 `level` 以获取一层。 |
| `recipe_category_ranking` | 某个类别中的顶级食谱，包含标题、配料列表、准备时间、成本估算、图片和作者。 |
### Kobo（2）
工具 | 功能 |
|---|---|
| `kobo_e` | 搜索乐天 Kobo 的电子书目录。返回标题、系列、作者、出版社、语言代码、价格和销售网址。 |
| `kobo_genre_search` | 浏览 Kobo 类别树。顶级类别为 `101`（电子书）。 |
### GORA（3）
| 工具 | 功能 |
|---|---|
| `gora_golf_course_search` | 按地区代码、关键词或坐标搜索高尔夫球场。 |
| `gora_golf_course_detail` | 完整的高尔夫球场资料：设计师、球洞/杆数、球场距离、果岭类型、着装规定、设施、基准价格。 |
| `gora_plan_search` | 特定比赛日期的预订计划。返回每计划价格、购物车/球童/餐饮包含情况、玩家人数限制。 |
## 示例查询
```
在乐天上搜索价格低于1万元的无线耳机。评论超过4分。
按新发布顺序查找村上春树的乐天Kobo电子书。
7月1-2日，2人入住东京站附近的酒店，1晚1.5万元以下的空房。
本周末东京周边最便宜的高尔夫球场计划？
乐天食谱中5种热门的鸡胸肉料理，包含材料和所需时间。
JAN码4988601009447的CD销售店铺。
```
## 架构
模块化：`src/tools/` 下每个 API 系列一个文件。支持标准输入输出和 HTTP 传输。具有 8 个类别的输入错误树，涵盖配置/身份验证/速率限制/服务器/未找到/错误请求/响应错误/未知。对 429 和 5xx 进行重试和退避，解析 `Retry-After` 为秒和 HTTP 日期。参见 `AGENTS.md` 了解架构简介、约定和如何添加新工具。
## 安全
所有 28 个工具都是针对乐天网络服务 API 的只读 HTTP GET 请求。没有任何工具创建、修改或删除任何内容。乐天的 [服务条款](https://webservice.rakuten.co.jp/documentation/) 和速率限制适用。返回的商品是促销列表 - 在采取行动前请在乐天上验证价格和可用性。
## 免责声明
非官方。未得到乐天集团株式会社的任何关联、认可或赞助。乐天、乐天市场、乐天图书、乐天旅行、乐天食谱、乐天Kobo 和乐天GORA 是乐天集团株式会社的商标。风险自负。
## 许可证
[MIT](LICENSE)
