@mrslbt
基本信息
MCP server for the Rakuten Web Service API. 28 read-only tools across Ichiba (e-commerce), Books, Travel, Recipe, Kobo, and GORA (golf). Bilingual EN/JA tool descriptions.
使用下面的配置,将此服务器添加到你的 MCP 客户端。
{
"mcpServers": {
"rakuten": {
"command": "npx",
"args": [
"rakuten-mcp"
]
}
}
}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を含む商品一覧をページング形式で返します。
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を渡すと祖先・兄弟・直下の子ジャンルを取得します。商品検索を特定カテゴリに絞り込んだり、カテゴリ構造を発見するのに使えます。
Look up details for a specific Rakuten Ichiba tag by tag ID. Tags are facet-style attributes (size, color, etc.) attached to items. Returns the tag group this tag belongs to, the tag name, and any parent tag. Tag IDs surface in ichiba_item_search item responses (each item carries an attributeIds array) and in ichiba_genre_search. [JA] 特定のタグIDの詳細を取得します。タグはファセット属性(サイズ、色など)で商品に紐づいています。タグ名、所属タググループ、親タグを返します。タグIDは ichiba_item_search の各商品 attributeIds や ichiba_genre_search から取得できます。
Get the Rakuten Ichiba bestseller ranking — overall or filtered by genre, time period, age, and gender demographic. Returns ranked items with their rank, price, review stats, and purchase URL. Use ichiba_genre_search to find specific genre IDs. [JA] 楽天市場の売れ筋ランキングを取得します。総合または、ジャンル/集計期間/年代/性別で絞り込み可能。順位、価格、レビュー、購入URLを含むランキング一覧を返します。ジャンルIDの検索には ichiba_genre_search を使用してください。
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 でブランド絞り込みも可能。
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 などを使用してください。
Search Rakuten Books for printed books by title, author, ISBN, publisher, or free-text keyword. Returns book details including ISBN, author, publisher, series, table of contents, preview URL, list price, and review stats. Pass at least one search field. [JA] 楽天ブックスで紙の書籍を、書名・著者・ISBN・出版社・キーワードで検索します。ISBN、著者、出版社、シリーズ、目次、立ち読みURL、定価、レビューを含む書籍詳細を返します。検索条件は少なくとも1つ必須。
Search Rakuten Books for music CDs by title, artist, label, or JAN code. Returns album/single details including artist, label, JAN, track list, list price, and review stats. [JA] 楽天ブックスで音楽CDを、タイトル・アーティスト・レーベル・JANで検索します。アーティスト、レーベル、JAN、収録曲、定価、レビューを含む詳細を返します。
Search Rakuten Books for DVDs and Blu-ray discs by title, performer, label, or JAN. Returns title details with performer, label, JAN, list price, and review stats. [JA] 楽天ブックスでDVD・Blu-rayを、タイトル・出演者・レーベル・JANで検索します。出演者、レーベル、JAN、定価、レビューを含む詳細を返します。
Search Rakuten Books for foreign-language (non-Japanese) books by title, author, ISBN, or publisher. Returns book details plus a Japanese-translated title field when available. [JA] 楽天ブックスで洋書を、タイトル・著者・ISBN・出版社で検索します。書籍詳細に加え、邦題が存在する場合は japaneseTitle を返します。
Search Rakuten Books for magazines by title, publisher, or JAN. Returns issue details including publisher, JAN, publication cycle, preview URL, and review stats. [JA] 楽天ブックスで雑誌を、タイトル・出版社・JANで検索します。出版社、JAN、発行サイクル、立ち読みURL、レビューを含む詳細を返します。
Search Rakuten Books for video games by title, platform/hardware (e.g., 'Nintendo Switch', 'PlayStation 5'), or JAN. Returns title details with hardware, label, JAN, list price, and review stats. [JA] 楽天ブックスでビデオゲームを、タイトル・ハード(例: 'Nintendo Switch', 'PlayStation 5')・JANで検索します。ハード、レーベル、JAN、定価、レビューを含む詳細を返します。
Search Rakuten Books for computer software by title, target OS (e.g., 'Windows', 'macOS'), or JAN. Returns software details with target OS, label, JAN, list price, and review stats. [JA] 楽天ブックスでPCソフトウェアを、タイトル・対応OS(例: 'Windows', 'macOS')・JANで検索します。対応OS、レーベル、JAN、定価、レビューを含む詳細を返します。
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を渡すと親ジャンルと直下の子ジャンルを取得します。検索の絞り込みに利用できます。
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 で取得できます。
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, price per night, total price, with-breakfast flag, reserve URL). Same area-code or lat/lon parameters as travel_simple_hotel_search. [JA] 指定のチェックイン/チェックアウト日に空室がある楽天トラベルのホテルを検索します。各ホテルと利用可能なプラン(プラン名、1泊あたりの価格、合計金額、朝食有無、予約URL)を返します。エリア/座標パラメータは travel_simple_hotel_search と同じ。
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 形式で、評価軸(サービス/立地/部屋など)や詳細情報も含めて返します。
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 等としてホテル検索ツールに渡してください。
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] 楽天トラベルのホテルをフリーキーワード(ホテル名、エリア名、ランドマーク)で検索します。エリアコードが分からないときに有用です。
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等)とコードを返します。
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を返します。
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 が付与されます。
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 で取得。
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つ以上必須。
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 の絞り込みに利用してください。
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 を使用してください。
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、平日/休日の基準最安値を返します。
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、プレイヤー数、予算で絞り込み可能。
The Rakuten Mcp server is a Model Context Protocol (MCP) server for the Rakuten Web Service API. It exposes 28 read-only tools across six Rakuten product families: Ichiba (marketplace), Books, Travel, Recipe, Kobo, and GORA (golf). Every tool description is available in English and Japanese. It is designed for developers who want to integrate Rakuten data—product search, hotel availability, recipe rankings, and more—into MCP-compatible clients like Claude Desktop, Claude Code, Cursor, and others.
Install the package globally with npm install -g rakuten-mcp or run on demand with npx rakuten-mcp. You must set the environment variables RAKUTEN_APP_ID and RAKUTEN_ACCESS_KEY, obtained from the Rakuten Web Service developer portal. Optionally, set RAKUTEN_AFFILIATE_ID to append affiliate codes to returned URLs and RAKUTEN_MAX_RETRIES (default 3). Add the server to your MCP client’s configuration (e.g., claude_desktop_config.json) using the command npx -y rakuten-mcp and the required environment variables.
You must obtain a Rakuten Application ID (UUID format) and an Access Key (starts with `pk_`) from the Rakuten Web Service developer portal. These are set as environment variables `RAKUTEN_APP_ID` and `RAKUTEN_ACCESS_KEY`.
Yes, all 28 tools perform read-only HTTP GET requests against the Rakuten Web Service API. No tool creates, modifies, or deletes any data.
Yes. If you set the optional `RAKUTEN_AFFILIATE_ID` environment variable, it will be appended to every item URL returned by the tools.
The server supports both stdio (the default for MCP) and HTTP transport.
No. This is an unofficial third‑party server not affiliated with, endorsed by, or sponsored by Rakuten Group, Inc. Use at your own risk.
Handl speaks the Model Context Protocol. Your whole billing operation — projects, invoices, clients, reports, approvals — as tools any AI assistant can call, inside your autonomy rules.
DeepMark helps teachers deliver rapid, consistent marking with meaningful feedback for every student — in a fraction of the time. What once took a week, now takes one free period.
Free moving quotes for AI agents from Next Generation Movers, a licensed interstate mover (USDOT 3764697). US long-distance nationwide and local DC/MD/VA. Indicative ballpark price and booking options; optional $0.01 x40
A one-of-a-kind resume builder that keeps your privacy in mind. Completely secure, customizable, portable, open-source and free forever. Try it out today!
A good sequence diagram can solve almost any communication problem in engineering. Volley lets your agent write them as plain text, with the real request and response payloads on every arrow. It checks its own syntax wi
评论