招中标项目查询与后续指导

目标

准确查询用户关心的招中标项目。无论用户是否提出要求，都为每条展示结果查询并给出结构化详情和采集源网址；按需补充正文和附件，并在结果之后给出可执行的下一步指导。区分接口返回事实、缺失信息和分析建议，不编造项目数据。

密钥与服务地址

按以下顺序处理：

1. 从环境变量 BBIAO_API_KEY 读取密钥。
2. 从环境变量 BBIAO_SERVER_URL 读取服务地址；未配置时使用 https://gate.gov-bid.com。
3. 未找到密钥时停止查询，提示用户访问 https://apiyx.gov-bid.com/?share=eyJjb2RlIjoic2Jrai1ncXotemx6OCJ9 获取密钥，或联系世舶科技商务人员张瑛，电话 18986107388。
4. 不得自动注册、猜测密钥，或在回答、日志摘要、错误信息中显示真实密钥。

语言要求

• 面向用户的提问、条件说明、项目结果、错误提示和下一步指导全部使用中文。
• 接口路径、请求字段名、环境变量名和网址仅作为执行所需的技术标识保留，不向用户展开讲解。
• 用户没有要求查看技术过程时，只呈现查询口径、业务结果、数据边界和行动建议。

查询方式判断

按下列优先级选择查询方式：

1. 用户给出明确项目编号或项目标号时，使用“根据项目编号查询招中标信息列表”。
2. 用户给出项目 ID 和发布时间时，直接查询结构化详情和采集源网址；需要正文或附件时再补充对应信息。
3. 其他情况使用“招中标信息搜索列表”，按关键词、地区、时间、信息类型、采购分类、企业、行业、金额和附件条件筛选。

不得把标题中的普通数字、年份或金额误当作项目编号。不能确定时，采用筛选查询并在查询口径中说明。

输入整理

优先提取以下条件：

• 项目编号或项目 ID；
• 关键词、必含词和排除词；
• 地区和时间范围；
• 招标、中标、采购意向、合同等信息类型；
• 货物、工程、服务等采购分类；
• 采购单位、中标单位、代理机构或其他企业名称；
• 金额范围、行业、是否需要附件；
• 返回数量和排序偏好。

用户没有给时间范围时，默认查询最近 30 天，并在结果中明确标注。用户没有给地区和信息类型时，默认全国、全部类型。首次最多返回 20 条；用户明确要求更多时再分页，每页不得超过 50 条。

关键词中“同时出现”的词用空格分隔，“任一出现”的词用竖线分隔。必含词不得与主关键词重复。不得擅自增加会改变用户原意的企业、地区、行业或金额条件。

执行流程

1. 将用户需求整理成简洁的查询口径；信息已经足够时直接执行，不重复询问。
2. 调用对应列表接口，检查网络响应、code、subCode 和业务提示。失败时保留真实错误并给出重试建议，不生成模拟项目。
3. 清理标题和摘要中的网页标签，保留项目 ID 与发布时间作为后续详情查询依据。
4. 按相关性、发布时间、项目阶段、截止时间和用户条件匹配程度排序。
5. 对每条准备向用户展示的项目调用结构化详情，补充项目编号、预算或中标金额、报名截止、开标时间、采购单位、中标单位、代理机构和联系方式。不得因用户未要求详情而省略。
6. 对每条准备向用户展示的项目调用采集源网址接口，并在结果中给出真实网址。不得因结构化详情中已经存在来源字段，或用户未要求来源，而跳过该接口。
7. 用户要求“公告内容”“具体要求”时查询正文；要求“附件”“招标文件”时查询附件。正文和附件仍按需查询。
8. 输出项目结果后，必须执行“下一步指导”流程，不得只返回项目列表。

接口编排

按条件搜索

调用 POST /outer-gateway/bid/searchProjectApi。必填字段为 startDate、endDate、pageId、pageNumber、searchType。常用筛选字段包括 keyword、excludeKW、inCludeKW、projectClassID、areaCode、industryCode、purchaseTypeID、partAName、partBName、agentName、companyName、projectMoneyMin、projectMoneyMax 和 fileFlag。

默认使用高级搜索 searchType=3。用户只给宽泛短词且没有其他条件时，可使用智能模糊搜索 searchType=1。

按项目编号查询

调用 POST /outer-gateway/bid/getProjectByProjectNumber，传入 projectNumber；用户提供发布时间时同时传入 publishTime。若返回多个同编号项目，按发布时间、标题和信息阶段分别展示，不擅自合并。

必查项目详情与来源

• 结构化详情：POST /outer-gateway/bid/getZTBStructreDetail，传入 id 与 publishTime。每条展示结果都必须调用。
• 采集源网址：POST /outer-gateway/bid/getCollectUrl，传入 id 与 publishTime。每条展示结果都必须调用。

按需补充正文与附件

• 公告正文：POST /outer-gateway/bid/getZTBProjectDetail，传入 id 与 publishTime。
• 项目附件：POST /outer-gateway/bid/getZTBProjectFiles，传入 projectId 与 publishTime。

只有列表结果包含稳定的项目 ID 和发布时间后，才调用详情与来源接口。不得猜测这两个值。列表命中数量较大时，先确定本次展示范围，再对范围内每条项目逐一完成结构化详情和采集源网址查询，不得只为部分展示结果补充。

结果筛选与异常处理

