hpp

hpp

CLI tool for searching Japanese restaurants using the HotPepper Gourmet API.

Install

Homebrew

brew install jackchuka/tap/hpp

Go

go install github.com/jackchuka/hpp@latest

Agent Skill

This repository includes a Claude Code skill. Install the skill to search restaurants with natural language:

npx skills add jackchuka/hpp

Setup

Get a free API key from Recruit Web Service and set it:

export HOTPEPPER_API_KEY=your_key_here

Usage

Claude Code (natural language)

Use /restaurant-search or just ask in conversation:

> find an izakaya near 浜松町 for 6 people with private rooms
> ramen spots near Shibuya under 1500 yen
> dinner for 10 in 新宿 with all-you-can-drink

Search restaurants

# Keyword search
hpp search --keyword "ramen" --area Z011

# Location search (lat/lng + range)
hpp search --lat 35.6812 --lng 139.7671 --range 3

# Filter by features
hpp search --keyword "izakaya" --wifi --private-room --english --non-smoking

# All-you-can-drink spots with lunch in Shinjuku
hpp search --keyword "新宿" --free-drink --lunch

# JSON output
hpp search --keyword "sushi" --format json

# Pagination
hpp search --keyword "ramen" --count 20 --start 1

Search by shop name or phone

hpp shop --keyword "居酒屋"
hpp shop --tel 0312345678

Browse genres

hpp genre
hpp genre --keyword ramen

Browse areas

# Large areas (prefectures/regions)
hpp area large
hpp area large --keyword tokyo

# Middle areas within a large area
hpp area middle --large-area Z011

# Small areas within a middle area
hpp area small --middle-area Y005

Browse service areas

hpp service-area large
hpp service-area list

Browse budgets

hpp budget

Browse credit card types

hpp creditcard

Browse specials/features

hpp special list
hpp special list --category SPC0
hpp special category

Version

hpp version

Global flags

Search flags

Run hpp search --help for the full list of 50+ flags.

API Coverage

All 12 HotPepper API endpoints are supported:

License

MIT