用途:gurume 是 Tabelog(日本大型餐厅点评网站)的 CLI 封装,用于搜索日本餐厅,避免凭记忆猜测或自行抓取网页,数据较新且结构化。适用于用户提到日本地名(东京、大阪、涩谷、京都站、三重等)、日本菜系(拉面、寿司、鳗鱼、烧肉、居酒屋等),或询问日本餐厅推荐、旅行餐饮规划时。不适用于非日本餐厅、菜谱、外卖应用或一般美食知识。
主要能力:支持按地区、菜系、关键词搜索,可指定排序方式(ranking 默认、review-count、new-open)和结果数量,并输出 JSON。JSON 包含 status、items、meta、applied_filters、warnings 及结构化错误字段。另有 list-cuisines 列出支持的菜系,tui 与 mcp 为交互界面和 MCP 服务,供用户自行运行。
使用方式:菜系名需用日语传入(如 ラーメン 而非 ramen),完整列表见 references/cuisines.md。地区尽量用日语(東京、大阪、渋谷、京都、三重),越具体越好。若请求不在固定菜系列表内(如 tonkotsu ramen、omakase sushi),去掉 --cuisine,把细节放入 --keyword。默认调用示例:gurume search --area <area> [--cuisine <jp-cuisine>] [--keyword <jp-keyword>] --sort ranking --limit 10 --output json。--limit 10 通常足够,需要长列表再增至 20 以上。
结果处理:若 status 为 error,应展示 error.message 与 error.suggested_action,不要编造餐厅。否则逐条汇总名称(保留日文名)、菜系/地区、评分与评论数、一行备注及 Tabelog 链接。出现 warnings 时需在回答中说明。同时使用 --area 与 --keyword 时,先看 meta.area_filter_confidence;低、缺失或不可用均视为低置信度,除非结果 URL 能证明地区。若用户要大阪而结果含非 /osaka/ URL,应说明返回了混合地区结果,只保留明确大阪的链接或询问是否要更宽泛的关键词列表。
限制:上游为 Tabelog HTML,偶有编码异常或字段缺失,汇总时需容错。CLI 需要联网,失败时应向用户报错而非虚构餐厅。--area 与 --keyword 组合可能较宽泛,需用 URL 证据判断是否属于目标地区。回复语言应与用户一致。