供应商风险评估报告-比地招标网

概述

供应商履约风险评估（比地招标网）

为采购方 / 招标代理在定标或签订采购合同前，对供应商（投标或入围企业）自动拉取比地招标网公开企业数据，完成履约风险评估，并产出一份结构化的《供应商履约风险评估报告》。

报告结构分解自《中国工商银行履约风险评估报告（实时查询）》模板：

I.   供应商履约风险评估概要（风险评分 / 风险等级 / 关键风险项）
II.  供应商基本信息（基本情况 / 历史变更 / 股东 / 主要人员 / 关联企业 /
                       分支机构 / 资质与行政许可 / 纳税信用）
III. 供应商风险分析（资格风险 / 信用风险 / 履约交付风险 / 欺诈风险 /
                       廉洁风险 / 其他风险）
IV.  数据缺口说明
+    方法与免责

适用场景

• 各类采购/招标定标前，对投标或入围供应商做履约能力初筛。
• 需要核查供应商是否带有有效期内行政处罚、失信、限高、经营异常、欠税、环保处罚等信号。
• 需要核验证照资质（资质证书、信用中国许可）与纳税信用。
• 需要比对比地「信用中国」平台收录的行政处罚 / 行政许可数据。

数据来源与安全

• 复用 bidi-tender-search 技能的同套接口与凭据：环境变量 BIDI_API_TOKEN

（Authorization: Bearer <token>）。脚本优先取环境变量，否则回退到~/.codex/config.toml 的 [mcp_servers.bidi-tender-search.env]。禁止输出、落盘或回显 Token。

• 接口基础地址：https://moose-api.bidizhaobiao.com/service-api-open/v1/...，详见

[references/api-map.md](references/api-map.md)（含每个维度对应的接口 ID、URL、字段与有效期规则）。

• 每次 API 调用均计费（约 0.05–0.4 元/次）；一次完整评估约 25 个接口、约 2–4 元量级。

执行前先向调用方说明取数范围与大致成本。

• 字段名在不同企业间可能不一致，脚本已做候选键模糊匹配；个别字段缺失时如实标注「—」，不臆造。

接口申请与配置（安装前置，必读）

本技能依赖比地招标网开放接口，使用前必须完成配置，否则 init / assess 会因无凭据直接失败。分三步：

1. 申请开放接口 Token

• 在比地招标网开放平台申请开通「开放接口」并获取 token（用户自备凭据，脚本不内置）。
• 比地按账号授权开放接口范围；若某些接口返回 300102001 company api error: no permission，

表示该接口的「自助开通」主能力未对贵司账号授权（无效关键词也会返回同码，拦截发生在关键词匹配之前），需联系比地后台放开后才能使用，脚本无法自行绕过。

2. 配置 Token（二选一，环境变量优先）

# 方式 A：环境变量（推荐，每次运行前 export 或内联）
export BIDI_API_TOKEN='你的token'
# 方式 B：写入 ~/.codex/config.toml（脚本回退读取，不回显）
#   [mcp_servers.bidi-tender-search.env]
#   BIDI_API_TOKEN = "你的token"

脚本读取顺序：环境变量 BIDI_API_TOKEN → ~/.codex/config.toml 同名键。Token 绝不在日志/报告中输出。

3. 首次运行 init 开通约 25 个接口（自助开通闸口）

平台没有"查询已开通列表"的接口，脚本用探测法判断开通范围，再对未开通的提交自助开通（幂等）。详见下方「工作流程 §1」。若 init 报告某接口持续 300102001，回到第 1 步联系比地后台授权。

计费提示：探测会对每个接口发起一次真实调用，已开通的按目录单价计费，一次自检约 1–2 元；

后续 assess 一次完整评估约 25 接口、2–4 元量级。执行前先向调用方说明取数范围与成本。

工作流程

1. 开通接口（仅首次）

本技能需约 25 个接口（见 [references/api-map.md](references/api-map.md)）。平台没有"查询已开通列表"的接口，因此 init 用探测法判断开通范围，再调用自助开通 API 补齐未开通的。

BIDI_API_TOKEN='<token>' python3 ~/.workbuddy/skills/supplier-risk-assessment/scripts/supplier_risk.py init

流程：凭据预检 → 逐接口探测（已开通 / 已开通(空) / 未开通 / 异常）→对未开通的提交自助开通（幂等）→ 复探确认 → 出闸口报告（就绪 N/M）。

探测会对每个接口发起一次真实调用；已开通的按目录单价计费，一次自检约 1–2 元。

也可用 check 仅诊断已开通范围（不提交开通）。

