# 天眼查数据接入方案（销售工作台 AI 助手）

> 编制：2026-09-10　决策人：刘新元　执行：Hermes（技术）+ 销售管理（商务）
> 结论：**推荐「方案 A + 方案 C 双轨」**——先用零成本缓存轨立即上线，同步申请企业 API 轨。

---

## 一、结论先行

| 方案 | 成本 | 上线时间 | 数据质量 | 推荐度 |
|---|---|---|---|---|
| **A 官方 API**（天眼查/企查查开放平台） | ¥0.10–0.20/次，预估 **¥200–500/月** | 需企业认证，约 3–7 个工作日 | 权威、结构化 | ⭐⭐⭐⭐⭐（目标态） |
| **B 企查查 MCP**（专为 AI Agent 设计） | 面议 | 需企业认证 + 开通 | 权威、原生适配 AI | ⭐⭐⭐⭐（值得并行询价） |
| **C 缓存 + 人工粘贴入库**（零成本轨） | ¥0 | **今天就能用** | 取决于粘贴质量 | ⭐⭐⭐⭐⭐（立即上线） |
| **D 公开检索兜底**（官网/新闻/公示系统） | ¥0 | 立即可用 | 二手、需标注未核验 | ⭐⭐⭐（保底不空手） |

**为什么不直接上 API**：两家开放平台**都必须企业实名认证**（营业执照 + 法人身份证 + 公章 + 用途说明），属公司采购行为，不是个人能开的。期间用方案 C 不阻塞业务。

---

## 二、方案 A：官方 API（目标态）

### 2.1 接口与计费（天眼查开放平台实测价目，2026-09）

| 接口 | 端点 | 单价 | 用途（对应 AI 助手） |
|---|---|---|---|
| 企业基本信息（含联系方式） | `/services/open/ic/baseinfoV2/2.0` | **¥0.20/次** | 客户调研卡第 5 段：规模/成立/法人/地址/经营范围 |
| 企业股东 | `/services/open/ic/holder/2.0` | ¥0.15/次 | 判断是否上市/国资背景/集团归属 |
| 企业天眼风险 | `/services/open/risk/riskInfo/2.0` | ¥0.20/次 | 经营异常/司法风险预警（**风控价值高**） |
| 法律诉讼 | — | ¥0.10/次 | 大额诉讼 → 影响付款能力判断 |
| 主要人员 / 人员所有公司 | — | ¥0.10 / ¥6.00/次 | 找决策链（法人在其他公司的任职） |
| 工商快照 | `/services/open/ic/snapshot` | ¥0.50/次 | 一次性拿全（**推荐，一次调用顶多次**） |
| 企业三要素验证 | `/services/open/ic/verify/2.0` | ¥0.10/次 | 发票/合同主体核验 |

**认证方式**：请求头 `Authorization: <token>`（token 24h 有效，需刷新）；支持 IP 白名单。

### 2.2 成本测算（按 30 名销售估）

| 场景 | 假设 | 月调用量 | 月成本 |
|---|---|---|---|
| 保守 | 每天 20 个客户调研 × 1 次基础信息，缓存命中 70% | 180 次 | **≈ ¥36** |
| 中性 | 每天 50 次（含商机/拜访准备） | 450 次 | **≈ ¥90** |
| 激进 | 每天 150 次 + 风控扫描 | 1,350 次 | **≈ ¥270–500** |

> 结论：**成本可忽略**。真正的门槛是资质审核，不是钱。建议首次充值 ¥1,000 试用一年。

### 2.3 申请步骤（谁做、做什么）

| # | 事项 | Owner | 交付物 |
|---|---|---|---|
| 1 | 注册天眼查开放平台企业账号 | 销售管理 | 账号 + 密码移交（存工作台凭证库） |
| 2 | 提交资质（营业执照、法人身份证、用途说明） | 销售管理 + 行政 | 审核通过截图 |
| 3 | 创建应用，配置服务器 IP 白名单 | Hermes | 应用 ID + Token（写入本地配置，**不入代码库**） |
| 4 | 申请接口权限（baseinfoV2 / risk / snapshot） | 销售管理 | 接口开通确认 |
| 5 | 充值 ¥1,000 | 财务 | 余额截图 |
| 6 | 配置 `数据/tianyancha_cfg.json`（token + 开关） | Hermes | 配置就绪 |
| 7 | 联调 + 权限隔离验收 | Hermes | 验收报告 |

