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. 라쿠텐 웹 서비스에 로그인한 후 + New App을 클릭합니다.

  2. 유형으로 Web Application을 선택하고, Allowed Websites에 github.com(및 Origin 헤더를 보낼 다른 도메인)을 설정한 다음, 필요한 API 범위(Ichiba, Books, Travel)를 체크합니다.

  3. 앱 대시보드에서 Application ID(UUID)와 Access Key를 복사합니다.

변수

필수 여부

설명

RAKUTEN_APP_ID

예

애플리케이션 ID (UUID 형식)

RAKUTEN_ACCESS_KEY

예

액세스 키 (pk_...)

RAKUTEN_ORIGIN

아니오

모든 요청과 함께 전송되는 Origin/Referer 헤더입니다. 기본값은 https://github.com입니다. 앱에 구성한 Allowed Websites 중 하나와 일치해야 합니다.

참고: 라쿠텐은 2026년에 API 플랫폼을 이전했습니다. 이전 형식의 숫자형 애플리케이션 ID는 더 이상 작동하지 않습니다. 2026년 이전의 숫자형 앱 ID를 가지고 있다면, 이 서버에 필요한 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-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 QPS) 제한을 적용합니다. 실제로는 대화형 MCP 사용량과 일치하지만, 빠르게 연속적인 배치 호출을 수행하면 HTTP 429 응답을 받을 수 있습니다. API가 반환하는 상품 및 랭킹은 프로모션 성격일 수 있으므로, 결과를 보증이 아닌 제안으로 취급하고 행동하기 전에 라쿠텐 사이트에서 가격과 가용성을 확인하십시오.

면책 조항

이것은 커뮤니티에서 구축한 비공식 MCP 서버입니다. Rakuten Group, Inc.와 제휴, 보증 또는 후원 관계가 아닙니다. Rakuten, Rakuten Ichiba, Rakuten Books 및 Rakuten Travel은 Rakuten Group, Inc.의 상표입니다. 사용자의 책임하에 사용하십시오. 작성자는 오용, 프롬프트 인젝션 또는 버그로 인해 발생하는 문제에 대해 어떠한 책임도 지지 않습니다.

라이선스

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

    ActivityNo data
    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