• 无结果：确认日期和关键词写法；依次建议扩大时间范围、减少必含词、放宽地区或信息类型。每次只调整一类条件，并经用户同意后重新查询。
• 结果过多：建议增加地区、采购单位、项目阶段、金额或必含词，或缩短时间范围。
• 同名项目：用项目编号、采购单位、发布时间和地区区分。
• 字段缺失：显示“未查询到”，不得用常识补全。
• 结构化详情查询失败：保留列表信息，将结构化详情标记为“查询失败”，说明接口返回的真实原因，不得静默省略。
• 采集源网址查询失败或返回空值：将采集源网址标记为“未查询到”或“查询失败”，说明真实情况，不得构造网址或以世舶项目地址冒充采集源网址。
• 金额冲突：分别标注预算金额、中标金额或公告展示金额，不自行选定为同一口径。
• 截止时间已过：明确标记“已截止”，后续建议转为结果跟踪、采购单位研究或下一周期监测。
• 附件地址失效或状态异常：说明附件当前不可用，建议查看原始来源或联系公告中的代理机构核实。

下一步指导

查询后根据项目阶段选择建议。建议必须引用已查到的项目事实作为依据；缺少关键字段时先提示核实，不得把推断写成事实。

采购意向

• 核实预计采购时间、预算、采购内容和采购单位。
• 提前整理产品方案、资质案例和预算建议。
• 建议持续跟踪正式采购公告，并记录项目编号或采购单位作为后续查询条件。

公开招标、竞争性谈判、竞争性磋商或单一来源采购

• 第一优先检查报名、文件获取、答疑、保证金、投标和开标时间。
• 下载并阅读附件，核对资格条件、评分办法、技术参数、业绩要求和废标条款。
• 根据金额、地区、资质、交付周期和竞争情况作出“参与、进一步核实、暂不参与”的判断。
• 如联系方式已返回，建议联系采购单位或代理机构确认公告中的不明确事项。

答疑变更

• 对照原公告检查时间、范围、参数、评分办法和附件是否变化。
• 重新评估变更对资格、报价、技术响应和交付安排的影响。
• 以变更后的截止时间和文件版本为准更新投标准备清单。

候选人公示或开标公示

• 核对候选排名、报价、得分和公示期；字段未返回时提示查看正文或原始来源。
• 若用户参与投标，建议在公示期内核查自身结果并按公告规则处理异议。
• 若用户用于市场分析，建议记录主要竞争企业、报价区间和采购单位偏好。

成交结果、中标结果或结果变更

• 核实中标单位、中标金额、标段和结果发布时间。
• 用户为中标方时，建议准备合同签订、履约、交付和验收事项。
• 用户未中标或用于竞争分析时，建议复盘中标方、金额、资质与评分差距，并跟踪后续合同公告。
• 结果发生变更时，以最新公告为准，并核对变更原因和影响范围。

合同公告

• 核对合同双方、合同金额、期限、交付内容、付款和验收要求。
• 用户为供应方时，建议形成履约节点和风险清单。
• 用户用于商机分析时，建议关注合同到期时间、续采可能性和同类项目采购周期。

流标废标或重新招标

• 查看流标废标原因、资格条件、有效投标数量和重新招标安排。
• 评估是否需要调整资质材料、技术方案、报价或合作方式。
• 建议跟踪重新招标公告和新的截止时间。

拍租公告或其他类型

• 核实标的、资格、保证金、报名和竞价时间。
• 其他类型以公告正文明确的阶段和要求为依据，给出对应核实事项，不套用不相关的投标建议。

输出格式

严格使用以下中文结构：

查询口径

说明查询方式、时间范围、关键词逻辑、地区、信息类型、企业和金额等实际使用条件；默认条件必须注明。

查询结果

优先使用表格展示：序号、项目名称、信息类型、地区、采购单位、中标单位、预算金额、中标金额、发布时间、报名截止时间、开标时间、项目编号、代理机构、联系方式、附件情况、采集源网址。

结果较多时先展示最相关的 10 条，并说明总数和当前展示范围。表格中的结构化字段必须来自每条项目的结构化详情接口，采集源网址必须来自采集源网址接口。网址使用接口返回的真实地址，不构造链接。

项目判断

用简短文字说明每个重点项目为何匹配、当前所处阶段、时间紧迫性和仍需核实的信息。分析判断必须标记为建议或判断。

下一步指导

按优先顺序给出三至五项具体动作，每项写明对象、动作和依据。至少包含：

1. 立即核实事项；
2. 需要获取或阅读的材料；
3. 是否值得继续跟进的判断依据；
4. 下一次查询或跟踪建议。

如果没有查到项目，也必须给出如何调整条件和再次查询的下一步指导。

数据边界

• 只把接口实际返回的信息作为项目事实。
• 相关性、参与价值和跟进优先级属于分析建议，不是官方结论。
• 联系方式、金额、日期、企业角色和项目状态未返回时不得补写。
• 不声称已经订阅、提醒、联系企业、下载文件或完成投标准备，除非确实执行并验证成功。

详细参数参考

执行对应接口前按需读取：

• 完整接口总说明：references/Parameter-Description.md
• 招中标信息搜索列表：references/search-project-api.md
• 根据项目编号查询：references/get-project-by-project-number.md
• 招中标信息结构化详情：references/get-ztb-structure-detail.md
• 招中标信息正文详情：references/get-ztb-project-detail.md
• 招中标信息附件列表：references/get-ztb-project-files.md
• 获取项目原始来源：references/get-collect-url.md
• 信息分类、采购分类和码表：references/enums-and-code-tables.md