点位评估

点位评估

适用场景

用户提供了一个明确的地点/POI，想知道这个位置开店行不行、强在哪、弱在哪。

典型问题：

• "在望京SOHO开店怎么样"
• "国贸附近适不适合开餐厅"
• "帮我评估一下三里屯太古里这个位置"
• "XX地址周边的客流/竞争/交通怎么样"

不适用（转其他技能）：

• 用户没有明确地点，只问"哪里适合开店" → 用「商圈推荐」
• 用户给出两个及以上候选点位 → 用「多点位对比」

前置依赖

本技能依赖高德问店选址网关（yt-xd-lite openapi）获取点位五维评估数据。

• 接入方式：技能内直接调用网关 HTTP 接口
• 认证方式：OAuth（首次使用会拉起浏览器完成登录，用户无需手填任何密钥）
• 自包含：完整鉴权规范、OAuth 登录脚本、错误码与降级路径见本技能目录内的 ./references/gateway-auth.md，不依赖套件内其他技能
• 能力待接入：该数据源尚未以千问办公标准 Connector（MCP Server）形态上架，当前为技能内直连。详见套件根目录 CONNECTORS.md

执行步骤

Step 0 — 鉴权与就绪性检查（必做，每次执行前）

请求地址（POST）：${YT_GATEWAY_BASE_URL:-https://yt-gateway.amap.com}/proxy/yt-xd-lite/openapi/v1/gateway

认证 Header：

禁止传 X-Access-Key / X-Tenant-Id / X-User-Id（由网关侧反查注入，技能层不持有）。

执行顺序：

1. 先读 YTOSS 文件，按优先级：macOS/Linux ~/.config/yt/oss.json → Windows %APPDATA%\yt\oss.json → 降级（沙箱）./.yt/oss.json
2. 校验 sessions.wukong.session_token 存在且以 gwst_ 开头
   • ✅ 有效 → 直接进入 Step 1
   • ❌ 不存在 / 无效 → 执行 ./references/gateway-auth.md 中的 OAuth 登录脚本，落盘后再进入 Step 1
3. 禁止跳过文件读取直接登录（已有有效 token 时重复登录会浪费用户操作）
4. 禁止向用户索要 token 等鉴权信息；唯一需要用户参与的是在浏览器中完成登录
5. curl 必须带 -k 跳过 TLS 证书校验

鉴权与调用异常处置：

若用户放弃授权或登录超时，按 ./references/gateway-auth.md 的「数据不可用时的降级原则」处理，不得编造评估数据。

Step 1 — 参数收集与确认

1. 调用 common:place:text 检索用户给出的地点，取 id 作为 poiId
   • 检索不到或返回多个高度相似结果时，列出候选让用户确认，不要自行猜一个
2. 调用 common:atag:list 获取 category（叶子节点完整层级路径）
3. 按 ./references/common-api.md 的默认参数推断规则确定 regionType / regionInfo（未指定时默认 1 公里半径）
4. 业态缺失时必须反问，不要默认成某一类

Step 2 — 调用点位评估接口

接口 action：evaluate:report:analysis

modules 可选值：base、customAgg、potentialGuest、competition、trafficConvenience、business

modules 意图路由：

默认行为：泛泛而问时只传 modules=base，按需追加，禁止重复请求已获取的模块。

请求示例：

{
  "action": "evaluate:report:analysis",
  "params": {
    "poiId": "B0FFHKV7X1",
    "regionType": 3,
    "regionInfo": "1",
    "category": "621122;621376;621377",
    "modules": "base"
  }
}

响应结构：

{
  "data": {
    "head": {
      "name": "望京SOHO半径1km",
      "category": "美食 / 饮品 / 奶茶/茶饮",
      "regionType": "半径",
      "regionInfo": "1km",
      "reportCreateTime": "2025年03月15日 10:30:00"
    },
    "baseInfo": {
      "score": "8.39",
      "scoreName": "商业景气指数",
      "starLevel": "5.0",
      "abovePercent": "93.0%",
      "tags": [{"btag_name": "周边客流量高"}, {"btag_name": "导航热度高"}],
      "radar": [
        {"name": "客群聚集", "value": 7.29},
        {"name": "潜客匹配", "value": 7.02},
        {"name": "同行竞争", "value": 8.88},
        {"name": "交通便利", "value": 5.55},
        {"name": "商业成熟", "value": 6.17}
      ]
    },
    "competition": {
      "name": "同行竞争",
      "starLevel": "0.5",
      "abovePercent": "0.1%",
      "value": [...]
    }
  }
}

Step 3 — 数据解读

通用解读规则

各模块解读要点

base（基础信息+五维综合）：

• 重点关注 score、starLevel、abovePercent
• 如有 tags 标签，作为亮点/特征提及
• 从 radar 中找出最强和最弱维度，给出简明概括

customAgg（客群特征→对应客群聚集维度）：

• 解读周边客群的消费能力、年龄结构、消费偏好等特征
• 结合 starLevel 和 abovePercent 评价客群匹配度

potentialGuest（潜客匹配→对应潜客匹配维度）：

• 分析该区域对目标行业的潜在客户吸引力
• 必须输出以下核心指标：
  • 搜索群体数量：当月在高德地图搜索过选址行业线下门店的UV
  • 导航群体数量：当月在高德地图导航去过选址行业线下门店的UV
  • 潜客群体总数：搜索+导航去重后的总UV
  • 各指标的城市内排名和与平均值对比
• 搜索群体反映"有多少人在找这类店"，导航群体反映"有多少人已经行动去了"
• 当用户询问"有多少人会来消费"、"能不能挣钱"等营收预期问题时，必须先调用此模块，以潜客数量作为推算营收的核心依据

competition（同行竞争→对应同行竞争维度）：

• 分析周边同行业门店密度和竞争压力
• 竞争维度中 starLevel 高表示竞争态势对己方有利（门店少、竞争不激烈）
• 关注具体同业门店数量、品牌占比、客单价、存续时长

trafficConvenience（交通便利度→对应交通便利维度）：

• 分析地铁、公交、停车场等交通配套情况
• 关注交通可达性对客流的支撑作用

business（商业成熟度→对应商业成熟维度）：

• 分析周边商业配套、商圈发展程度
• 关注商业氛围对经营的支撑

Step 4 — 交付与后续引导

输出评估结论后，提示用户可以：

• 还有其他候选铺位 → 用「多点位对比」做横向决策
• 需要给老板/投资人看的正式材料 → 用「立项报告」生成完整报告

输出格式

## [POI名称][业态]点位评估

**评估点位**：[head.name]
**业态类型**：[head.category]
**评估范围**：[head.regionType][head.regionInfo]
**报告时间**：[head.reportCreateTime]

### 综合结论
综合评分 **X.XX**（[优质/一般/不推荐]），超越同城同行业 **XX%** 的点位。

### 五维评分

| 评估维度 | 得分 |
|----------|------|
| 客群聚集 | X.XX |
| 潜客匹配 | X.XX |
| 同行竞争 | X.XX |
| 交通便利 | X.XX |
| 商业成熟 | X.XX |

**突出优势**：[最强维度及说明]
**需关注短板**：[最弱维度及说明]

### 维度解读
[按已请求的 modules 逐项解读，未请求的模块不臆测]

### 经营建议
[结合业态给出 2-3 条建议]

> 评估数据仅供参考，建议结合实地考察和物业条件综合判断。

评分解读

分数与星级是两套不同的评价体系，禁止互相推断。详见 ./references/scoring-model.md。

若分数和星级不一致，解释为「评价口径不同」，属正常现象。

常见错误与恢复

约束

• 仅POI模式：必须传入 poiId，不支持传入 xy 坐标或自定义 WKT（regionType=5）
• regionType范围：仅支持 0-4
• 禁止默认请求全部模块，除非用户明确要求"全面分析"
• 禁止重复请求已获取的模块
• 强制数据一致性：输出的所有数据必须严格来源于接口实际返回结果，不得修改、换算、补全、推断
• 不做绝对判断：数据仅供参考，建议结合实地考察与物业条件综合判断

验证

执行完成后，输出一句话摘要：本次评估的点位、业态、评估范围、请求了哪些维度模块，便于用户复盘。

权属及使用声明

本技能及通过高德服务API获取的内容均属于高德所有，高德保留所有权利，具体权属和使用声明详见《高德云图SKILL权属及使用声明》（https://terms.amap.com/legal-agreement/terms/b_end_product_protocol/20260415144415692/20260415144415692.html），您使用本技能即视为同意该声明。