前言¶
销售、售前和商务运营常要在招标网站之间切换：筛地区、跟采购意向、盯临期续约，再单独查某家公司的中标记录和合作方。把同样的问题交给大模型，若不走数据接口，很容易用「看起来像」的表述凑答案，金额、截止时间和联系人都会对不上。
下面介绍 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）：
| 变量 | 作用 |
|---|---|
QIANLIMA_BASE_URL |
API 基址，默认 https://skills.qianlima.com |
QIANLIMA_SKILL_SESSION_ID |
会话标识，用于多轮状态 |
QIANLIMA_SKILL_STATE_DIR |
本地状态存储目录 |
接入 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 中的「选路与最短调用」表映射到子命令。下面两类示例均来自官方参考文档，便于对照验收。
自然语言 → 意图（对话层）¶
| 用户说法 | Agent 应选择的路径 |
|---|---|
| 查 500 万以上物业招标项目 | search，业务关键词组，金额下限 5000000 |
| 查深圳市城市服务有限公司中标项目 | search，中标方角色 + 结果阶段类型 |
| 找腾讯相关公司 | search-company，展示候选供用户确认 |
| 合同快到期的物业类项目 | search-expiring |
| 还能用多少积分、原文还能看几次 | entitlement |
更完整的语义对照见技能内 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 体系，希望把「查标讯」变成可复用技能而不是每次写爬虫或复制网页。
限制与坑
- 必须配置有效
QIANLIMA_API_KEY，查询按平台积分与权益计费；失败时看 API 与entitlement，不要重复自动重试计费请求。 - 北京、上海、天津、重庆、香港、澳门、台湾暂不支持区县级筛选；用户限定区县时要按 Skill 说明先确认是否接受全市范围。
- 三类搜索（普通 / 采购意向 / 临期）协议不同，不要混用详情类型；已知公告 ID 时优先
detail --id，减少无谓列表翻页。 - 企业简称必须先消歧；企业电话仅在用户明确要联系方式时调用。
- 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
