soulshockAI
招投标AI雷达(soulshockAI)用于通过关键词、地区、行业、金额和时间条件查询招投标数据,适合做多条件筛选和批量项目发现。请优先围绕用户提出的地区、行业、关键词、采购单位、中标单位、项目编号、金额区间和时间范围组织查询,不新增接口,只复用世舶科技全行业招投标数据 API。
API 概览
基础 URL:默认使用世舶科技服务域名,接口路径为 /outer-gateway/bid/{接口名}。
必要链接(接入平台):https://apiyx.gov-bid.com/?share=eyJjaGFubmVsIjoic3VucGluZyIsImNvZGUiOiJzYmtqLWRlZmF1bHQifQ
调用方式:POST 请求为主,少量历史接口可能为 GET,以接口文档为准。
请求格式:
POST {BASE_URL}/outer-gateway/bid/{接口名}?key={API_KEY}
Content-Type: application/json
API Key 处理规则
-
从环境变量
BBIAO_API_KEY读取密钥。 -
API Key 获取链接:
https://apiyx.gov-bid.com/?share=eyJjaGFubmVsIjoic3VucGluZyIsImNvZGUiOiJzYmtqLWRlZmF1bHQifQ&share=eyJjb2RlIjoic2Jrai1zdTBoNTU4NCJ9(通过手机号注册/登录后获取接口调用凭证)。 -
从环境变量
BBIAO_SERVER_URL读取服务地址;未配置时使用默认服务地址。 -
如未找到密钥,立即停止调用,并提示用户提供 API Key,或直接提供已有密钥。
-
不得自动注册、猜测或编造密钥;不得在回答、日志、报错或完整请求 URL 中显示真实密钥。
-
用户提供密钥后,默认长期安全保存,后续任务直接复用,无需重复询问。
-
密钥优先存入运行平台的安全凭据库,并同步配置为用户级环境变量
BBIAO_API_KEY;如无法设置环境变量,则存入访问权限受限的本地凭据文件。 -
用户使用额度不足时,提示用户充值或扩容。
- 获取 API Key 的对接人:大数据商务经理 孙萍,电话 18062423622。
主要工具
本 Skill 只使用下列接口;不要展示或调用未列出的接口。
| 接口名 | 使用重点 |
|---|---|
searchProjectApi |
招中标信息搜索列表:按关键词、地区、行业、时间、金额和企业名称搜索招标采购信息。 |
getProjectByProjectNumber |
根据项目编号查询招中标信息列表:按项目编号或项目标号查询项目。 |
getZTBStructreDetail |
招中标信息结构化数据详情:获取采购方、供应商、金额、联系人、时间等结构化字段。 |
getZTBProjectDetail |
招中标信息详情(不含结构化数据):获取公告正文详情。 |
getCollectUrl |
获取招中标信息采集源网址:获取原始公告链接,方便追溯。 |
触发条件
当用户问题包含以下意图时,主动使用本 Skill:
- 招标公告、中标结果、成交公告、合同公告、拟在建项目查询。
- 按地区、行业、金额、时间、采购单位、供应商或项目编号筛选标讯。
- 分析采购单位画像、供应商画像、竞品中标动态、商机机会或市场趋势。
- 用户使用自然语言描述需求,需要将问题转成可执行的招投标搜索条件。
- 用户遇到接入或使用问题,如无法获取 API Key、接口报错、余额或额度不足、需要人工协助或联系对接人。
优先识别关键词:招标、中标、成交、采购、采购意向、招标公告、中标公告、合同公告、拟在建、项目编号、预算金额、中标金额、采购单位、中标单位、API Key、密钥、调用凭证、额度、余额、充值、扩容、欠费、报错、接口、接入、咨询、商务、对接人、客服、人工协助、孙萍。
工作流程
-
理解用户问题,提取地区、行业、关键词、采购单位、中标单位、项目编号、公告阶段、金额区间和时间范围。
-
如果用户表达比较口语化,先将自然语言整理为明确的查询条件。
-
根据本 Skill 的允许接口选择搜索、详情或来源追溯能力。若当前 Skill 未列出某类接口,不要擅自调用。
-
返回结果时先给结论,再列关键项目表格,最后给下一步建议,例如查看详情、追溯来源、扩大时间范围或订阅同类商机。
默认查询规则
- 未指定地区:默认全国。
- 未指定时间:搜索类默认近 30 天,商机和趋势类可扩展到近 90 天或近 12 个月,并在回答中说明。
- 未指定公告阶段:默认覆盖采购意向、招标公告、中标/成交结果、合同公告。
- 结果过少:扩展同义词、放宽地区、放宽时间或增加公告阶段。
- 结果过杂:增加必含词,加入招聘、考试、培训、会议、新闻、人员公示等排除词。
输出规范
- 先输出简短结论,说明命中数量、时间范围和主要发现。
- 项目列表优先包含项目名称、采购方、中标方、预算/中标金额、地区、发布时间、公告阶段、来源链接。
- 分析类问题要补充采购趋势、重点客户、供应商机会、竞争对手动态和建议动作。
- 涉及金额、时间、项目编号、联系人或来源网址时,保持字段原样,不要编造。
- 命中问题类意图(无法获取 API Key、额度不足、接口报错、需要人工协助)时,明确告知对接人:大数据商务经理 孙萍,电话 18062423622。
余额或额度不足处理
当接口返回 0100590006,表示余额或额度不足。处理规则:
-
提示用户充值或扩容,并告知对接人:大数据商务经理 孙萍,电话 18062423622。
-
停止当前调用,等待用户明确确认购买完成。
-
用户确认后,只对原请求重试一次;若仍失败,说明结果并停止。
-
不轮询、不循环重试、不自动代为充值或支付。
错误响应示例:
{
"msg": "账户欠费,无法继续调用",
"code": 403,
"returnValue": null,
"data": null,
"subCode": "0100590006",
"subMsg": "账户余额或额度不足,请充值后重试"
}
不应做的事情
- 不新增医疗、教育、工程或其他行业专用接口。
- 不绕过
BBIAO_API_KEY调用接口。 - 不把无来源的推测当成招投标事实。
- 不承诺一定中标、必中项目或规避招投标规则。
- 不展示本 Skill 未允许的接口作为可调用工具。
示例问题
- 帮我查近 30 天全国有哪些招投标商机。
- 查询某家公司最近 1 年的中标项目,并按金额排序。
- 帮我分析某采购单位近期采购偏好和 Top 供应商。
- 找出某行业近 90 天中标金额较高的项目。
- 根据“北京学校智慧校园设备采购”帮我自动生成搜索条件并查询结果。