技能介绍

要解决的问题

零售品牌评估常散落在门店列表、城市排行、业态占比和周边画像里。若直接用开店、关店或月度变化推断，容易得出不可复核的结论。跨品牌对比时，口径不一致也会让“谁更强”变成口号，而不是可验证的判断。

核心能力与调用流程

技能只处理已发布的零售品牌。先通过 GET /v1/retail/brands 确认品牌精确名称，再从 GET /v1/retail/brand/profile 取门店数、省/市/区/街道数量、省市 Top 与城市能级；按需调用 regions、cities、categories、surroundings、hierarchy、coverage、scenes 等接口。多品牌对比使用 GET /v1/retail/brand/compare，指定 2–5 个品牌。选址竞争与周边门店分别调用 GET /v1/retail/site-screen 和 GET /v1/retail/nearby，且只在用户提供合法经纬度或公开门店 ID 时执行；单店档案使用 GET /v1/retail/store。

结论只使用同口径聚合数据，按“品牌规模 → 业态结构 → 城市与区域集中度 → 竞对差异与机会”组织。输出按“结论 → 3–6 个关键指标 → 覆盖与数据版本 → 用户明确要求的少量门店 → 未覆盖项”呈现。

鉴权与失败处理

调用前在受控环境设置 DDT_API_KEY，每个请求带 Authorization: Bearer $DDT_API_KEY。Key 不得写入 Skill、聊天、日志或版本库。收到 ok=true 时只用响应中的聚合或受限明细；ok=false 表示当前品牌或门店未收录，停止结论；HTTP 400 修正品牌数量、经纬度、半径、条数或门店 ID；HTTP 401 停止调用并提示检查 Key；HTTP 429 按限流或余额不足区分处理；HTTP 502/503 保留 X-Request-Id 并报告。preview.truncated=true 时缩小半径或增加条件，禁止自动翻页或拆地区枚举。

适用边界

仅服务零售品牌；餐饮、汽车后市场、五金建材需各自行业 Skill。只返回公开聚合与受限门店预览，不含内部标识、供应商或采集来源字段。门店 ID 为公开单向 ID。周边门店和选址结果是受限初筛，不代表完整市场清单、成交概率或开店成功率。零售当前提供最新门店快照，不以开店、关店或月度变化推断经营变化。覆盖接口显示相关画像未覆盖时，明确标为“暂未覆盖”，不把缺失值解释为零。