ichiba_item_search returns listings; ichiba_product_search goes through the Item Price Navi catalogue, which groups the same product across sellers and returns its minimum, maximum and average price with the number of shops carrying it — the vendor names it as the way to answer whether a price is fair. Most of the rest is a hierarchy plus a search over it, and the genre and area lookups exist because those searches want codes rather than names: ichiba_genre_search starts at '0', books_genre_search at '000', kobo_genre_search at '101', and travel_get_area_class returns the prefecture, city and district codes the hotel searches expect.
A Rakuten API client with 28 tools spanning Ichiba shopping and its genre tree, Rakuten Books across print, CDs, DVDs, foreign books, magazines, games and software, Rakuten Travel, Rakuten Recipe, Rakuten Kobo and Rakuten GORA golf.
- Ichiba: ichiba_item_search by keyword with a price range, review and price sorting and genre or shop filters, ichiba_item_ranking by genre, period, age and gender, ichiba_product_search over the cross-seller Item Price Navi catalogue with minimum, maximum and average price across sellers, and the ichiba_genre_search and ichiba_tag_search facet lookups.
- Books, one tool per medium: books_total_search across all of them, then books_book_search, books_cd_search, books_dvd_search, books_foreign_book_search, books_magazine_search, books_game_search and books_software_search, with books_genre_search for the hierarchy.
- Travel: travel_simple_hotel_search by area code or coordinates, travel_vacant_hotel_search returning room plans with per-night and total prices and a reserve URL for specific dates, travel_keyword_hotel_search for when the area code is unknown, travel_hotel_detail_search, travel_get_area_class for the code hierarchy, travel_get_hotel_chain_list and travel_hotel_ranking by type.
- Recipes: recipe_category_list over a hierarchy of 43 large, around 540 medium and around 1500 small categories, and recipe_category_ranking with ingredient list, cooking time, cost estimate and the recipe URL.
- Kobo: kobo_ebook_search by keyword, title, author, publisher or genre, and kobo_genre_search from the '101' top level downwards.
- GORA golf: gora_golf_course_search by area, keyword or coordinates, gora_golf_course_detail with hole and par counts, green type, dress code, facilities and base prices, and gora_plan_search for bookable plans on a play date with cart, caddie, lunch and drink inclusions.
Rakuten API credentials, supplied as RAKUTEN_APP_ID and RAKUTEN_ACCESS_KEY.
One command plus a key — npm install -g rakuten-mcp, then supply credentials