前言¶

做区域市场或行业研究时，常见做法是在招标网站里手工筛公告、导出表格再透视。口径容易随页面筛选变化，全量翻页也费时。若希望 Agent 按固定维度（行业、地区、时间、项目与采购分类、金额区间）拉齐统计，并把「只查到总数」和「分页样本」说清楚，需要一套写进 Skill 的流程与接口约定。下面介绍世舶科技在 SkillHub 分发的「招投标行业情报分析」能力，以及安装、配置和典型分析路径。

这是什么¶

招投标行业情报分析【世舶科技】 是世舶科技旗下保标招标网提供的招投标数据分析 Skill：按行业、地区、时间、项目分类、采购分类、项目金额等维度，对招标公告、中标公告、合同公告、政府采购、工程建设项目和企业采购数据做统计分析，用于观察市场规模、采购趋势、区域分布、行业热度、客户结构和金额变化。

出品方为世舶科技；官方分发地址为 https://api.skillhub.cn/sbkj-bid/sbkj-official-en。在 SkillHub 社区中，该 Skill 归类为 data-analysis，SkillHub 评分 7861，下载量 38572 次（以上指标来自 SkillHub 列表信息）。

Skill 的目标是用统一口径统计指定行业的招投标数量、金额、地区、信息类型、采购类型和参与企业，形成可复核的市场分析，并明确区分完整统计、分页汇总和样本分析。

核心功能¶

结合 Skill 说明，已核实的能力包括：

1. 多维筛选与统计：行业、地区、时间、项目分类、采购分类、项目金额等维度下的数量与结构分析。
2. 数据类型覆盖：招标公告、中标公告、合同公告，以及政府采购、工程建设项目、企业采购等相关数据视角。
3. 行业编码推理：用户只提供行业名称或产品关键词时，先通过 AI 行业搜索将短语映射为一级、二级、三级行业编码，再选定口径。
4. 招中标统计与明细：支持先查总量（pageNumber=0 仅返回 total），再分页拉取明细做金额、企业排行与项目结构分析。
5. 合同分析：在合同视角下分析合同周期、金额及甲乙方关系，支持按合同结束时间、甲乙方名称等条件筛选。
6. 指标与报告规范：项目数按 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 约定读取环境变量：

未配置密钥时不应继续调用接口。密钥获取入口（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 按需读取。

适用场景与注意¶

适合谁

• 行业研究、区域市场分析、招采趋势与市场容量观察。
• 客户结构、采购需求洞察、竞争格局判断及企业经营决策前的数据摸底。
• 销售拓客、投标决策、渠道布局、采购寻源与市场规划前的结构化统计。

使用注意

1. 商业数据与 Key：依赖保标招标网数据与 API 额度，需自行申请并配置 BBIAO_API_KEY。
2. 分页与样本：未翻页拉全量时，结论应标注为样本分析；市场份额类指标仅在分母范围明确且明细完整时计算。
3. 金额缺失：部分公告无明确金额，合计时需同时报告有金额项目数与缺失率。
4. 官方地址访问：浏览器直接打开 https://api.skillhub.cn/sbkj-bid/sbkj-official-en 可能返回 HTTP 405，属接口分发地址；安装与更新请以 SkillHub 包名 @sbkj-bid/sbkj-official-en 及 skillhub.cn/install/skillhub.md 为准。
5. 前台页面状态：SkillHub 技能详情页 sbkj-official-en 若显示「不存在或已下线」，以官方分发包与 CLI 安装结果为准，必要时联系世舶科技商务支持（Skill 文档载明联系人张瑛，电话 18986107388）。

结尾¶

「招投标行业情报分析【世舶科技】」把招采数据的筛选维度、网关接口调用顺序和统计口径写进 Agent Skill，减少手工导表带来的口径漂移，并在分页未全覆盖时强制区分样本与全量结论。安装与目录配置遵循 SkillHub 官方文档；数据侧需自备保标 API Key。官方分发地址：https://api.skillhub.cn/sbkj-bid/sbkj-official-en