前言¶

销售、售前和商务运营常要在招标网站之间切换：筛地区、跟采购意向、盯临期续约，再单独查某家公司的中标记录和合作方。把同样的问题交给大模型，若不走数据接口，很容易用「看起来像」的表述凑答案，金额、截止时间和联系人都会对不上。

下面介绍 SkillHub 上的「招投标情报助手【千里马官方】」（技能 slug：qianlima-bidding-search，发布者标识 user_92d9d745）。它把千里马招标网侧的能力封装成 Agent Skill：标讯、采购意向、临期项目、企业情报和账号权益，都通过 scripts/qianlima_skill.py 调 API 取数；Skill 说明明确要求事实只来自脚本与接口响应，不要用模型记忆代替查询。

这是什么¶

一句话定位：面向招投标与企业情报查询的官方 Skill 包，用 Python 脚本对接千里马技能 API，供 Agent 在对话中按意图选命令并回传结构化结果。

维护与数据侧归属千里马体系（Skill 内账号入口指向千里马 AI 平台；接口默认基址为 https://skills.qianlima.com）。在 SkillHub 社区中，该技能分类为 business-ops，公开评分约 99548，下载约 560 次（数据来自 SkillHub 页面线索，以社区展示为准）。

SkillHub 列表名称可能显示为「招标信息查询｜千里马·乙方宝」等变体，与 slug qianlima-bidding-search 对应；安装时需使用命名空间 indiv-qianlima。

核心功能¶

以下能力均来自已安装的 Skill 包（SKILL.md、manifest.json 与能力参考文档），按用户意图分路由。

标讯与普通项目¶

适用于招标公告、中标公告、中标结果、成交公告、成交结果、候选人公示、查标讯、招标项目等。支持按关键词组、金额、时间、采购方式、资金性质、是否有附件等条件检索；指定采购方、中标方或代理机构时走普通项目 search，不必先拿企业 ID。

追问单条时可拉取联系人、截止时间、标的物、金额、代理机构、详情页或原文链接；还可按需读取正文（full-text）、附件（attachments）、招中标进展（timeline）。

采购意向¶

适用于采购意向、采购计划类查询。支持预算区间、预计采购时间、采购需求及详情页；详情与列表协议与普通项目分开，需使用 search-purchase 及对应的 --result-type。

临期项目与续约机会¶

适用于临期项目、合同快到期、临期续约机会。使用 search-expiring；详情侧支持临期项目自身字段与来源链接。

企业情报¶

适用于某公司中标项目、合作供应商、合作甲方、采购/中标地区分布、直接或潜在竞争对手、企业工商信息；在用户明确索要联系方式时使用企业联系人、企业电话能力。公司简称或品牌名先 search-company 消歧，不自动替用户选定排名第一的主体。

连续追问与权益¶

分页与改条件：next、refine；已知公告 ID 可直接 detail。会话状态依赖 follow_up.session_id / result_set_id，缓存失效时用 --context-json 恢复条件。

账号侧只读查询：当前可用积分、原文月度剩余次数与重置时间等，走 entitlement（对应用户关心的版本、服务地区、已开通权益、额度与重置时间类问题——具体字段以接口返回为准，Skill 说明积分接口不能替代完整套餐清单）。

事实边界（重要）¶

• 仅在需要调用项目、采购意向、临期项目、企业情报或权益接口时使用本 Skill；不要凭模型记忆回答标讯事实。
• 正常零结果、空字段按「未公示」处理；权限、积分、地区受限时保留 API 返回原因，不编造项目。
• 注册、API Key、充值入口固定为：https://ai.qianlima.com/?source=63f34880b4ff9d47269f7acc（须保留完整 URL 与 source 参数）。

安装与启用¶

运行环境要求 Python 3.10+（见 manifest.json）。

从 SkillHub 安装技能包¶

在已安装 SkillHub CLI 的机器上，执行：

skillhub install qianlima-bidding-search --namespace indiv-qianlima

默认会将技能目录落到当前环境下的 Skill 存储路径；也可指定目录，例如：

