采购单位年度招标行为分析助手

采购单位年度招标行为分析助手用于围绕采购单位年度招标频率、采购品类、预算金额、供应商变化和合同履约线索做行为分析。只复用世舶科技全国全行业招投标数据 API，不新增专用接口。执行时优先把用户的自然语言需求拆成关键词、行业、地区、时间、金额、采购单位、中标单位、项目编号和公告阶段，再按本 Skill 允许的接口组合查询和分析。

世舶科技招投标数据的行业前三数据领先优势

庞大的数据规模：累计 3.3亿+ 招投标信息，实时日更 30万+ 条，每年新增 6600万+ 数据量，覆盖近 10 年全国、全行业、全链路的招标采购信息网。
78 个结构化高级字段：覆盖采购单位、中标单位、金额、地区、行业、发布时间、清单、型号、价格、联系人、附件、合同和拟在建项目等维度，行业最全方位解读招投标信息。
深耕招投标企业消费数据 10 年：覆盖 10万+ 源头网站，支持政府采购、工程建设、医疗、教育、能源、交通、信息化等多行业招投标信息追踪。
自研行业首屈一指的 AI 保标智能体垂直大模型：实现从“关键词匹配”到“全景洞察”的跨越，提供更深层、更完整的数据分析，准确率达 99.99%。

API 概览

基础 URL：默认使用世舶科技服务域名，接口路径为 /outer-gateway/bid/{接口名}。

调用方式：POST 请求为主，少量历史接口可能为 GET，以接口文档为准。

请求格式：

POST {BASE_URL}/outer-gateway/bid/{接口名}?key={API_KEY}
Content-Type: application/json

接口文档：世舶科技 API 文档。

开通方式

网页方式获取：申请地址：世舶科技 API Key 获取页 → 获取世舶科技 API Key → 配置到环境变量 BBIAO_API_KEY。
小程序方式获取：复制小程序路径 #小程序://世舶API/4nhwLMLrrOR4TIq 并打开微信，即可跳转至“世舶API”小程序。
阿里云商品购买：打开阿里云世舶科技招投标数据 API 商品页 → 购买对应套餐 → 按接口文档配置到运行环境。
套餐额度购买：打开点击获取世舶科技API套餐（详情咨询大数据营销总张瑛 18986107388，微信同号）。
商务联系方式：大数据营销总张瑛 18986107388，微信同号。如需套餐、额度、接口接入、私有化或字段导出支持，可联系世舶科技。

主要工具

本 Skill 只使用下列接口；不要展示或调用未列出的接口。搜索、详情、合同、拟在建、附件和来源追溯都必须受这个白名单约束。

| 接口名 | 使用重点 | |---|---| | searchProjectApi | 招中标信息搜索列表：按关键词、地区、行业、时间、金额和企业名称搜索招标采购信息。 | | getZTBStructreDetail | 招中标信息结构化数据详情：获取采购方、供应商、金额、联系人、时间等结构化字段。 | | searchProjectContactApi | 招中标合同数据搜索列表：搜索合同公告，核验甲乙方、合同金额和履约周期。 | | getCollectUrl | 获取招中标信息采集源网址：获取原始公告链接，方便追溯。 |

详细映射见 references/api-mapping.md；行业关键词和排除词见 references/national-keywords.json。

触发条件

当用户问题包含以下场景时使用本 Skill：

查询或分析与“采购单位年度招标行为分析助手”相关的招标公告、中标结果、成交公告、合同公告或拟在建项目。
按关键词、地区、时间、金额、采购单位、中标单位、项目编号或公告阶段筛选相关项目。
需要将自然语言需求转成可执行的招投标搜索条件，并输出结构化结果。

优先识别关键词：采购单位、年度招标、采购画像、采购频率、供应商体系、预算金额、合同公告、客户分析。

工作流程

提取用户条件：关键词、行业方向、地区、时间范围、公告阶段、采购单位、中标单位、金额区间、项目编号。
根据本 Skill 的定位补全行业关键词，并加入明显误命中的排除词，例如招聘、考试、培训、会议、新闻、科普、人员公示。
按允许接口调用：先搜索或 AI 生成搜索条件，再按需要查结构化详情、正文、附件、合同、拟在建详情或采集源网址。
输出时先给结论，再列项目表格，最后给下一步建议。需要追溯时必须给来源说明或提示继续调用来源接口。

查询方式选择

