前言¶
接入招投标数据时，常见路径是先读接口文档，再手工拼 UTF-8 JSON 的 POST 请求体：地区、时间窗、公告类型、关键词往往要拆成多个字段。业务同事更习惯用一句话描述需求，开发侧却要反复对照参数表改写。若还要串联招标、中标、合同、附件等多个接口，出错点和沟通成本都会上去。
下面介绍 SkillHub 上的「招投标自然语言搜索助手」，让 Agent 在对话里理解查标意图，按技能说明选择并调用对应接口，并处理请求体与响应解析。
这是什么¶
招投标自然语言搜索助手（坐标 @org-mbvufw6y/bid-natural-language-search-assistant，当前版本 1.0.4）是面向 business-ops 的企业级 Skill，发布者为 精英量界，来源标注为 enterprise。
官方简介将其定位为招投标数据 API 调用助手：覆盖招标、中标、采购意向、合同公告、项目详情与附件、拟在建项目、企业画像及 自然语言查标 等 20 个接口；按需求选择或串联接口，生成 UTF-8 JSON POST 请求体，并解析响应与错误码。标签 requires_api_key=true，使用前需准备招投标数据 API 的密钥（具体申请方式以数据服务方文档为准）。
SkillHub 页面：https://www.skillhub.cn/skills/org-mbvufw6y/bid-natural-language-search-assistant
API 坐标页：https://api.skillhub.cn/org-mbvufw6y/bid-natural-language-search-assistant
核心功能¶
以下能力均来自 SkillHub 官方页面与抓取元数据，不展开未在资料中出现的字段数量或第三方品牌归属。
-
自然语言查标
在 Agent 对话中用业务语言描述检索目标，由 Skill 引导改写为可执行的 API 条件并发起查询（与手工对照文档拼 JSON 相比，条件生成由 Agent 按技能规范完成）。 -
多类公告与项目数据
技能说明覆盖招标、中标、采购意向、合同公告、拟在建项目等类型，并支持项目详情、附件及企业画像相关接口。 -
接口编排与请求构造
按场景选择单个接口或串联多个接口，输出符合要求的 POST 请求体（UTF-8 JSON），并说明如何解读返回与错误码。 -
面向 API 不熟的用户
目标用户包括需要快速完成招投标数据查询与接入、但不熟悉底层 HTTP 细节的开发者或实施人员。
安装与启用¶
1、安装 SkillHub CLI（若尚未安装）¶
先检查本机是否已有 skillhub：
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
2、安装本 Skill 到当前 Agent 的 skills 目录¶
安装时必须用 --dir 指向当前客户端识别的 skills 目录，否则默认落在 ./skills/ 可能无法被 Agent 加载。
skillhub install @org-mbvufw6y/bid-natural-language-search-assistant --dir <你的 skills 目录>
常用路径示例（以 SkillHub 安装文档为准）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
也可将下面提示词发给已支持 Skill 安装的 AI，让其按官方安装说明拉取本技能：
请根据 https://skillhub.cn/install/skillhub.md，安装 `@org-mbvufw6y/bid-natural-language-search-assistant`。
3、配置 API Key¶
技能标记为需要 API Key。在 Agent 或环境变量中按你所用招投标数据服务的说明配置密钥后，再在对话中发起查标请求。
典型用法¶
经过上面的安装与密钥配置，可在 Cursor、Claude Code 等客户端中直接用自然语言描述检索需求，由 Agent 加载本 Skill 后完成接口选择与请求构造。官方资料未给出固定「示例响应」文本，下列为与技能定位一致的 对话式提问方式（需已配置有效 API Key）：
- 说明时间与地域、品类，例如希望查询某一时间段、某一省份的教育类设备采购 中标 信息。
- 说明主体维度，例如查询某公司名称关联的弱电类 招标 / 中标 记录。
- 说明行业与地区，例如某地医院的 信息化招标 公告。
Agent 应依据 SKILL 内对接口与参数的定义，生成 POST 请求并回传结构化结果或错误码说明。若返回鉴权失败，先核对 Key 与接口权限，再缩小查询条件重试。
适用场景与注意¶
适合谁
- 需要把招投标数据 API 接到内部系统、报表或商机流程，但不想每次手写 JSON 的开发者。
- 政府采购网、全行业招投标检索类产品中，负责对接数据层、又希望用对话快速试条件的实施人员。
- 希望在同一对话里串联「查公告 → 看详情 → 拉附件」等多步接口的场景。
使用注意
- 企业级与密钥：
enterprise来源且requires_api_key=true，无 Key 无法完成真实查询。 - 版本：撰写时 SkillHub 显示版本为 1.0.4；升级可用
skillhub对同一坐标执行更新，并确认--dir与当前 Agent 一致。 - 数据与合规：检索范围、字段含义以所对接的招投标数据 API 文档为准；本 Skill 负责调用方式与解析指引，不替代数据源的使用协议。
- 社区指标：SkillHub 页面显示评分 100000、下载约 3059 次（随平台更新变化），选型时可结合自身 API 合约与试查结果判断。
结尾¶
招投标自然语言搜索助手把「口语化查标」和「20 个招投标相关 API 的选型、拼包、解析」收敛进一套 Agent Skill，减少反复翻文档和手工拼 JSON 的时间。若你要在 Cursor 等环境里试装，可从官方 Skill 页与安装文档入手：
https://www.skillhub.cn/skills/org-mbvufw6y/bid-natural-language-search-assistant
