{"id":47275390,"url":"https://github.com/jackchuka/hpp","last_synced_at":"2026-04-02T19:20:46.192Z","repository":{"id":340809239,"uuid":"1167711780","full_name":"jackchuka/hpp","owner":"jackchuka","description":"CLI tool for searching Japanese restaurants using the HotPepper Gourmet API","archived":false,"fork":false,"pushed_at":"2026-03-30T14:22:14.000Z","size":33,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-03-30T16:28:22.581Z","etag":null,"topics":["cli","gourmet","restaurant"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jackchuka.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-02-26T15:46:26.000Z","updated_at":"2026-03-30T14:22:43.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/jackchuka/hpp","commit_stats":null,"previous_names":["jackchuka/hpp"],"tags_count":4,"template":false,"template_full_name":null,"purl":"pkg:github/jackchuka/hpp","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jackchuka%2Fhpp","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jackchuka%2Fhpp/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jackchuka%2Fhpp/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jackchuka%2Fhpp/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jackchuka","download_url":"https://codeload.github.com/jackchuka/hpp/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jackchuka%2Fhpp/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31314375,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-02T12:59:32.332Z","status":"ssl_error","status_checked_at":"2026-04-02T12:54:48.875Z","response_time":89,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cli","gourmet","restaurant"],"created_at":"2026-03-15T16:59:18.031Z","updated_at":"2026-04-02T19:20:46.188Z","avatar_url":"https://github.com/jackchuka.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# hpp\n\nCLI tool for searching Japanese restaurants using the [HotPepper Gourmet API](https://webservice.recruit.co.jp/doc/hotpepper/reference.html).\n\n## Install\n\n### Homebrew\n\n```bash\nbrew install jackchuka/tap/hpp\n```\n\n### Go\n\n```bash\ngo install github.com/jackchuka/hpp@latest\n```\n\n### Agent Skill\n\nThis repository includes a [Claude Code](https://docs.anthropic.com/en/docs/claude-code) skill. Install the skill to search restaurants with natural language:\n\n```bash\nnpx skills add jackchuka/hpp\n```\n\n## Setup\n\nGet a free API key from [Recruit Web Service](https://webservice.recruit.co.jp/register/) and set it:\n\n```bash\nexport HOTPEPPER_API_KEY=your_key_here\n```\n\n## Usage\n\n### Claude Code (natural language)\n\nUse `/restaurant-search` or just ask in conversation:\n\n```\n\u003e find an izakaya near 浜松町 for 6 people with private rooms\n\u003e ramen spots near Shibuya under 1500 yen\n\u003e dinner for 10 in 新宿 with all-you-can-drink\n```\n\n### Search restaurants\n\n```bash\n# Keyword search\nhpp search --keyword \"ramen\" --area Z011\n\n# Location search (lat/lng + range)\nhpp search --lat 35.6812 --lng 139.7671 --range 3\n\n# Filter by features\nhpp search --keyword \"izakaya\" --wifi --private-room --english --non-smoking\n\n# All-you-can-drink spots with lunch in Shinjuku\nhpp search --keyword \"新宿\" --free-drink --lunch\n\n# JSON output\nhpp search --keyword \"sushi\" --format json\n\n# Pagination\nhpp search --keyword \"ramen\" --count 20 --start 1\n```\n\n### Search by shop name or phone\n\n```bash\nhpp shop --keyword \"居酒屋\"\nhpp shop --tel 0312345678\n```\n\n### Browse genres\n\n```bash\nhpp genre\nhpp genre --keyword ramen\n```\n\n### Browse areas\n\n```bash\n# Large areas (prefectures/regions)\nhpp area large\nhpp area large --keyword tokyo\n\n# Middle areas within a large area\nhpp area middle --large-area Z011\n\n# Small areas within a middle area\nhpp area small --middle-area Y005\n```\n\n### Browse service areas\n\n```bash\nhpp service-area large\nhpp service-area list\n```\n\n### Browse budgets\n\n```bash\nhpp budget\n```\n\n### Browse credit card types\n\n```bash\nhpp creditcard\n```\n\n### Browse specials/features\n\n```bash\nhpp special list\nhpp special list --category SPC0\nhpp special category\n```\n\n### Version\n\n```bash\nhpp version\n```\n\n### Global flags\n\n| Flag | Description | Default |\n|------|-------------|---------|\n| `--format` | Output format: `table` or `json` | `json` |\n\n## Search flags\n\n| Flag | Description |\n|------|-------------|\n| `--keyword` | Free text search |\n| `--name` | Shop name (partial match) |\n| `--lat`, `--lng`, `--range` | Location search (range: 1=300m, 2=500m, 3=1km, 4=2km, 5=3km) |\n| `--area` | Large area codes |\n| `--middle-area` | Middle area codes |\n| `--genre` | Genre codes |\n| `--budget` | Budget codes |\n| `--wifi` | Has WiFi |\n| `--lunch` | Lunch service |\n| `--english` | English menu |\n| `--private-room` | Has private rooms |\n| `--non-smoking` | Non-smoking seats |\n| `--parking` | Has parking |\n| `--pet` | Pet allowed |\n| `--free-drink` | All-you-can-drink |\n| `--free-food` | All-you-can-eat |\n| `--midnight` | Open after 11pm |\n| `--card` | Accepts cards |\n| `--count` | Results per page (max 100) |\n| `--order` | Sort: 1=name, 2=genre, 3=area, 4=recommended |\n\nRun `hpp search --help` for the full list of 50+ flags.\n\n## API Coverage\n\nAll 12 HotPepper API endpoints are supported:\n\n| Endpoint | Command |\n|----------|---------|\n| Gourmet Search | `hpp search` |\n| Shop Name Search | `hpp shop` |\n| Genre Master | `hpp genre` |\n| Budget Master | `hpp budget` |\n| Large Area Master | `hpp area large` |\n| Middle Area Master | `hpp area middle` |\n| Small Area Master | `hpp area small` |\n| Large Service Area | `hpp service-area large` |\n| Service Area | `hpp service-area list` |\n| Credit Card Master | `hpp creditcard` |\n| Special Master | `hpp special list` |\n| Special Category | `hpp special category` |\n\n## License\n\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjackchuka%2Fhpp","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjackchuka%2Fhpp","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjackchuka%2Fhpp/lists"}