### 2.4 合规红线（必须遵守）

1. **仅用于合规企业征信、供应商筛选、市场调研**——禁止转售、禁止对外披露原始数据
2. 数据写入本地缓存，**不得**推送至 IMA 知识库（第三方数据版权）
3. 调用需 IP 白名单；Token 定期轮换
4. 天眼查数据出现在会话中时，**同样过权限闸**：权限外客户不返回其工商画像

---

## 三、方案 B：企查查 MCP（并行询价）

企查查开放平台官网已上线 **MCP 服务**（定位："让 AI Agent 读懂中国企业"），专为 AI 智能体接入设计，理论上比裸 API 更省对接成本。

- **优势**：原生面向 AI Agent，可能省掉自建 schema 层
- **门槛**：同样需企业实名认证（开放平台标准流程：注册 → 企业认证 → 开通服务 → 接入协作）
- **动作**：与天眼查一并询价，比价后再定；**不必等，先用方案 A 的接口封装**

> 我们的代码已按"可插拔数据源"设计（`脚本/providers/`），换供应商只改一个 provider 文件，不动作业流。

---

## 四、方案 C：缓存 + 人工粘贴入库（立即上线，零成本）

### 4.1 怎么用

销售在天眼查 App/网页查完客户后，**复制一段文本粘贴到 AI 助手**，说一句"存入客户档案"，助手自动：
1. 解析出：注册资本、成立时间、法人、地址、经营范围、股东、风险条目
2. 写入 `数据/tianyancha_cache.json`（按客户核心名索引，记 `source=manual`、`date`）
3. 之后任意人再问该客户，自动带出这段背景（受权限隔离约束）

### 4.2 缓存结构

```json
{
  "深圳市亚辉龙生物科技股份有限公司": {
    "source": "manual | api",
    "date": "2026-09-10",
    "fields": {"regCapital": "…", "estiblishTime": "…", "legalPersonName": "…",
               "staffNumRange": "…", "regStatus": "…", "businessScope": "…"},
    "risk": ["…"],
    "raw": "…原始粘贴文本（截断 2000 字）…"
  }
}
```

- **TTL**：API 来源 7 天；人工来源 90 天（人工数据变动慢）
- **命中即用**，未命中则提示"可粘贴天眼查内容补充"

### 4.3 降级链条（写进工作流）

```
本地缓存命中？ ── 是 → 用，标注来源与日期
        ↓ 否
API 可用？ ── 是 → 实时取，写缓存
        ↓ 否
公开检索（官网/新闻/公示系统）→ 标注【公开网络·未核验】
        ↓ 也失败
明说"外部背景暂未获取，建议粘贴天眼查内容补充" ← 绝不编造
```

---

## 五、无论走哪个方案，都必须做的三件事

1. **权限同权**：外部工商数据 ≠ 可绕过客户权限。权限外客户，一律不返回其工商画像。
2. **来源标注**：每条外部数据带来源标签（`【天眼查】`/`【企查查】`/`【公开网络·未核验】`/`【人工录入】`），销售能判断可信度。
3. **不写入 IMA**：第三方商业数据受版权与平台协议约束，**只留本地**。进 IMA 的只有我们自己产生的方法论经验。

---

## 六、待用户决策

| # | 决策项 | 选项 |
|---|---|---|
| 1 | 是否走企业 API 轨 | ① 天眼查 ② 企查查 ③ 两家比价 ④ 暂不申请，只用方案 C |
| 2 | 谁负责资质申请 | 建议：销售管理（刘新元）+ 行政协同 |
| 3 | 首充金额 | 建议 ¥1,000 |
| 4 | 是否需要"风险预警"能力 | 需要则加 `risk` 接口（+¥0.2/次），可做**客户风险自动提醒** |