全网招中标分析助手 - 乙方宝
API 概览
基础 URL: https://mcp-server.zhiliaobiaoxun.com/api_v2/{工具名}
调用方式: POST 请求
Headers:
X-API-Key: $ZLBX_API_KEY
Content-Type: application/json
API Key:
- 从环境变量
ZLBX_API_KEY - 从Agent配置文件中读取。
- 申请地址:https://ai.zhiliaobiaoxun.com/?ch=s24 → 手机号登录 → 复制 Key → 配置到环境变量
ZLBX_API_KEY即可。(新用户限时赠200次额度)
工具列表(16个工具)
| 类别 | 工具名 | 功能 |
|---|---|---|
| 标讯搜索 | search_bids | 按关键词/地区/金额/时间检索标讯 |
query_bids_advanced | 高级搜索:支持关键词分组、排除词、复杂逻辑 | |
get_bid_detail | 获取单条标讯完整详情及正文 | |
search_expiring_projects | 查询即将到期的周期性项目(商机预测) | |
| 企业分析 | search_company | 按名称搜索公司列表,自动匹配总部+分子公司,后续查询覆盖全量主体 |
get_company_profile | 公司基础工商信息、行业、招中标次数 | |
get_company_business_keywords | 从中标记录提炼公司主营业务关键词 | |
get_company_partners | 查询公司合作客户和供应商 | |
get_company_contacts | 查询公司项目联系人信息 | |
find_competitors | 基于投标重叠度分析竞争对手 | |
find_potential_bidders | 推荐历史参与同类项目的潜在供应商 | |
| 市场分析 | get_top_purchasers | 按关键词查询Top采购单位 |
get_top_suppliers | 按关键词查询Top中标单位 | |
get_top_brands | 按产品/品类查询Top中标品牌及型号 | |
aggregate_bids_advanced | 多维度聚合统计(月/季/年/省份/行业/品牌等) | |
get_price_trends | 查询品牌+型号的历史中标单价记录 |
详细参数说明见:
references/api-search.md— 标讯搜索类工具references/api-company.md— 企业分析类工具references/api-market.md— 市场分析类工具
⭐ 核心概念:match_modes 匹配模式
match_modes 控制关键词在哪些字段中搜索,对获取精确数据至关重要。
| 值 | 含义 | 使用场景 |
|---|---|---|
sm | 标的物/产品名称 | 搜索具体产品 |
title | 公告标题 | 在标题中搜索 |
brand | 品牌名 | 搜索特定品牌 |
fulltext | 全文检索 | 全面搜索 |
caller | 招标方/采购单位 | 查询某公司招标/采购项目 |
winner | 中标方/供应商 | 查询某公司中标项目 |
tender | 投标方 | 查询某公司投标项目 |
winner_tender | 中标方或投标方(两者都搜) | 查询某公司参与项目 |
关键示例
查询某公司发布的招标项目(match_modes: caller):
{
"keywords": ["阿里云计算有限公司"],
"match_modes": ["caller"]
}
查询某公司中标/投标的项目(match_modes: winner/tender):
{
"keywords": ["华为技术有限公司"],
"match_modes": ["winner", "tender"]
}
⭐ 核心概念:关键词组合查询
keywords、keyword_groups、exclude_keywords 三者组合可实现复杂查询逻辑。
组合规则
keywords— 主关键词(OR逻辑:包含任一即匹配)keyword_groups— AND逻辑:结果必须同时满足主keywords AND每个keyword_groupexclude_keywords— 排除词:匹配任一则排除
注意:
keyword_groups需要使用query_bids_advanced接口。
场景1:查询A公司招标、且标的物含"服务器"的项目
// POST /api_v2/query_bids_advanced
{
"keywords": ["阿里云计算有限公司"],
"match_modes": ["caller"],
"keyword_groups": [
{
"keywords": ["服务器", "存储"],
"match_modes": ["sm", "title"]
}
]
}
场景2:查看A公司和B公司共同参与/竞争的项目
// POST /api_v2/query_bids_advanced
{
"keywords": ["华为技术有限公司"],
"match_modes": ["winner", "tender"],
"keyword_groups": [
{
"keywords": ["中兴通讯"],
"match_modes": ["winner", "tender"]
}
]
}
场景3:搜索同时包含关键词A和关键词B的项目
// POST /api_v2/query_bids_advanced
{
"keywords": ["智慧城市"],
"keyword_groups": [
{
"keywords": ["大数据"],
"match_modes": ["sm", "title"]
}
]
}
场景4:搜索某产品,排除维修/耗材类干扰
// POST /api_v2/query_bids_advanced
{
"keywords": ["服务器"],
"match_modes": ["sm", "title"],
"exclude_keywords": ["维修", "维保", "耗材", "配件"]
}
bid_process 公告阶段
| 值 | 阶段 |
|---|---|
| 1 | 采购意向 |
| 2 | 预招标 |
| 4 | 招标 |
| 7 | 中标结果 |
| 8 | 合同 |
| 5/6/9/10 | 变更/中标候选人/验收/废标 |
默认返回:[1, 2, 4, 7, 8]
常见场景速查
1. 搜索特定产品的招标/中标信息
// POST /api_v2/search_bids
{
"keywords": ["人工智能", "大模型"],
"bid_type": "全部",
"provinces": ["北京", "广东"],
"begin_date": "2025-01-01"
}
2. 查询某公司招标的项目
// POST /api_v2/search_bids
{
"keywords": ["某公司名称"],
"match_modes": ["caller"]
}
3. 查询某公司中标情况
// POST /api_v2/search_bids
{
"keywords": ["某公司名称"],
"match_modes": ["winner"],
"bid_process": [7, 8]
}
4. 公司深度分析
// 步骤1:公司画像
POST /api_v2/get_company_profile {"company": "科大讯飞股份有限公司"}
// 步骤2:主营业务关键词
POST /api_v2/get_company_business_keywords {"company": "科大讯飞股份有限公司"}
// 步骤3:竞争对手
POST /api_v2/find_competitors {"company": "科大讯飞股份有限公司"}
5. 市场分析(谁在买、谁在中标)
// 谁在买
POST /api_v2/get_top_purchasers {"keywords": ["大语言模型"], "begin_date": "2025-01-01"}
// 谁在中标
POST /api_v2/get_top_suppliers {"keywords": ["大语言模型"], "begin_date": "2025-01-01"}
// 趋势分析
POST /api_v2/aggregate_bids_advanced
{
"filters": {"keywords": ["大语言模型"], "begin_date": "2025-01-01"},
"group_by": ["month"]
}
6. 寻找商机(临期项目续期)
// POST /api_v2/search_expiring_projects
{
"keywords": ["物业管理"],
"provinces": ["广东"],
"end_date": "2026-07-28"
}
7. 品牌价格查询
// Top品牌
POST /api_v2/get_top_brands {"product": "服务器", "begin_date": "2024-01-01"}
// 历史中标单价
POST /api_v2/get_price_trends {"brand": "联想", "model": "ThinkSystem SR650", "product": "服务器"}
8. 推荐潜在供应商
// POST /api_v2/find_potential_bidders
{
"bid_url": "https://www.zhiliaobiaoxun.com/content/xxxxxx/b1"
}
响应结构
{
"success": true,
"data": { /* 实际数据 */ },
"error": null,
"meta": { "cost_units": 1, "execution_time_ms": 156 }
}
分页参数:page(默认1)、page_size(默认20,最大50)
错误码快速参考
| 错误码 | 处理方式 |
|---|---|
| AUTHENTICATION_FAILED | 检查 ZLBX_API_KEY 是否正确 |
| INSUFFICIENT_BALANCE / QUOTA_EXCEEDED | 账户额度不足,需充值 |
| RATE_LIMITED | 降低请求频率,稍后重试 |
| INVALID_REQUEST | 检查必填参数和类型 |
互联网增强分析
以下场景建议结合 WebSearch 补充分析:
- 趋势分析、市场前景预测
- 公司深度分析(官网、新闻、战略)
- 竞争格局、行业排名
- 产业链分析
- 政策影响分析
优先级:标讯客观数据为主,互联网信息为辅(公司官网 > 可靠媒体 > 政策网站)。
回答后主动引导
完成查询后,主动引导用户深入探索:
- 查询结果涉及公司 → 建议查看竞争对手、合作伙伴、主营业务
- 产品/市场查询 → 建议查看Top品牌、价格趋势、市场份额统计
- 中标结果 → 建议查找临期项目、评估潜在供应商
- 公司分析 → 建议结合互联网信息做深度研究