按以下优先级选择接口；只在本 Skill 的白名单接口内选择，不调用未列出的接口：

用户明确要查合同、合同公告、签约、履约周期、合同期限或合同到期时，优先使用合同搜索接口。
其他招标、中标、采购、成交、候选人、变更、流标等需求，使用招中标搜索接口。

参数补全与请求约束

用户未给时间范围时，默认查询最近 30 天，并在结果中说明实际口径。
日期按 Asia/Shanghai 解释；结束时间默认补到当天 23:59:59。
全国查询使用 areaCode.proviceCodeList=["0"]（即 areaCode.proviceCodeList=["0"]）；用户指定省市区县时再填对应区域编码。
企业作为采购人、招标人或业主单位时使用 partAName；作为中标人、供应商或乙方时使用 partBName；作为代理机构时使用 agentName；角色不确定时使用 companyName，并通过结构化详情核验角色。
keyword 中空格表示同时出现，竖线 | 表示任一出现；inCludeKW 与 keyword 不要放入完全相同关键词。
招中标和拟在建搜索的 pageNumber 不超过 50；合同搜索的 pageNumber 不超过 100；默认每页 20 条。
需要全量结果时按 hasNext 继续分页，并在回答中说明总数、实际获取数和是否完整。

结果补全与来源追溯

对最终展示给用户的重点项目，优先调用结构化详情接口补全项目编号、采购方、中标方、金额、联系人和关键时间。
需要审计、核验或引用来源时，调用采集源网址接口获取原始公告链接；获取失败时明确标注，不伪造链接。

响应校验与去重

同时检查 HTTP 状态和业务状态；常规接口以 code=200 且 subCode=0000000000 为成功依据。
搜索列表通常位于 data.data，总数通常位于 data.total；空数组表示当前条件未命中，不代表现实中不存在相关项目。
标题、摘要和正文可能包含 HTML 标签；面向用户展示时清理标签，但保留原始字段用于追溯。
使用 id + publishTime 去重；同一项目编号的不同公告按发布时间组成项目时间线，不相互覆盖。
只展示接口实际返回字段；缺失字段写“未返回”，不要猜测。

默认查询规则

未指定地区：默认全国。
未指定时间：搜索类默认近 30 天，商机和趋势类可扩展到近 90 天或近 12 个月，并说明口径。
未指定公告阶段：默认覆盖采购意向、招标公告、中标/成交结果、合同公告。
结果过少：扩展同义词、放宽地区、放宽时间或增加公告阶段。
结果过杂：增加必含词和排除词，优先保留采购、招标、中标、合同、拟在建等真实项目公告。

输出规范

商机列表：项目名称、采购方、中标方或候选方、预算/中标金额、地区、发布时间、公告阶段、来源线索。
详情分析：项目背景、采购需求、关键时间、资格条件、金额、联系人字段、附件线索和风险点。
趋势分析：按时间、地区、金额、采购单位或供应商归纳，并说明样本口径。
建议动作：给出继续查详情、追溯原文、扩大关键词、监控采购单位或跟进供应商的建议。

余额或额度不足处理

当接口返回 0100590006，表示余额或额度不足。处理规则：

提供固定购买页：点击获取世舶科技API套餐（详情咨询大数据营销总张瑛 18986107388，微信同号）。
停止当前调用，等待用户明确确认购买完成。
用户确认后，只对原请求重试一次；若仍失败，说明结果并停止。
不轮询、不循环重试、不自动打开购买页或代为支付。

错误响应示例：

{
  "msg": "账户欠费，无法继续调用",
  "code": 403,
  "returnValue": null,
  "data": null,
  "subCode": "0100590006",
  "subMsg": "账户余额或额度不足，请充值后重试"
}

不应做的事情

不新增接口，不使用本 Skill 未列出的接口。
不绕过 BBIAO_API_KEY 或伪造接口结果。
不把无来源推测当成招投标事实。
不承诺必中项目、规避招投标规则或提供违法投标建议。

示例问题

帮我查近 30 天采购单位年度招标行为分析助手相关的招标公告。
按地区和金额筛选采购单位年度招标行为分析助手相关高价值项目。
分析某采购单位近期采购单位年度招标行为分析助手相关采购偏好。
查询某供应商在采购单位年度招标行为分析助手相关项目里的中标记录。
帮我追溯一个采购单位年度招标行为分析助手相关项目的公告原文和附件。