前言¶
做区域市场或行业研究时，常见做法是在招标网站里手工筛公告、导出表格再透视。口径容易随页面筛选变化，全量翻页也费时。若希望 Agent 按固定维度（行业、地区、时间、项目与采购分类、金额区间）拉齐统计，并把「只查到总数」和「分页样本」说清楚，需要一套写进 Skill 的流程与接口约定。下面介绍世舶科技在 SkillHub 分发的「招投标行业情报分析」能力，以及安装、配置和典型分析路径。
这是什么¶
招投标行业情报分析【世舶科技】 是世舶科技旗下保标招标网提供的招投标数据分析 Skill：按行业、地区、时间、项目分类、采购分类、项目金额等维度，对招标公告、中标公告、合同公告、政府采购、工程建设项目和企业采购数据做统计分析，用于观察市场规模、采购趋势、区域分布、行业热度、客户结构和金额变化。
出品方为世舶科技；官方分发地址为 https://api.skillhub.cn/sbkj-bid/sbkj-official-en。在 SkillHub 社区中，该 Skill 归类为 data-analysis，SkillHub 评分 7861，下载量 38572 次（以上指标来自 SkillHub 列表信息）。
Skill 的目标是用统一口径统计指定行业的招投标数量、金额、地区、信息类型、采购类型和参与企业，形成可复核的市场分析，并明确区分完整统计、分页汇总和样本分析。
核心功能¶
结合 Skill 说明，已核实的能力包括：
- 多维筛选与统计：行业、地区、时间、项目分类、采购分类、项目金额等维度下的数量与结构分析。
- 数据类型覆盖：招标公告、中标公告、合同公告，以及政府采购、工程建设项目、企业采购等相关数据视角。
- 行业编码推理：用户只提供行业名称或产品关键词时，先通过 AI 行业搜索将短语映射为一级、二级、三级行业编码，再选定口径。
- 招中标统计与明细：支持先查总量（
pageNumber=0仅返回total），再分页拉取明细做金额、企业排行与项目结构分析。 - 合同分析：在合同视角下分析合同周期、金额及甲乙方关系，支持按合同结束时间、甲乙方名称等条件筛选。
- 指标与报告规范：项目数按
id + publishTime去重；金额合计仅汇总可解析的明确金额并报告缺失率；同比/环比要求区间长度一致；未拉全量明细时须标注样本分析，避免写成完整市场份额。
对外部 HTTP 接口（经保标网关）主要包括：
POST /outer-gateway/bid/industryReasoning：行业编码推理。POST /outer-gateway/bid/searchProjectApi：招中标数量与明细。POST /outer-gateway/bid/searchProjectContactApi：合同数据搜索。
调用约定：UTF-8 JSON POST；标讯搜索单页明细不超过 50 条，合同搜索单页不超过 100 条；需要全量时按 hasNext 翻页并记录实际条数。
安装与启用¶
Skill 基于通用 SKILL.md 格式，通过 SkillHub CLI 安装到当前 Agent 的 skills 目录（装错目录会导致 Agent 无法加载）。
1、安装 SkillHub CLI（未安装时）¶
先检查是否已有 CLI：
command -v skillhub && skillhub --version
未安装时，可按 SkillHub 官方安装文档执行完整安装（CLI + 默认 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
仅安装 CLI：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
说明见：https://skillhub.cn/install/skillhub.md
2、安装本 Skill¶
官方安装提示为：根据 https://skillhub.cn/install/skillhub.md 安装包 @sbkj-bid/sbkj-official-en（与官方路径 sbkj-bid/sbkj-official-en 一致）。
安装时必须用 --dir 指向当前环境的 skills 目录，例如：
skillhub install @sbkj-bid/sbkj-official-en --dir ~/.cursor/skills/
其他常见 Agent 的 skills 路径（摘自 SkillHub 安装文档）：
- Claude Code：
~/.claude/skills/ - Cursor：
~/.cursor/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
安装后按所用 Client 的要求重启或刷新 Agent，使 Skill 生效。
3、配置 API Key¶
本 Skill 需配置世舶科技（保标）API Key，按 Skill 约定读取环境变量：
| 变量 | 作用 |
|---|---|
BBIAO_API_KEY |
API 密钥 |
BBIAO_SERVER_URL |
网关地址；未配置时默认 https://gate.gov-bid.com |
未配置密钥时不应继续调用接口。密钥获取入口（Skill 原文）：https://apiyx.gov-bid.com/?share=eyJjb2RlIjoic2Jrai1qaG5tdDF0NyJ9
额度不足时，Skill 指向充值页：https://console.api.gov-bid.com/bbiao-gateway/package
注意：不要在日志、报错或完整请求 URL 中暴露真实密钥；优先使用平台凭据库或用户级环境变量保存。
典型用法¶
下面步骤对应 Skill 内建议的执行流程，可在 Agent 对话中用自然语言描述分析需求，由 Skill 驱动接口调用。
1、明确分析口径¶
先收集或确认：行业名称/产品关键词、地区、开始与结束日期、比较周期、信息分类、采购分类、金额区间、企业范围及期望指标。不同口径的结果不宜直接对比。
2、行业映射（仅给行业名时）¶
请求行业推理接口，例如关键词「医疗器械」：
POST /outer-gateway/bid/industryReasoning
Content-Type: application/json
{"keyword": "医疗器械"}
从返回中读取候选的 fullTitle、minTitle、firstCodeList、secondCodeList、thirdCodeList，并说明最终采用的编码层级。
3、数量统计¶
对招中标数据使用 searchProjectApi，将 pageNumber 设为 0 仅获取 total；筛选字段包括 startDate、endDate、pageId、searchType，以及 industryCode、areaCode、keyword、projectClassID、purchaseTypeID、projectMoneyMin、projectMoneyMax 等。
4、明细与聚合¶
需要金额结构、企业排行或项目结构时，将 pageNumber 设为 1–50 分页抓取，去除 HTML 标签，按 id + publishTime 去重，再按时间、地区、分类、金额区间、甲乙方聚合。
5、合同视角（可选）¶
调用 searchProjectContactApi，可使用 contractEndMin、contractEndMax、partAName、partBName、companyName 等字段，结合合同起止与项目周期做补充分析。
6、输出报告¶
按 Skill 约定依次给出：分析口径、数据覆盖、核心结论、趋势表、地区结构、分类结构、金额结构、甲乙方排行、代表项目与风险提示；样本分析须写明样本量、页数与数据截止时间。
更细的字段与枚举见 Skill 包内 references/ 下的参数说明文档（如 Parameter-Description.md、search-project-api.md 等），执行前由 Agent 按需读取。
适用场景与注意¶
适合谁
- 行业研究、区域市场分析、招采趋势与市场容量观察。
- 客户结构、采购需求洞察、竞争格局判断及企业经营决策前的数据摸底。
- 销售拓客、投标决策、渠道布局、采购寻源与市场规划前的结构化统计。
使用注意
- 商业数据与 Key：依赖保标招标网数据与 API 额度，需自行申请并配置
BBIAO_API_KEY。 - 分页与样本：未翻页拉全量时，结论应标注为样本分析；市场份额类指标仅在分母范围明确且明细完整时计算。
- 金额缺失：部分公告无明确金额，合计时需同时报告有金额项目数与缺失率。
- 官方地址访问：浏览器直接打开
https://api.skillhub.cn/sbkj-bid/sbkj-official-en可能返回 HTTP 405，属接口分发地址；安装与更新请以 SkillHub 包名@sbkj-bid/sbkj-official-en及skillhub.cn/install/skillhub.md为准。 - 前台页面状态：SkillHub 技能详情页
sbkj-official-en若显示「不存在或已下线」，以官方分发包与 CLI 安装结果为准，必要时联系世舶科技商务支持（Skill 文档载明联系人张瑛，电话 18986107388）。
结尾¶
「招投标行业情报分析【世舶科技】」把招采数据的筛选维度、网关接口调用顺序和统计口径写进 Agent Skill，减少手工导表带来的口径漂移，并在分页未全覆盖时强制区分样本与全量结论。安装与目录配置遵循 SkillHub 官方文档；数据侧需自备保标 API Key。官方分发地址：https://api.skillhub.cn/sbkj-bid/sbkj-official-en
