全国招标中标项目查询与企业画像API

面临的具体问题

在供应链分析、市场情报获取或商业决策支持场景中，快速、系统地获取全国范围内的公开招标、中标及合同信息是一项基础但繁琐的工作。数据通常分散在各地公共资源交易平台，格式与字段定义不统一。工程师或分析师需要可靠的结构化数据源，以支持竞品分析、区域市场洞察、潜在客户发掘或项目生命周期追踪。手工收集效率低下，且难以进行深度关联分析。

核心能力与工作流程

该技能封装了世舶科技的招投标数据 API，提供了一套程序化的数据查询与分析接口，其工作流程可分为几个关键步骤：

1. 认证与配置：从环境变量 BBIAO_API_KEY 读取密钥。若未配置，则指引获取。密钥是调用所有接口的前提。
2. 数据检索：根据需求选择不同搜索接口。

自然语言友好查询：使用 /bid/SearchProjectForAI，直接传入 areaName 等自然语言参数。
结构化条件查询：使用 /bid/searchProjectApi，支持复杂的关键词组合（如 keyword 为空格连接“同时出现”，| 连接“任一出现”）、地区编码 (proviceCodeList)、行业编码、企业角色 (partAName, partBName, agentName) 和时间范围。可通过 searchType 和 searchMode 控制搜索精度。
* AI 辅助查询：先调用 /bid/aiSearchSubmitPolling 将模糊需求重写为结构化条件，再进行搜索。

1. 深度信息获取：搜索结果仅返回摘要。需根据结果中的 id 和 publishTime 追加调用详情接口，例如：

/bid/getZTBStructreDetail 获取项目预算、中标金额、甲方乙方、代理机构等结构化字段。
/bid/getZTBProjectDetail 获取完整公告正文。
/bid/getZTBProjectFiles 获取附件列表及下载地址。
/bid/getCollectUrl 获取公告原始发布网页。

1. 企业画像构建：对于查询目标企业，可通过一套组合接口进行画像分析：

/bid/companyProfileSummary 获取工商基础、招投标统计等概览。
/bid/companyProfileContacts 获取联系电话。
* /bid/companyProfileCustomers 和 /bid/companyProfileSuppliers 获取其关联的客户与供应商企业及项目。

1. 辅助与结构化：利用 AI 推理接口增强查询能力，例如通过 /bid/industryReasoning 映射行业编码，或使用 /bid/ztbAiStructureInfo 将非结构化公告文本抽取为结构化字段。

适用边界与注意点

• 数据性质：数据为日更新的公开信息聚合，接口返回“未命中”不代表现实中不存在相关项目，仅代表本次查询未匹配到数据。分析结论应明确标注数据覆盖范围和时效。
• 企业关系：企业客户与供应商接口返回的是基于历史项目的业务关联，不等同于股权控制或当前排他合作关系。确认具体项目角色（甲方/乙方）必须调用结构化详情接口验证，不可仅凭搜索命中 companyName 推断。
• 使用限制：所有接口有分页上限（如列表搜索最多50或100条/页），全量获取需循环翻页。计算市场份额等统计前，必须确认已获取全量分页数据。
• 合规使用：调用企业联系方式接口时，使用者需自行确保后续通信行为符合相关隐私与营销法规。