店店通·餐饮开关店与竞对分析

问题：餐饮门店网络分析缺少可靠数据

餐饮品牌的扩张、收缩与竞品布局分析，常常陷入两个误区：要么依赖媒体报道和网页传闻，把未经证实的信息当作门店事实；要么用通用模型常识替代真实数据，导致区域判断失真。当你需要回答「某品牌最近在哪个城市扩张」「竞对门店是净增还是净减」这类问题时，缺少一套有明确口径、可追溯快照的数据通道，结论就站不住脚。

工作方式：先查目录，再取聚合，最后按需核查

这个技能的核心逻辑是以已发布快照为唯一事实来源，按三层递进调用接口：

• 品牌目录门禁：先调用 /v1/network/brands 确认精确品牌名、覆盖期与 capabilities。目录返回的 capabilities 是强制门禁——没有 network 能力就不做网络变化分析，没有 regions 就不做地区拆分，没有 store_location 就不比较位置画像。
• 聚合优先：优先用 profile、direction、summary、trend、regions 或 compare 获取聚合事实。开关店方向、区域收缩与扩张、多品牌共同窗口比较，都能在聚合层回答，不需要拉门店明细。
• 按需核查明细：只有用户明确问到具体门店、地址或候选点时，才调用受限的 events、stores、nearby、sales-shortlist、site-screen 或 store-compare。

输出遵循固定结构：结论 → 3–6 个关键指标 → 覆盖期与口径 → 少量明细 → 未覆盖项，不展示品牌 ID、门店内部键、版本 UUID 等技术字段。

边界与注意点

几个容易踩的坑需要留意：

• 受限预览不是导出接口：/nearby、/stores、/events 默认只返回 10 条、最多 20 条，仅接受 page=1。当响应标记 preview.truncated=true 时，需收窄关键词或地区条件重查，而非自动翻页或拆地区枚举。
• 口径不等于官方公告：开店观察日期取 collection_time，不等同品牌官方开业；关店确认取最后更新时间后一天，不等同官方闭店公告。关店率是网络收缩指标，不代表经营失败率。
• 部分月需要提示：摘要和趋势仅在用户明确指定部分月时使用并提示；方向判断和多品牌比较始终排除部分月。
• 不降级、不补齐：遇到 not_materialized、ok=false 或缺少 capabilities 时，直接说明未发布或能力不足，不用相似品牌、网页数据或模型常识补齐。位置服务返回 503 时不降级为关键词匹配。