企业画像与上下游关系分析
目标
以企业全称为入口，形成包含工商基础、经营信息、项目表现、联系人、客户和供应商关系的企业画像。关系结论必须能追溯到接口返回的关联项目。
密钥APIkey获取使用与API服务地址
按以下顺序处理：
- 从环境变量
BBIAO_API_KEY读取密钥。 - 从环境变量
BBIAO_SERVER_URL读取服务地址；未配置时使用https://gate.gov-bid.com。 - 如未找到密钥，立即停止调用，并提示用户访问 https://apiyx.gov-bid.com/?share=eyJjaGFubmVsIjoic3VucGluZyIsImNvZGUiOiJzYmtqLTQtdGxxcWNoIn0 获取密钥，或直接提供已有密钥。如需协助，可联系商务人员☎️毛梦锦，电话 13072786231。
- 不得自动注册、猜测或编造密钥；不得在回答、日志、报错或完整请求 URL 中显示真实密钥。
- 用户提供密钥后，默认长期安全保存，后续任务直接复用，无需重复询问。
- 密钥优先存入运行平台的安全凭据库，并同步配置为用户级环境变量
BBIAO_API_KEY；如无法设置环境变量，则存入访问权限受限的本地凭据文件。 - 用户使用额度不足时，提示用户充值https://console.api.gov-bid.com/bbiao-gateway/package
调用约定
- 使用 UTF-8 JSON
POST。 - 企业名称必须尽量使用法人全称；名称不确定时先报告命中风险。
- 联系人每页最多 5 条，客户与供应商每页最多 20 条。只有用户需要完整关系时才继续翻页。
- 接口无结果时明确写“未命中”，不得等同于企业没有该类信息。
执行流程
- 调用企业画像汇总，读取企业基本资料、项目统计、关系数量和数据命中状态。
- 根据用户需求调用联系人、客户和供应商分页接口。
- 对重要关联项目保留项目 ID、名称和发布时间，必要时调用项目详情核验企业角色。
- 对企业的投标行业、中标行业、客户集中度和供应商集中度进行描述性分析。
- 区分“接口事实”和“分析判断”。不得把项目合作关系推断为股权、控制、集团或排他合作关系。
- 多企业对比时统一时间口径、页数和字段范围。
接口
企业画像汇总
POST /outer-gateway/bid/companyProfileSummary
请求体：{"companyName": "企业全称"}。读取企业类型、行业、注册地区、法定代表人、成立日期、经营状态、信用代码、资本、经营范围、地址、网站、联系方式、投标与中标统计、关系汇总和 dataStatus。
联系人与关系
POST /outer-gateway/bid/companyProfileContacts：{"companyName": "企业全称", "pageNo": 1, "pageSize": 5}。POST /outer-gateway/bid/companyProfileCustomers：{"companyName": "企业全称", "pageNo": 1, "pageSize": 20}。POST /outer-gateway/bid/companyProfileSuppliers：{"companyName": "企业全称", "pageNo": 1, "pageSize": 20}。
客户和供应商记录重点读取 partnerCompanyName、relatedProjectId、relatedProjectName、projectPublishTime 和 relationshipType。
项目核验
需要确认某个关联项目时，调用 POST /outer-gateway/bid/getZTBStructreDetail，传 id 和 publishTime，核验甲方、乙方、投标企业及代理机构。
分析边界
- “合作客户”与“供应商”是招投标项目关系，不代表当前仍在合作。
- 项目数量和金额仅代表接口覆盖范围内的数据，不直接等同于企业全部经营规模。
- 联系方式属于接口返回信息，使用时提示用户遵守适用的隐私、营销和通信规则。
- 不计算未提供分母的市场份额，不根据公司名称猜测集团归属。
详细接口参数
执行对应接口前按需读取：
- 完整接口总说明(references/Parameter-Description.md)
- 企业基本信息(references/company-profile-summary.md)
- 企业联系电话(references/company-profile-contacts.md)
- 企业合作客户(references/company-profile-customers.md)
- 企业供应商(references/company-profile-suppliers.md)
- 招中标信息结构化数据详情(references/get-ztb-structure-detail.md)
输出格式
依次输出：企业概览、经营与注册信息、投标及中标表现、联系人、主要客户、主要供应商、关键关联项目、机会与风险判断。关系表包含合作方、关系类型、关联项目、项目时间、证据和备注。最后列出未命中字段与需要人工核验的结论。
