🍜 Gurume

Gurume is a Python library, CLI, TUI, and MCP server for discovering Japanese restaurants on Tabelog.

Search by area, cuisine, date, and party size; parse structured detail pages; and plug the same workflows into AI assistants via a FastMCP server.

Quick Links

• TUI Usage
• API Reference
• GitHub Repository
• PyPI

Installation

uv add gurume
# or
pip install gurume

Features

• 🔍 Search restaurants by area, keyword, cuisine, date, time, and party size
• 🍣 Filter by 29 supported Japanese cuisine categories with stable Tabelog genre codes
• 📄 Parse restaurant detail pages into structured review, menu, and course data
• ⚡ Synchronous and asynchronous Python APIs
• 🖥️ Interactive TUI with area suggestions, keyword suggestions, and cuisine auto-detection
• 🤖 MCP server with schema-first inputs and structured outputs for AI assistant integrations
• 🔒 MCP responses backed by Pydantic models and Python APIs type-annotated

See the full README on GitHub for examples.