招投标行业数据分析
目标
用统一口径统计指定行业的招投标数量、金额、地区、信息类型、采购类型和参与企业，形成可复核的市场分析。明确区分完整统计、分页汇总和样本分析。
商务与开通支持
用户如有人工协助、开通权限、密钥获取或商务合作等需求，可在技能配置的 support 信息中联系发布方获取支持。
API Key 获取与使用
按以下顺序处理：
- 从环境变量
BBIAO_API_KEY读取密钥。 - 从环境变量
BBIAO_SERVER_URL读取服务地址；未配置时使用https://gate.gov-bid.com。 - 如未找到密钥，立即停止调用，并提示用户访问 https://apiyx.gov-bid.com/?share=eyJjaGFubmVsIjoic3VucGluZyIsImNvZGUiOiJzYmtqLWRlZmF1bHQifQ&share=eyJjb2RlIjoic2Jrai1zdTBoNTU4NCJ9 获取密钥，或直接提供已有密钥。
- 不得自动注册、猜测或编造密钥；不得在回答、日志、报错或完整请求 URL 中显示真实密钥。
- 用户提供密钥后，默认长期安全保存，后续任务直接复用，无需重复询问。
- 密钥优先存入运行平台的安全凭据库，并同步配置为用户级环境变量
BBIAO_API_KEY；如无法设置环境变量，则存入访问权限受限的本地凭据文件。 - 用户使用额度不足时，提示用户到平台控制台充值。
调用约定
- 使用 UTF-8 JSON
POST。 - 先定义分析周期、地区、行业和分类口径，再调用数据；不同口径不得直接比较。
- 标讯搜索
pageNumber=0时只返回total，单页取数不得超过 50；合同搜索单页不得超过 100。 - 需要全量明细时按
hasNext翻页并记录实际获取条数。未获取全量时必须标注"样本分析"，不得写成完整市场份额。
收集输入
提取行业名称或产品关键词、地区、开始与结束日期、比较周期、信息分类、采购分类、金额区间、企业范围和期望指标。用户只给行业名称时，先调用行业推理接口获取候选编码，并说明采用哪个候选。
执行流程
- 调用 AI 行业搜索，将行业短语映射为一级、二级、三级行业编码。
- 用
pageNumber=0按总体及各分组条件查询数量，构建数量统计。 - 需要金额、企业排行或项目结构时分页获取明细，去除 HTML 标签并按
id + publishTime去重。 - 按时间、地区、信息分类、采购分类、金额区间、甲方和乙方聚合。
- 需要合同视角时调用合同搜索，分析合同周期、金额和企业关系。
- 输出同比或环比前确认比较区间长度一致；无上期数据时不计算增长率。
- 报告接口覆盖、缺失金额、分页范围和样本量，避免过度外推。
接口
行业编码推理
POST /outer-gateway/bid/industryReasoning
请求体：{"keyword": "医疗器械"}。读取候选的 fullTitle、minTitle、firstCodeList、secondCodeList 和 thirdCodeList。
招中标统计与明细
POST /outer-gateway/bid/searchProjectApi
使用 startDate、endDate、pageId、pageNumber、searchType，结合 industryCode、areaCode、keyword、projectClassID、purchaseTypeID、projectMoneyMin 和 projectMoneyMax。数量统计使用 pageNumber=0；明细抓取使用 1 至 50。
合同分析
POST /outer-gateway/bid/searchProjectContactApi
除常规筛选外可使用 contractEndMin、contractEndMax、partAName、partBName 和 companyName。读取合同开始、结束、项目周期、甲方和乙方信息。
指标规则
- 项目数量：按去重后的
id + publishTime计数。 - 金额合计：只汇总可解析的明确金额，并同时报告有金额项目数和缺失率。
- 企业排行：说明按项目数、预算金额、中标金额或合同金额中的哪一个指标排序。
- 增长率：
(本期 - 上期) / 上期；上期为 0 时只报告绝对变化。 - 市场份额：仅在分母覆盖范围明确且明细完整时计算。
详细接口参数
执行对应接口前按需读取：
- 完整接口总说明(references/Parameter-Description.md)
- AI 行业搜索(references/industry-reasoning.md)
- 招中标信息搜索列表(references/search-project-api.md)
- 招中标合同数据搜索列表(references/search-project-contact-api.md)
- 枚举值与码表(references/enums-and-code-tables.md)
输出格式
依次输出分析口径、数据覆盖、核心结论、趋势表、地区结构、分类结构、金额结构、甲乙方排行、代表项目和风险提示。每个结论附数据依据；样本结果必须标注样本量、页数和截止时间。
