Rakuten Mcp

rakuten-mcp

Rakuten Web Service API 用の Model Context Protocol サーバーです。楽天の6つの商品分野（市場、書籍、旅行、レシピ、Kobo、GORA（ゴルフ））にわたる、読み取り専用のツールを27個提供します。

すべてのツールの説明は英語と日本語で提供されています。すべてのエンドポイントは、2026-10-04 に稼働中の楽天 API とそのドキュメントに照らして再検証済みです。

インストール

npm install -g rakuten-mcp

または、必要に応じて npx rakuten-mcp を実行してください。

設定

1. Rakuten Web Service に登録します。
2. アプリケーションを作成します。UUID 形式の Application ID と、pk_ で始まる Access Key が発行されます。
3. 任意：商品リンクを収益化するには、Affiliate ID を登録します。ツールの応答に含まれる商品 URL に Affiliate ID が付与されます。

変数	必須	説明
RAKUTEN_APP_ID	はい	Application ID（新しいプラットフォームでは UUID 形式）
RAKUTEN_ACCESS_KEY	はい	Access Key（pk_ で始まります）
RAKUTEN_AFFILIATE_ID	いいえ	すべての商品 URL に追加する Affiliate ID
RAKUTEN_MAX_RETRIES	いいえ	429 / 5xx エラー時の再試行回数。デフォルトは 3 です。

IP 許可リスト。 楽天アプリでは、呼び出し可能な IP アドレスを制限できます。IP アドレスが変わると（新しいネットワークへの接続、ルーターの再起動など）、すべてのツールが CLIENT_IP_NOT_ALLOWED で失敗します。この場合、サーバーはキーの問題ではなく IP の問題として報告します。webservice.rakuten.co.jp/app/list でアプリの Edit を選択し、修正してください。サーバーや CI ランナーの送信元 IP も許可リストに追加する必要があります。

Claude Desktop

claude_desktop_config.json を編集します。

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

Claude Code

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

Cursor / Cline / Continue

Claude Desktop と同じ JSON 形式を、各クライアントの MCP 設定パスに記述します。

ツール

Ichiba（4）

ツール	機能
ichiba_item_search	楽天市場をキーワード検索します。価格フィルター、並べ替え、ジャンル／ショップによる絞り込みに対応しています。
ichiba_genre_search	ジャンルツリーを参照します。現在のジャンル、親、兄弟、子ジャンルを返します。
ichiba_item_ranking	リアルタイムのベストセラーランキングを取得します。全体、ジャンル別、または年齢／性別別に検索できます（楽天の仕様上、ジャンルと属性情報は組み合わせられません）。
ichiba_product_search	Item Price Navi：複数の販売者が販売する同一商品の最低／最高／平均価格を取得します。

ichiba_tag_search は 1.3.0 で削除されました。楽天が Tag Search エンドポイントを廃止したためです。

Books（9）

自由入力テキストに対応しているのは books_total_search のみです。カテゴリ別ツールは、楽天のエンドポイントが受け付けるタイトル／著者／アーティスト／JAN／ISBN／ジャンルで検索します。

ツール	機能
books_total_search	楽天ブックス全体を対象に、カテゴリ横断で検索します。
books_book_search	タイトル、著者、ISBN、出版社で書籍（紙媒体）を検索します。
books_cd_search	タイトル、アーティスト、レーベル、JAN で音楽 CD を検索します。
books_dvd_search	DVD／Blu-ray を検索します。
books_foreign_book_search	日本語以外の書籍を検索します。翻訳がある場合は japaneseTitle を返します。
books_magazine_search	タイトル、出版社、JAN で雑誌を検索します。
books_game_search	タイトル、ハードウェアプラットフォーム、JAN でビデオゲームを検索します。
books_software_search	タイトル、OS、JAN でコンピューターソフトウェアを検索します。
books_genre_search	ブックスのジャンルツリーを参照します（000 = 最上位）。

旅行（7）

ツール	機能
travel_simple_hotel_search	エリアコードまたは緯度・経度でホテルを検索します。
travel_vacant_hotel_search	指定したチェックイン日／チェックアウト日に空室のあるホテルを検索します。1泊あたりの料金とchargeBasis（per_personまたはper_room）を含むプランを返します。
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_ebook_search	楽天Koboの電子書籍カタログを検索します。タイトル、シリーズ、著者、出版社、言語コード、価格、販売URLを返します。
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の取扱店舗。

アーキテクチャ

モジュール式で、APIファミリーごとにsrc/tools/の下にファイルがあります。StdioとHTTPの両方のトランスポートに対応しています。Config／Auth／IpNotAllowed／RateLimit／Server／NotFound／BadRequest／MalformedResponse／Unknownの9つのクラスで構成される、型付きエラーツリーを備えています。429および5xxに対して、バックオフ付きの再試行を行い、Retry-Afterを秒数とHTTP日時の両方として解析します。アーキテクチャの概要、規約、新しいツールの追加方法についてはAGENTS.mdを参照してください。

安全性

27個のツールはすべて、楽天ウェブサービスAPIに対する読み取り専用のHTTP GETです。ツールがデータを作成、変更、削除することはありません。楽天の利用規約とレート制限が適用されます。返される商品はプロモーション掲載情報です。実際に利用する前に、楽天で価格と在庫状況を確認してください。

免責事項

非公式です。Rakuten Group, Inc.とは提携、推奨、後援の関係にありません。Rakuten、Rakuten Ichiba、Rakuten Books、Rakuten Travel、Rakuten Recipe、Rakuten Kobo、Rakuten GORAは、Rakuten Group, Inc.の商標です。ご自身の責任でご利用ください。

ライセンス

MIT