Skip to main content
Glama

rakuten-mcp

npm version npm downloads rakuten-mcp MCP server MCP Badge License: MIT

楽天ウェブサービスAPI用のModel Context Protocolサーバーです。楽天市場、楽天ブックス、楽天トラベルをカバーしています。

インストール

npm install -g rakuten-mcp

または npx rakuten-mcp でオンデマンド実行してください。

Related MCP server: xendit-mcp

設定

  1. 楽天ウェブサービスにサインインし、+ アプリID発行をクリックします。

  2. タイプとしてWebアプリを選択し、許可されたウェブサイトに github.com(および Origin ヘッダーを送信するその他のドメイン)を設定し、必要なAPIスコープ(楽天市場、ブックス、トラベル)にチェックを入れます。

  3. アプリダッシュボードからアプリID(UUID)とアクセスキーをコピーします。

変数

必須

説明

RAKUTEN_APP_ID

はい

アプリID (UUID形式)

RAKUTEN_ACCESS_KEY

はい

アクセスキー (pk_...)

RAKUTEN_ORIGIN

いいえ

すべてのリクエストで送信されるOrigin/Refererヘッダー。デフォルトは https://github.com です。アプリで設定した許可されたウェブサイトのいずれかと一致する必要があります。

注意: 楽天は2026年にAPIプラットフォームを移行しました。旧形式の数値アプリIDは機能しません。2026年以前の数値アプリIDをお持ちの場合は、新しいアプリを登録して、このサーバーが必要とするUUIDとアクセスキーのペアを取得する必要があります。

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

Claude Desktopと同じ形式で ~/.cursor/mcp.json に追加します。

ツール

ツール

説明

search_products

価格フィルター、並べ替え、ページネーションを備えた商品全文検索。

get_genre_ranking

全体またはカテゴリ別のベストセラーランキング。

search_genres

商品カテゴリ階層の閲覧。

search_books

タイトル、著者、またはISBNによる楽天ブックスの検索。

search_travel

キーワードによる楽天トラベルのホテル検索。

search_travel_vacancy

日付、価格、場所のフィルターを使用した空室検索。

プロンプト

プロンプト

説明

search_products

オプションの価格フィルターを使用して商品を検索します。

compare_products

レビューや価格で並べ替えて商品を比較します。

category_bestsellers

カテゴリ別のベストセラーランキング。

find_hotel

特定の日程で利用可能なホテルを探します。

budget_hotel

予算内のホテルを探します。

find_book

タイトル、著者、またはISBNで書籍を検索します。

books_by_author

著者によるすべての書籍を探します。

リソース

リソース

URI

説明

サポートされているジャンル

rakuten://genres

楽天市場のトップレベル商品カテゴリ。

クエリ例

Find wireless earphones under ¥10,000 with good reviews.
楽天で1万円以下のワイヤレスイヤホンを探して。

What are the top sellers on Rakuten right now?
楽天の今の売れ筋ランキングを見せて。

Search for hotels in Kyoto on Rakuten Travel.
楽天トラベルで京都のホテルを探して。

Find available rooms near Tokyo Station for April 15-17 under ¥15,000.
東京駅近くで4月15〜17日、1万5千円以下の空室を探して。

Find books by Haruki Murakami on Rakuten Books.
村上春樹の本を楽天ブックスで探して。

安全性

このサーバーのすべてのツールは、楽天ウェブサービスAPIに対する読み取り専用の検索です。リソースを作成、変更、削除するツールはありません。楽天はアプリIDごとに1秒あたり約1リクエスト(1 QPS)のレート制限を設けています。実用上はMCPの対話的な使用には十分ですが、短時間に連続してバッチ呼び出しを行うとHTTP 429エラーが返されます。APIから返される商品やランキングにはプロモーションが含まれる場合があります。結果は推奨事項として扱い、行動を起こす前に楽天のサイトで価格や在庫状況を確認してください。

免責事項

これはコミュニティによって構築された非公式のMCPサーバーです。楽天グループ株式会社とは提携、推奨、後援を受けていません。楽天、楽天市場、楽天ブックス、楽天トラベルは楽天グループ株式会社の商標です。自己責任でご利用ください。著者は、誤用、プロンプトインジェクション、またはバグに起因する問題について一切の責任を負いません。

ライセンス

MIT

Available Tools

27 tools
gora_golf_course_detailGet Rakuten GORA Golf Course DetailA
Read-onlyIdempotent

Get full details for a Rakuten GORA golf course by ID — postal address, phone, designer, hole/par count, course distance, green type, dress code, practice/lodging/meal facilities, credit card acceptance, layout map URL, and weekday/holiday base prices. Use this after gora_golf_course_search to drill into a specific course.

[JA] 楽天GORAのゴルフ場詳細をIDで取得します。郵便番号、電話、設計者、ホール数、パー数、コース距離、グリーン種別、ドレスコード、練習場/宿泊/食事/クレジットカード可否、レイアウトURL、平日/休日の基準最安値を返します。

Inputs: golfCourseId (required).

ichiba_item_rankingGet Rakuten Ichiba Bestseller RankingA
Read-onlyIdempotent

Get the Rakuten Ichiba realtime bestseller ranking: overall, for one genre, or for an age/gender demographic. Genre and demographic filters are mutually exclusive (Rakuten restriction). Returns ranked items with their rank, price, review stats, and purchase URL. Use ichiba_genre_search to find genre IDs.