skillhub install qianlima-bidding-search --namespace indiv-qianlima --dir /path/to/your/skills

下载地址形如：https://api.skillhub.cn/api/v1/download?slug=qianlima-bidding-search&namespace=indiv-qianlima。

官方 Skill 页（API 域名）：https://api.skillhub.cn/user_92d9d745/qianlima-bidding-search。

配置 API Key 与环境变量¶

在 千里马账号平台 注册并获取 API Key 后，配置环境变量（Skill 运行时读取，勿写入对话或交付文档）：

export QIANLIMA_API_KEY="你的密钥"

可选变量（见 manifest.json）：

接入 Agent / IDE¶

manifest.json 标明兼容 OpenClaw ClawHub 目录、Agent Skills 的 SKILL.md 包及 SkillHub 风格目录。将安装后的整个技能文件夹挂到你所用 Agent 的 Skills 加载路径即可；Cursor、Codex CLI、Claude Code 的具体目录名因产品版本而异，以各产品当前「Skills / 技能」文档为准，本 Skill 包内未单独维护分客户端安装脚本。

启用后，Agent 应阅读技能根目录的 SKILL.md，在技能根目录调用：

python3 scripts/qianlima_skill.py <子命令> [参数]

典型用法¶

用户侧用自然语言即可；Agent 侧按 SKILL.md 中的「选路与最短调用」表映射到子命令。下面两类示例均来自官方参考文档，便于对照验收。

自然语言 → 意图（对话层）¶

更完整的语义对照见技能内 references/usage-examples.md、references/nl_parsing_examples.md。

命令行（地区解析示例）¶

地区编号须通过脚本解析，禁止手写猜测 areaIds：

cd /path/to/qianlima-bidding-search
python3 scripts/qianlima_skill.py area --name '北京、简阳'
python3 scripts/qianlima_skill.py area --name '朝阳区' --parent '北京'

仅当返回 resolution_status=resolved 时，才把 effective_query.areaIds 带入后续 search / search-purchase / search-expiring 请求。

多条件 search（JSON 查询体）¶

平铺 AND 条件可直接 search --query-json（摘自执行样板）：

{"keywordGroups":[{"keywords":["空调","新风"],"matchScopes":[2]},{"keywords":["安装","改造"],"matchScopes":[8]}],"fundsSources":[1],"hasAnnex":0}

嵌套 OR/AND 逻辑需先 preflight-complex 预检，只执行 approved_operations 中的操作，避免 Agent 自行拆成错误的多轮计费请求。

适用场景与注意¶

适合谁

• 需要在对话里查全国标讯、采购意向、临期续约线索的团队。
• 要做招投标视角竞品与客户分析（中标记录、合作方、地区分布、竞争对手、工商信息）。
• 已使用 SkillHub / Agent Skills 体系，希望把「查标讯」变成可复用技能而不是每次写爬虫或复制网页。

限制与坑

1. 必须配置有效 QIANLIMA_API_KEY，查询按平台积分与权益计费；失败时看 API 与 entitlement，不要重复自动重试计费请求。
2. 北京、上海、天津、重庆、香港、澳门、台湾暂不支持区县级筛选；用户限定区县时要按 Skill 说明先确认是否接受全市范围。
3. 三类搜索（普通 / 采购意向 / 临期）协议不同，不要混用详情类型；已知公告 ID 时优先 detail --id，减少无谓列表翻页。
4. 企业简称必须先消歧；企业电话仅在用户明确要联系方式时调用。
5. SkillHub 商店版本（如 CLI 安装的 1.1.2）与包内 manifest.json 版本号可能并存，以你本地安装目录文件为准升级。

结尾¶

招投标情报助手【千里马官方】把千里马标讯与企业情报 API 收敛成一套 Agent 可执行的命令与参考文档：查什么走哪条子命令、多轮怎么续、权益不足如何说明，都在 Skill 内写死边界，减少「模型幻觉式标讯」。

技能主页：https://api.skillhub.cn/user_92d9d745/qianlima-bidding-search
账号与 Key：https://ai.qianlima.com/?source=63f34880b4ff9d47269f7acc