gurume-cli

Search Japanese restaurants by area and cuisine via the gurume CLI.

7|2|Updated Aug 21, 2025
One-click install
npx skills add https://github.com/narumiruna/gurume --skill gurume-cli
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gurume-cli
Source: https://github.com/narumiruna/gurume/tree/main/.codex/skills/gurume-cli
Command: npx skills add https://github.com/narumiruna/gurume --skill gurume-cli

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Discover Japanese restaurant options quickly by area and cuisine using a CLI, eliminating the time spent guessing and cross-referencing multiple sources. It provides a consistent, machine-friendly and human-readable format that can be consumed by AI agents or used directly by users.

Core Features & Use Cases

  • Area & cuisine search: Query by area (Tokyo, Osaka, Kyoto, 三重, etc.) and cuisine (ラーメン, 寿司, 焼肉, 居酒屋) via the gurume CLI.
  • Structured results: Returns machine-readable envelopes or human-friendly tables suitable for agents and end users.
  • Cuisine mapping & area specificity: Maps user input to Tabelog's cuisine codes and respects precise area signals to avoid broad results.

Quick Start

Ask gurume-cli to search Tokyo ramen and return the top 5 results in JSON.

Frequently Asked Questions about gurume-cli

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I search for Japanese restaurants by area and cuisine using a CLI?

To search for Japanese restaurants by area and cuisine, use the gurume CLI to query specific locations like Tokyo and cuisines like ramen. It maps your input to Tabelog's cuisine codes and returns structured results for AI agents or human consumption.

Can I get restaurant search results in a structured JSON format?

Yes, you can get restaurant search results in a structured JSON format. The gurume CLI outputs machine-readable JSON envelopes when requested, making the data suitable for direct consumption by AI assistants or downstream applications.

What is the best way to find local restaurants in specific Japanese prefectures?

The best way to find local restaurants in specific Japanese prefectures is to use a CLI that respects precise area signals. The gurume CLI supports searches across areas like Tokyo, Osaka, Kyoto, and Mie, preventing overly broad results.

Does the gurume CLI support custom keyword searches for dining spots?

Yes, the gurume CLI supports targeted keyword searches for dining spots alongside area and cuisine filtering. You can pass specific keywords to narrow down restaurant options and return the top results in your preferred format.

Why does my restaurant search return overly broad results across multiple regions?

Restaurant searches return overly broad results when the area signals are not precise or mapped correctly. The gurume CLI avoids this by respecting precise area input and mapping cuisine names to specific Tabelog codes for accurate filtering.

How do I map user-input cuisine names to Tabelog cuisine codes?

To map user-input cuisine names to Tabelog cuisine codes, the gurume CLI uses a references list for cuisine-name mappings. This allows it to translate standard queries like sushi or yakiniku into the correct internal codes.