rakuten-mcp
rakuten-mcp
Сервер Model Context Protocol для Rakuten Web Service API. Охватывает Rakuten Ichiba (маркетплейс), Rakuten Books и Rakuten Travel.
Установка
npm install -g rakuten-mcpИли запустите по требованию с помощью npx rakuten-mcp.
Related MCP server: xendit-mcp
Конфигурация
Войдите в Rakuten Web Service и нажмите + New App.
Выберите тип Web Application, установите Allowed Websites на
github.com(и любой другой домен, с которого вы будете отправлять заголовокOrigin), и отметьте нужные области API (Ichiba, Books, Travel).Скопируйте Application ID (UUID) и Access Key из панели управления приложением.
Переменная | Обязательно | Описание |
| да | Идентификатор приложения (формат UUID) |
| да | Ключ доступа ( |
| нет | Заголовок Origin/Referer, отправляемый с каждым запросом. По умолчанию |
Примечание: В 2026 году Rakuten перевела свою API-платформу на новую версию. Числовые идентификаторы приложений старого формата больше не работают. Если у вас есть числовой ID приложения, созданный до 2026 года, вам необходимо зарегистрировать новое приложение, чтобы получить пару UUID + Access Key, требуемую этим сервером.
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-mcpCursor
Добавьте в ~/.cursor/mcp.json с той же структурой, что и для Claude Desktop.
Инструменты
Инструмент | Описание |
| Полнотекстовый поиск товаров с фильтрами по цене, сортировкой и пагинацией. |
| Рейтинги бестселлеров, общие или по категориям. |
| Просмотр иерархии категорий товаров. |
| Поиск в Rakuten Books по названию, автору или ISBN. |
| Поиск отелей на Rakuten Travel по ключевым словам. |
| Поиск свободных номеров с фильтрами по дате, цене и местоположению. |
Промпты
Промпт | Описание |
| Поиск товаров с дополнительными фильтрами по цене. |
| Сравнение товаров, отсортированных по отзывам или цене. |
| Рейтинг бестселлеров для категории. |
| Поиск отелей, доступных на определенные даты. |
| Поиск отелей в рамках бюджета. |
| Поиск книги по названию, автору или ISBN. |
| Поиск всех книг автора. |
Ресурсы
Ресурс | URI | Описание |
Поддерживаемые жанры |
| Категории товаров верхнего уровня Rakuten Ichiba. |
Примеры запросов
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 Rakuten Web Service. Ни один инструмент не создает, не изменяет и не удаляет ресурсы. Rakuten ограничивает частоту запросов примерно до 1 запроса в секунду на ID приложения; на практике это соответствует обычному использованию MCP, но при частых пакетных вызовах вы можете получить ответ HTTP 429. Товары и рейтинги, возвращаемые API, могут быть рекламными; воспринимайте результаты как рекомендации, а не как одобрение, и проверяйте цены и наличие на сайте Rakuten перед принятием решений.
Отказ от ответственности
Это неофициальный MCP-сервер, созданный сообществом. Он не связан, не одобрен и не спонсируется Rakuten Group, Inc. Rakuten, Rakuten Ichiba, Rakuten Books и Rakuten Travel являются товарными знаками Rakuten Group, Inc. Используйте на свой страх и риск. Автор не несет ответственности за проблемы, возникшие в результате неправильного использования, промпт-инъекций или ошибок.
Лицензия
Available Tools
27 toolsbooks_book_searchSearch Rakuten Books (Printed Books)ARead-onlyIdempotent
Search Rakuten Books for printed books by title, author, ISBN, publisher, or genre (at least one; no free-text keyword, use books_total_search for that). Returns book details including ISBN, author, publisher, series, table of contents, preview URL, list price, and review stats.
[JA] 楽天ブックスで紙の書籍を、書名・著者・ISBN・出版社・ジャンルで検索します(いずれか必須。フリーワード検索は books_total_search)。ISBN、著者、出版社、シリーズ、目次、立ち読みURL、定価、レビューを含む書籍詳細を返します。
Inputs: hits, isbn, page, sort, +4 more.
books_cd_searchSearch Rakuten Books (CDs / Music)ARead-onlyIdempotent
Search Rakuten Books for music CDs by title, artist, label, or JAN code (at least one; no free-text keyword, use books_total_search for that). Returns album/single details including artist, label, JAN, track list, list price, and review stats.
[JA] 楽天ブックスで音楽CDを、タイトル・アーティスト・レーベル・JANで検索します(いずれか必須。フリーワード検索は books_total_search)。アーティスト、レーベル、JAN、収録曲、定価、レビューを含む詳細を返します。
Inputs: jan, hits, page, sort, +4 more.
books_dvd_searchSearch Rakuten Books (DVDs / Blu-ray)ARead-onlyIdempotent
Search Rakuten Books for DVDs and Blu-ray discs by title, performer, label, or JAN (at least one; no free-text keyword, use books_total_search for that). Returns title details with performer, label, JAN, list price, and review stats.
[JA] 楽天ブックスでDVD・Blu-rayを、タイトル・出演者・レーベル・JANで検索します(いずれか必須。フリーワード検索は books_total_search)。出演者、レーベル、JAN、定価、レビューを含む詳細を返します。
Inputs: jan, hits, page, sort, +4 more.
books_foreign_book_searchSearch Rakuten Books (Foreign-Language Books)ARead-onlyIdempotent
Search Rakuten Books for foreign-language (non-Japanese) books by title, author, ISBN, or publisher (at least one; no free-text keyword, use books_total_search for that). Returns book details plus a Japanese-translated title field when available.
[JA] 楽天ブックスで洋書を、タイトル・著者・ISBN・出版社で検索します(いずれか必須。フリーワード検索は books_total_search)。書籍詳細に加え、邦題が存在する場合は japaneseTitle を返します。
Inputs: hits, isbn, page, sort, +4 more.
books_game_searchSearch Rakuten Books (Video Games)ARead-onlyIdempotent
Search Rakuten Books for video games by title, platform/hardware (e.g., 'Nintendo Switch', 'PlayStation 5'), or JAN (at least one; no free-text keyword, use books_total_search for that). Returns title details with hardware, label, JAN, list price, and review stats.
[JA] 楽天ブックスでビデオゲームを、タイトル・ハード(例: 'Nintendo Switch', 'PlayStation 5')・JANで検索します(いずれか必須。フリーワード検索は books_total_search)。ハード、レーベル、JAN、定価、レビューを含む詳細を返します。
Inputs: jan, hits, page, sort, +3 more.
books_genre_searchBrowse Rakuten Books GenresARead-onlyIdempotent
Browse the Rakuten Books genre (category) hierarchy. Pass '000' to list top-level genres, or a specific 3-character genre ID to fetch its parents and direct children. Useful for narrowing book searches to a specific category.
[JA] 楽天ブックスのジャンル(カテゴリ)階層を参照します。'000' を渡すとトップレベル、特定の3文字ジャンルIDを渡すと親ジャンルと直下の子ジャンルを取得します。検索の絞り込みに利用できます。
Inputs: booksGenreId.
books_magazine_searchSearch Rakuten Books (Magazines)ARead-onlyIdempotent
Search Rakuten Books for magazines by title, publisher, or JAN (at least one; no free-text keyword, use books_total_search for that). Returns issue details including publisher, JAN, publication cycle, preview URL, and review stats.
[JA] 楽天ブックスで雑誌を、タイトル・出版社・JANで検索します(いずれか必須。フリーワード検索は books_total_search)。出版社、JAN、発行サイクル、立ち読みURL、レビューを含む詳細を返します。
Inputs: jan, hits, page, sort, +3 more.
books_software_searchSearch Rakuten Books (Computer Software)ARead-onlyIdempotent
Search Rakuten Books for computer software by title, target OS (e.g., 'Windows', 'macOS'), or JAN (at least one; no free-text keyword, use books_total_search for that). Returns software details with target OS, label, JAN, list price, and review stats.
[JA] 楽天ブックスでPCソフトウェアを、タイトル・対応OS(例: 'Windows', 'macOS')・JANで検索します(いずれか必須。フリーワード検索は books_total_search)。対応OS、レーベル、JAN、定価、レビューを含む詳細を返します。
Inputs: os, jan, hits, page, +3 more.
books_total_searchSearch Rakuten Books (All Categories)ARead-onlyIdempotent
Cross-category search across Rakuten Books — books, CDs, DVDs, video games, software, magazines, and foreign-language books. Use this when you don't know which category contains the target item. For category-specific results with category-specific fields, use the books_book_search / books_cd_search / etc. tools.
[JA] 楽天ブックス(本、CD、DVD、ゲーム、ソフトウェア、雑誌、洋書)を横断検索します。カテゴリが不明な検索に使用してください。カテゴリ固有のフィールドが必要な場合は books_book_search / books_cd_search などを使用してください。
Inputs: keyword (required), hits, page, sort, +1 more.
gora_golf_course_detailGet Rakuten GORA Golf Course DetailARead-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).
gora_golf_course_searchSearch Rakuten GORA Golf CoursesARead-onlyIdempotent
Search Rakuten GORA golf courses by area code, keyword, or coordinates. Returns each course with name, address, nearest highway IC, distance from IC, evaluation score, image URL, and a direct reservation calendar URL. Use gora_golf_course_detail for full information including plans, course layout, and facilities.
[JA] 楽天GORAのゴルフ場を、エリアコード/キーワード/座標で検索します。コース名、住所、最寄りIC、IC距離、評価、画像、予約カレンダーURLを返します。プラン詳細やコースレイアウト等の全情報は gora_golf_course_detail を使用してください。
Inputs: hits, page, keyword, areaCode, +3 more.
gora_plan_searchSearch Rakuten GORA Reservation PlansARead-onlyIdempotent
Search Rakuten GORA for available reservation plans on a specific play date. Returns each golf course together with its available plans (plan name, price per player, base price, cart/caddie/lunch/drink inclusions, start time zone, points). Filter by area code, specific golfCourseId, player count, or budget cap. Use this to compare options across courses before reserving.
[JA] 指定のプレー日における楽天GORAの予約可能プランを検索します。各ゴルフ場と利用可能プラン(プラン名、1人あたりの価格、基準価格、カート/キャディ/昼食/ドリンクの付帯、スタート時間帯、ポイント)を返します。エリアコード、ゴルフ場ID、プレイヤー数、予算で絞り込み可能。
Inputs: playDate (required), hits, page, budget, +3 more.
ichiba_genre_searchBrowse Rakuten Ichiba GenresARead-onlyIdempotent
Browse the Rakuten Ichiba genre (category) hierarchy. Pass '0' to list top-level genres, or a specific genre ID to fetch its ancestors, siblings, and direct children. Useful for narrowing item searches to a specific category, or for discovering what categories exist.
[JA] 楽天市場のジャンル(カテゴリ)階層を参照します。'0' を渡すとトップレベル、特定のジャンルIDを渡すと祖先・兄弟・直下の子ジャンルを取得します。商品検索を特定カテゴリに絞り込んだり、カテゴリ構造を発見するのに使えます。
Inputs: genre_id.
ichiba_item_rankingGet Rakuten Ichiba Bestseller RankingARead-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.
ichiba_item_searchSearch Rakuten Ichiba ProductsARead-onlyIdempotent
Search products on Rakuten Ichiba (Japan's largest e-commerce marketplace) by keyword. Supports price range filtering, sorting by review count/average/price, and restricting results to a specific genre or shop. Returns a paginated list of items with prices, review stats, images, and direct purchase URLs.
[JA] 楽天市場(日本最大のEコマースモール)で商品をキーワード検索します。価格範囲フィルタ、レビュー数/平均/価格による並び替え、ジャンルや店舗での絞り込みに対応。価格、レビュー、画像、購入URLを含む商品一覧をページング形式で返します。
Inputs: keyword (required), hits, page, sort, +4 more.
ichiba_product_searchSearch Rakuten Ichiba Products (Cross-Seller, with Min/Max Pricing)ARead-onlyIdempotent
Search Rakuten's Item Price Navi — cross-seller product catalogue that groups identical products across multiple shops. Returns each product with its min/max/average price across all sellers and the total number of shops carrying it. Use this (instead of ichiba_item_search) when you want to compare prices for a specific product or answer 'is this a fair price?'. Filter by maker_code to restrict to a brand.
[JA] 楽天市場の商品価格ナビを検索します。同一商品を複数店舗にまたがって集約し、最安値/最高値/平均価格と取扱店舗数を返します。特定商品の価格比較や「妥当な価格か?」を判断する用途では、ichiba_item_search ではなくこちらを使用してください。maker_code でブランド絞り込みも可能。
Inputs: hits, page, sort, keyword, +3 more.
kobo_ebook_searchSearch Rakuten Kobo eBooksARead-onlyIdempotent
Search Rakuten Kobo's eBook catalogue by keyword, title, author, publisher, or genre. Returns eBook details with title, series, author, publisher, price, sale URL, language code, image URL, and review stats. Pass at least one search field.
[JA] 楽天Kobo電子書籍カタログを、キーワード/タイトル/著者/出版社/ジャンルで検索します。タイトル、シリーズ、著者、出版社、価格、購入URL、言語、画像、レビューを含む書籍詳細を返します。検索条件は1つ以上必須。
Inputs: hits, page, sort, title, +4 more.
kobo_genre_searchBrowse Rakuten Kobo GenresARead-onlyIdempotent
Browse the Rakuten Kobo eBook genre hierarchy. Top-level is '101' (電子書籍). Pass a child genre ID returned by this tool to drill down. Returns the current genre, its ancestors, and its direct children — useful for narrowing kobo_ebook_search results.
[JA] 楽天Koboのジャンル階層を参照します。最上位は '101'(電子書籍)。子IDを渡して掘り下げ可能。現在のジャンル、祖先、子ジャンルを返します。kobo_ebook_search の絞り込みに利用してください。
Inputs: koboGenreId.
recipe_category_listList Rakuten Recipe CategoriesARead-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 RankingARead-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 ClassificationARead-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 ChainsARead-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_detail_searchGet Rakuten Travel Hotel DetailsARead-onlyIdempotent
Fetch detailed information for a specific Rakuten Travel hotel by its hotelNo. Returns the same Hotel shape as search endpoints but with the per-axis ratings and detail fields populated.
[JA] 特定の楽天トラベルホテルの詳細情報を hotelNo で取得します。検索系と同じ Hotel 形式で、評価軸(サービス/立地/部屋など)や詳細情報も含めて返します。
Inputs: hotelNo (required).
travel_hotel_rankingGet Rakuten Travel Hotel RankingARead-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.
travel_keyword_hotel_searchSearch Rakuten Travel Hotels (by Keyword)ARead-onlyIdempotent
Search Rakuten Travel hotels by free-text keyword (hotel name, area name, landmark). Returns the same Hotel shape as travel_simple_hotel_search. Useful when you don't know the area code.
[JA] 楽天トラベルのホテルをフリーキーワード(ホテル名、エリア名、ランドマーク)で検索します。エリアコードが分からないときに有用です。
Inputs: keyword (required), hits, page.
travel_simple_hotel_searchSearch Rakuten Travel Hotels (by Area)ARead-onlyIdempotent
Search Rakuten Travel hotels by area code (japan → prefecture → city → district) or by latitude/longitude coordinates. Returns hotel summaries with prices, addresses, review stats, and ratings. Use travel_get_area_class to discover area codes.
[JA] 楽天トラベルのホテルをエリアコード階層(日本→都道府県→市区町村→詳細)、または緯度経度で検索します。価格、住所、レビュー、評価を含むホテル一覧を返します。エリアコードは travel_get_area_class で取得できます。
Inputs: hits, page, latitude, longitude, +5 more.
travel_vacant_hotel_searchSearch Rakuten Travel Hotels (Available on Dates)ARead-onlyIdempotent
Search Rakuten Travel for hotels with rooms available on specific check-in/check-out dates. Returns each hotel together with its available room plans (plan name, one-night price, one-night total, chargeBasis per_person/per_room, with-breakfast flag, reserve URL). Prices are for a single night, not the whole stay. Same area-code or lat/lon parameters as travel_simple_hotel_search.
[JA] 指定のチェックイン/チェックアウト日に空室がある楽天トラベルのホテルを検索します。各ホテルと利用可能なプラン(プラン名、1泊の料金、1泊の合計、chargeBasis(1人あたり/1室あたり)、朝食有無、予約URL)を返します。料金は1泊分で滞在合計ではありません。エリア/座標パラメータは travel_simple_hotel_search と同じ。
Inputs: checkinDate (required), checkoutDate (required), hits, page, +9 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 27 tools
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.
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.
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.
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
Related MCP Connectors
MCP server for real-time product search by barcode (EAN, UPC, GTIN) or keyword on ean-search.org
Unified MCP server for 70+ eCommerce platforms: products, orders, customers, and more.
Amazon product API & MCP server: search, prices, ratings, sellers, deals, and ASIN lookup by Canopy.
An MCP server that exposes functionalities to use Zomato's services.
Related MCP Servers
- AlicenseAqualityCmaintenanceExtract YouTube transcripts for AI agents, RAG pipelines, and LLM workflows. Supports any YouTube URL. Returns clean text or timestamped segments. No API keys required.14MIT
- AlicenseAqualityCmaintenanceMCP server for Xendit payment APIs. Invoices, disbursements, balance checks, and bank transfers across Southeast Asia.6103 npm4MIT
- AlicenseNot gradedqualityDmaintenanceA 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.24 npmMIT
- AlicenseAqualityDmaintenanceAn 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.51MIT