2. 执行评估

BIDI_API_TOKEN='<token>' python3 ~/.workbuddy/skills/supplier-risk-assessment/scripts/supplier_risk.py assess 
  --company "广州广之旅国际旅行社股份有限公司" 
  --validity-years 3 
  --html report.html --json snapshot.json --md report.md

• --company：供应商名称（可用 creditCode 提高准确率；脚本统一走 companyName）。
• --validity-years：有效期窗口，默认 3 年（处罚/司法记录超出即视为已失效）。
• --html：生成样式化网页报告（参照寻源报告「IDC 报表设计系统」：页宽 1120px、比地 logo、

粘性目录、KPI 卡片、蓝红琥珀绿配色，全中文，单文件离线可打开）。

• --json：落盘原始数据快照，便于 analyze 二次渲染或归档。
• --md：落盘 Markdown 简版。
• 缺省 --html 时，控制台打印评估结论摘要。

3. 仅分析已有快照（可选，省 API 费）

python3 ~/.workbuddy/skills/supplier-risk-assessment/scripts/supplier_risk.py analyze 
  --input snapshot.json --html report.html

4. 解读报告并交付

• 突出履约风险评分（0–100，越高越险）与风险等级（极高风险 / 高风险 / 中风险 / 低风险）。
• 对"高风险"项明确建议采购方在定标前重点核验，必要时要求履约保函或分级管控。
• 强调"是否准入 / 定标"以招标文件、实地考察与官方渠道为准，报告仅作辅助。

风险框架（六类，对齐 PDF 模板）

基本信息维度

基本情况（IC-001）/ 历史变更（IC-003）/ 股东（IC-006）/ 主要人员（IC-004）/ 关联企业·对外投资（DEV-002）/ 分支机构（IC-002）/ 资质与行政许可（IC-008+OP-006+CC-002）/纳税信用（OP-004）。

评分方法（摘要，详见 api-map.md）

• 存续状态吊销/注销 +40；简易注销 +35；清算 +30；严重违法失信 +35/条；经营异常 +18/条；

失信未履行 +40/条；限高 +25/条；被执行人 +12/条；裁判文书合同纠纷 +12、其他 +6；工商处罚 +15（质量 +5、造假 +25、围标串标 +30）；信用中国处罚 +18（围标串标 +30）；环保 +14；欠税 +12；重大税收违法 +30；司法拍卖 +8；开庭公告 +4。

• 分数上限 100（越高风险越大）。等级：≥70 极高风险 / 40–69 高风险 / 16–39 中风险 / <16 低风险。

已知坑（务必注意）

• HTTP 404 ≠ 接口异常：body 为 code=300104001 且 message 含"查询数据不存在"时，是正常空响应

（该公司无该项记录，对违规类接口反而是合规证据）；只有非此语义的 404 才算真异常，才列入数据缺口。

• 响应双层嵌套：single 类接口业务数据在 data，list 类在 data.data（分页对象在外层）。
• 破产/重整（JU-009）接口已与比地确认尚未上线：脚本已完全跳过（disabled:True）——

不探测、不申请、不取数、不评分、不展示；仅在"数据缺口说明"中告知。存续性风险由IC-001 状态 / IC-012 清算 / IC-015 简易注销 / JU-001 被执行人兜底。

• 字段容错：不同企业返回字段名不完全一致，脚本用 first_of 候选键模糊匹配；缺失显示「—」。

数据缺口（诚实标注）

以下维度当前无公开接口或属企业内部数据，报告「数据缺口说明」中如实列出，不臆造结论：行贿犯罪记录（廉洁风险）、责令停产停业、集团黑名单、限制投标/黑名单、合同逾期（内部）、严重拖欠工资、财务风险、破产/重整（JU-009 未上线）。

局限与免责

• 风险判定依赖企业公开工商/司法/信用数据，无身份证号/统一人物 ID，故人员比对为辅助信号。
• "有效期"为按年限窗口的工程近似；信用修复、提前移出等以官方公示为准。
• 报告不构成法律意见或授信结论；是否准入/定标须结合招标文件、实地考察与官方渠道最终判定。

品牌 logo

• 报告页头内嵌比地招标网 logo（assets/logo-bidizhaobiao.png，以 base64 内嵌为单文件 HTML，可离线打开与转发；页脚同款小字标注数据来源）。
• 替换 logo：直接覆盖 assets/logo-bidizhaobiao.png 即可，无需改代码。
• 注意：页头/页脚 logo 为比地招标网商标，公开发布前需替换为自有图标或取得授权。