技能介绍

需要解决的问题

招投标数据是企业市场洞察、销售线索挖掘和竞品分析的核心燃料，但原始数据分散在全国各级平台，格式不一，清洗与关联耗时巨大。工程师和数据分析师往往面临以下挑战：如何高效获取特定地区、行业或企业的标讯全流程？如何将非结构化的公告正文转化为可分析的结构化字段？如何快速发现潜在的拟在建项目机会？手动处理不仅效率低下，而且容易因忽略数据边界和分页规则而得出有偏差的结论。

核心能力与工作流程

本技能提供一个 API 接口集合，封装了对世舶科技招投标数据库的访问。核心工作流程可概括为：

鉴权与配置：通过环境变量 BBIAO_API_KEY 配置访问密钥。支持 HTTP 直接调用和 MCP 协议接入。
多维搜索：

使用 searchProjectApi 进行结构化搜索，通过 keyword（空格表示与，| 表示或）、inCludeKW（必须包含）和 excludeKW（排除）实现精准查询组合。
支持按 partAName（甲方）、partBName（乙方）等企业角色筛选项目。
* 调用 industryReasoning 接口将自然语言行业词映射为标准行业编码。

深度获取与分析：

根据搜索结果中的 id，调用 getZTBStructreDetail 获取预算、中标金额、联系方式等结构化详情。
调用 getProjectByProjectNumber 串联同一项目编号下的所有公告，形成项目时间线。
* 利用企业画像系列接口（如 companyProfileSummary）分析特定企业的招投标活动与上下游合作网络。

AI 赋能：

通过 aiSearchSubmitPolling 将自然语言查询（如“最近半年华东地区医院的医疗床采购”）自动改写为结构化搜索条件。
使用 SearchProjectForAI 接口进行更灵活的自然语言友好搜索。
* 调用 ztbAiStructureInfo 将公告正文等文本抽取出主体、金额、时间等结构化字段。

边界与注意事项

数据非全量：所有搜索接口均支持分页（如 searchProjectApi 单页上限 50 条）。在未获取全部分页数据前，不应计算市场份额或做出“无相关项目”的绝对判断。
角色鉴别：companyName 字段仅表明企业参与，不直接代表其甲方或乙方角色，需通过结构化详情二次确认。
信息时效性：拟在建项目数据（接口使用 publishtime 参数）与附件数据（使用 publishTime）的时间参数名不一致，调用时需注意区分。
合规使用：通过 companyProfileContacts 等获取的企业联系人信息，需在使用时遵守相关隐私与通信法规。