CLI 使用说明
知了标讯 CLI 工具的完整命令参考，包含全部命令的参数和使用示例。
基本语法
zlbx <command> [options]全局选项
| 选项 | 说明 |
|---|---|
| -h, --help | 显示帮助信息 |
| -v, --version | 显示版本信息 |
| -f, --format | 输出格式：json（默认）、jsonl、yaml、explore |
| -t, --transform | GJSON 路径转换，用于筛选输出字段 |
| -o, --output | 输出到文件 |
| --json | 通过 JSON 格式传递所有参数 |
| list | 列出所有可用命令 |
搜索类命令
search-bids - 搜索招中标公告
支持关键词、地区、时间、金额等多维度筛选。
# 基本搜索
zlbx search-bids --keywords '["服务器"]' --begin-date "2024-01-01"
# 多关键词 + 匹配模式
zlbx search-bids --keywords '["大模型", "人工智能"]' --match-modes '["sm", "title"]'
# 指定地区和金额范围
zlbx search-bids --keywords '["医疗设备"]' --provinces '["北京"]' --min-amount 100000
# 分页查询
zlbx search-bids --keywords '["服务器"]' --page 2 --page-size 50| 参数 | 说明 |
|---|---|
| --keywords* | 搜索关键词列表 |
| --match-modes | 匹配模式（sm:标的物, title:标题, brand:品牌, caller:招标方, winner:中标方） |
| --bid-type | 公告类型（招标/中标/全部） |
| --bid-process | 公告阶段 |
| --begin-date | 开始日期 YYYY-MM-DD |
| --end-date | 结束日期 YYYY-MM-DD |
| --provinces | 省份列表 |
| --cities | 城市列表 |
| --counties | 区县列表 |
| --min-amount | 最低金额（元） |
| --max-amount | 最高金额（元） |
| --page | 页码 |
| --page-size | 每页数量 |
| --need-contacts | 是否返回联系人 |
| --need-fulltext | 是否返回公告原文 |
search-expiring - 查询即将到期项目
适用于寻找续签商机、跟进潜在客户。
zlbx search-expiring --keywords '["物业管理"]' --begin-date "2024-06-01"| 参数 | 说明 |
|---|---|
| --keywords* | 产品/服务关键词 |
| --begin-date | 到期开始日期 |
| --end-date | 到期结束日期 |
| --provinces | 省份列表 |
| --cities | 城市列表 |
| --counties | 区县列表 |
| --min-amount | 最低金额（元） |
| --company-type | 招标公司类型 |
| --page | 页码 |
| --page-size | 每页数量 |
公司类命令
company-profile - 查询公司信息
查询公司基本信息和画像，包括注册信息、行业分类、规模等。
zlbx company-profile --company "华为"| 参数 | 说明 |
|---|---|
| --company | 公司名称或ID |
| --company-url | 知了标讯公司详情页链接 |
company-partners - 查询公司合作伙伴
查询指定公司的客户或供应商列表。
zlbx company-partners --company "华为" --partner-type "客户" --limit 50| 参数 | 说明 |
|---|---|
| --company | 公司名称或ID |
| --company-url | 知了标讯公司详情页链接 |
| --partner-type* | 合作方类型（客户/供应商/全部） |
| --begin-date | 统计开始日期 |
| --end-date | 统计结束日期 |
| --provinces | 省份列表 |
| --cities | 城市列表 |
| --keywords | 产品关键词过滤 |
| --min-amount | 最低合作金额（元） |
| --limit | 返回数量 |
company-keywords - 查询公司业务关键词
通过分析中标项目的标的物，了解公司业务范围。
zlbx company-keywords --company "华为" --limit 20| 参数 | 说明 |
|---|---|
| --company | 公司名称或ID |
| --company-url | 知了标讯公司详情页链接 |
| --begin-date | 统计开始日期 |
| --end-date | 统计结束日期 |
| --provinces | 省份列表 |
| --cities | 城市列表 |
| --limit | 返回数量 |
company-contacts - 查询公司联系人
从公司相关的招中标公告中提取联系人信息。
zlbx company-contacts --company "华为" --keywords '["服务器"]' --limit 10| 参数 | 说明 |
|---|---|
| --company | 公司名称或ID |
| --company-url | 知了标讯公司详情页链接 |
| --keywords | 筛选关键词 |
| --match-modes | 搜索范围 |
| --begin-date | 筛选开始日期 |
| --end-date | 筛选截止日期 |
| --role | 联系人类型（0:全部, 1:招标, 2:中标） |
| --limit | 返回数量 |
分析类命令
top-brands - Top 中标品牌
根据产品查询中标品牌排行。
zlbx top-brands --product "呼吸机" --limit 10| 参数 | 说明 |
|---|---|
| --product* | 产品名称 |
| --exclude-keywords | 排除关键词 |
| --min-price | 最低价格（元） |
| --max-price | 最高价格（元） |
| --begin-date | 统计开始日期 |
| --end-date | 统计结束日期 |
| --provinces | 省份列表 |
| --cities | 城市列表 |
| --counties | 区县列表 |
| --limit | 返回品牌数量 |
price-trends - 价格趋势分析
查询指定品牌/型号的历史中标价格趋势。
zlbx price-trends --brand "联想" --model "ThinkPad" --limit 50| 参数 | 说明 |
|---|---|
| --brand* | 品牌名称 |
| --model | 型号 |
| --product | 产品类别 |
| --exclude-keywords | 排除关键词 |
| --min-price | 最低价格（元） |
| --max-price | 最高价格（元） |
| --begin-date | 统计开始日期 |
| --end-date | 统计结束日期 |
| --provinces | 省份列表 |
| --cities | 城市列表 |
| --counties | 区县列表 |
| --limit | 返回记录数量 |
top-purchasers - Top 采购单位
根据业务关键词筛选主要采购单位。
zlbx top-purchasers --keywords '["服务器"]' --limit 20| 参数 | 说明 |
|---|---|
| --keywords* | 业务关键词 |
| --match-modes | 匹配模式 |
| --begin-date | 开始日期 |
| --end-date | 结束日期 |
| --provinces | 省份列表 |
| --cities | 城市列表 |
| --exclude-keywords | 排除关键词 |
| --min-amount | 最低金额（元） |
| --max-amount | 最高金额（元） |
| --limit | 返回数量 |
| --sort-field | 排序字段（count/amount/pub_time） |
top-suppliers - Top 中标供应商
根据业务关键词筛选主要中标供应商。
zlbx top-suppliers --keywords '["服务器"]' --limit 20| 参数 | 说明 |
|---|---|
| --keywords* | 业务关键词 |
| --match-modes | 匹配模式 |
| --begin-date | 开始日期 |
| --end-date | 结束日期 |
| --provinces | 省份列表 |
| --cities | 城市列表 |
| --exclude-keywords | 排除关键词 |
| --min-amount | 最低金额（元） |
| --max-amount | 最高金额（元） |
| --limit | 返回数量 |
| --sort-field | 排序字段（count/amount/pub_time） |
potential-bidders - 潜在投标商推荐
根据招标项目推荐潜在供应商。
zlbx potential-bidders --bid-id 1234567890 --bid-type 1| 参数 | 说明 |
|---|---|
| --bid-id | 标讯ID |
| --bid-type | 公告类型（1:招标, 2:中标） |
| --bid-url | 知了标讯公告链接 |
| --uniq-key | 公告唯一标识 |
| --project-title | 项目标题 |
| --limit | 返回数量 |
competitors - 竞争对手分析
查询指定公司的竞争对手。
zlbx competitors --company "华为" --limit 20| 参数 | 说明 |
|---|---|
| --company | 公司名称或ID |
| --company-url | 知了标讯公司详情页链接 |
| --limit | 返回数量 |
高级工具
query-advanced - 高级标讯查询
支持所有字段组合的复杂查询。
# 使用 JSON 参数
zlbx query-advanced --json '{"keywords": ["服务器"], "bid_process": [4, 7], "page": 1}'
# 使用独立参数
zlbx query-advanced --keywords '["服务器"]' --begin-date "2024-01-01" --need-contacts true| 参数 | 说明 |
|---|---|
| --keywords | 关键词 |
| --match-modes | 匹配模式 |
| --keyword-groups | 关键词组（多组AND查询） |
| --bid-type | 公告类型 |
| --bid-process | 公告阶段 |
| --begin-date | 开始日期 |
| --end-date | 结束日期 |
| --provinces | 省份列表 |
| --cities | 城市列表 |
| --counties | 区县列表 |
| --min-money | 最低金额（元） |
| --max-money | 最高金额（元） |
| --exclude-keywords | 排除关键词 |
| --sort-field | 排序字段 |
| --sort-order | 排序方向 |
| --need-contacts | 是否返回联系人 |
| --need-fulltext | 是否返回公告原文 |
| --page | 页码 |
| --page-size | 每页数量 |
aggregate-advanced - 高级聚合统计
按任意维度进行统计分析。
# 按月统计
zlbx aggregate-advanced --group-by '["month"]' --filters '{"keywords": ["服务器"]}'
# 多维度聚合
zlbx aggregate-advanced --group-by '["month", "province"]' --metrics '["count", "sum_amount"]'| 参数 | 说明 |
|---|---|
| --filters | 筛选条件（JSON 格式） |
| --group-by* | 聚合维度（month/quarter/year/province/city/industry/brand/company_type/bid_method） |
| --metrics | 统计指标（count/sum_amount/avg_amount） |
| --compare-with | 对比类型（yoy:同比, qoq:环比） |
| --compare-period | 对比周期 |
bid-detail - 标讯详情
获取单个标讯的完整正文和附件内容。
zlbx bid-detail --bid-id 1234567890 --bid-type 1| 参数 | 说明 |
|---|---|
| --bid-id | 标讯ID |
| --bid-type | 公告类型（1:招标, 2:中标） |
| --bid-url | 知了标讯公告链接 |
| --uniq-key | 公告唯一标识 |
高级用法
输出格式
| 格式 | 说明 |
|---|---|
| json | 默认格式，格式化 JSON 输出 |
| jsonl | 每行一个 JSON 对象，适合流式处理 |
| yaml | YAML 格式输出 |
| explore | 交互式浏览模式，使用方向键导航，/ 搜索，q 退出 |
# JSON 格式（默认）
zlbx search-bids --keywords '["服务器"]' --format json
# JSONL 格式（适合流处理）
zlbx search-bids --keywords '["服务器"]' --format jsonl
# YAML 格式
zlbx search-bids --keywords '["服务器"]' --format yaml
# 交互式浏览
zlbx search-bids --keywords '["服务器"]' --format explore字段筛选（transform）
使用 GJSON 路径语法筛选输出字段，配合 --transform 参数：
# 只输出部分字段
zlbx search-bids --keywords '["服务器"]' --transform "{id,title,money}"
# 配合 JSONL 使用
zlbx search-bids --keywords '["服务器"]' --format jsonl --transform "{title,caller_name}"输出到文件
zlbx search-bids --keywords '["服务器"]' --output results.json
zlbx top-brands --product "呼吸机" --format yaml --output brands.yaml使用 JSON 参数
对于复杂查询，可以使用 --json 参数传递所有参数：
zlbx query-advanced --json '{
"keywords": ["服务器"],
"match_modes": ["sm"],
"begin_date": "2024-01-01",
"end_date": "2024-12-31",
"page": 1,
"page_size": 50
}'管道处理
配合其他命令使用，实现数据的进一步加工：
# 使用 jq 处理输出
zlbx search-bids --keywords '["服务器"]' --format jsonl | jq '.title'
# 统计数量
zlbx search-bids --keywords '["服务器"]' --format jsonl | wc -l
# 导入数据库
zlbx search-bids --keywords '["服务器"]' --format jsonl | psql -c "COPY bids FROM STDIN"