[JA] 楽天市場のリアルタイム売れ筋ランキングを取得します。総合、ジャンル別、または年代/性別で絞り込み可能。ジャンルと年代/性別は併用できません(楽天の仕様)。順位、価格、レビュー、購入URLを含むランキング一覧を返します。ジャンルIDの検索には ichiba_genre_search を使用してください。

Inputs: age, sex, page, genre_id.

recipe_category_listList Rakuten Recipe CategoriesA
Read-onlyIdempotent

Get the full Rakuten Recipe category hierarchy (43 large → ~540 medium → ~1500 small categories). Each category has a categoryId, name, and URL on recipe.rakuten.co.jp. Use 'large' depth when you only need the top-level menu (much smaller payload). Medium and small categories include parentCategoryId for tree assembly.

[JA] 楽天レシピのカテゴリ階層(43大カテゴリ→約540中カテゴリ→約1500小カテゴリ)を取得します。各カテゴリにID、名前、recipe.rakuten.co.jp のURLが付きます。トップレベルだけ必要な場合は 'large' を指定(ペイロード大幅小)。中・小には parentCategoryId が付与されます。

Inputs: level.

recipe_category_rankingGet Rakuten Recipe Category RankingA
Read-onlyIdempotent

Get the top recipes in a Rakuten Recipe category. Returns ranked recipes with title, ingredient list, cooking time (indication), cost estimate, image URLs, author nickname, and a direct URL to recipe.rakuten.co.jp. Use recipe_category_list to find category IDs.

[JA] 指定カテゴリの楽天レシピ人気ランキングを取得します。順位、タイトル、材料一覧、調理時間目安、費用目安、画像、投稿者ニックネーム、レシピURLを返します。カテゴリIDは recipe_category_list で取得。

Inputs: categoryId (required).

travel_get_area_classGet Rakuten Travel Area ClassificationA
Read-onlyIdempotent

Get the full Rakuten Travel area-code hierarchy: Japan → prefecture (middle) → city (small) → district (detail). Use the returned codes as largeClassCode/middleClassCode/etc. in the hotel search tools.

[JA] 楽天トラベルのエリアコード階層を取得します(日本→都道府県→市区町村→詳細)。返されたコードを largeClassCode/middleClassCode 等としてホテル検索ツールに渡してください。

Inputs: no named parameters.

travel_get_hotel_chain_listGet Rakuten Travel Hotel ChainsA
Read-onlyIdempotent

List all Rakuten Travel hotel chains (Marriott, APA, Hilton, Toyoko Inn, etc.) with their codes. Useful for filtering or grouping search results by chain.

[JA] 楽天トラベルに登録されている全ホテルチェーン(マリオット、APA、ヒルトン、東横INN等)とコードを返します。

Inputs: no named parameters.

travel_hotel_rankingGet Rakuten Travel Hotel RankingA
Read-onlyIdempotent

Get the top-ranked hotels on Rakuten Travel, overall or by ranking genre (onsen, ryokan, city, resort, businesshotel, pension, publichouse). Returns ranked hotels with rank, name, area, review stats, and information URLs.

[JA] 楽天トラベルのホテルランキングを取得します。'all'(総合)、または温泉/旅館/シティ/リゾート/ビジネス/ペンション/公共の宿でタイプ別に絞り込めます。順位、ホテル名、エリア、レビュー、URLを返します。

Inputs: genre.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.2/5.0

    Scored across 27 tools

    Disambiguation5/5

    Each tool targets a distinct service and resource-action combination (e.g., books_book_search vs books_cd_search, travel_simple_hotel_search vs travel_keyword_hotel_search). Overlaps like books_total_search vs category-specific searches and ichiba_item_search vs ichiba_product_search are explicitly differentiated in descriptions, leaving no real ambiguity.

    Naming Consistency4/5

    Names follow a consistent service_resource_action pattern in snake_case (books_, gora_, ichiba_, travel_, recipe_, kobo_). Minor deviation: two travel tools use a get_ verb prefix (travel_get_area_class, travel_get_hotel_chain_list) while others use trailing action nouns like _search, _detail, or _ranking.

    Tool Count4/5

    27 tools is above the typical 3–15 range, but the server aggregates six distinct Rakuten services (Books, Ichiba, Travel, Recipe, Kobo, GORA), each with multiple endpoints. Each tool maps to a unique operation, so the count is justified despite being slightly heavy.

    Completeness4/5

    Most services have thorough coverage: Books offers total and category-specific searches, Travel has multiple search modes plus detail/area/chain/ranking tools, and Ichiba includes search, genre, ranking, and price comparison. Notable gaps: Recipe only has category listing and ranking (no keyword or ingredient search), and Ichiba lacks a dedicated shop search tool.

    Maintenance

    ActivitySlowing
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      C
      maintenance
      Extract YouTube transcripts for AI agents, RAG pipelines, and LLM workflows. Supports any YouTube URL. Returns clean text or timestamped segments. No API keys required.
      1
      4
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      A MCP server for Walmart Marketplace and Affiliate APIs, enabling sellers to manage items, inventory, prices, and orders, and consumers to search, lookup products, reviews, and store locations.
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      An MCP server for Rakuten Ichiba that enhances product search with quantity parsing, unit price calculation, and shipping cost analysis, enabling cost-effective bulk purchasing decisions.
      5
      1
      MIT