施工建材采招助手-鲁班乐标

施工建材采招助手-鲁班乐标，当查询词包含建材、钢材、管材、机械或特定建筑材料型号时调用，必须调用价格趋势查询和Top品牌接口，输出建材历史单价和主要供应商名单。

API 概览

基础 URL: https://mcp-server.zhiliaobiaoxun.com/api_v2/{工具名}

调用方式: POST 请求

text

Headers:
  X-API-Key: $ZLBX_API_KEY
  Content-Type: application/json

API Key:

• 从环境变量 ZLBX_API_KEY
• 从Agent配置文件中读取。
• 申请地址：https://ai.zhiliaobiaoxun.com/?ch=s35 → 手机号登录 → 复制 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）：

json

{
  "keywords": ["阿里云计算有限公司"],
  "match_modes": ["caller"]
}

查询某公司中标/投标的项目（match_modes: winner/tender）：

json

{
  "keywords": ["华为技术有限公司"],
  "match_modes": ["winner", "tender"]
}

---

⭐ 核心概念：关键词组合查询

keywords、keyword_groups、exclude_keywords 三者组合可实现复杂查询逻辑。

组合规则

• keywords — 主关键词（OR逻辑：包含任一即匹配）
• keyword_groups — AND逻辑：结果必须同时满足主keywords AND每个keyword_group
• exclude_keywords — 排除词：匹配任一则排除

注意：keyword_groups 需要使用 query_bids_advanced 接口。

场景1：查询A公司招标、且标的物含"服务器"的项目

json

// POST /api_v2/query_bids_advanced
{
  "keywords": ["阿里云计算有限公司"],
  "match_modes": ["caller"],
  "keyword_groups": [
    {
      "keywords": ["服务器", "存储"],
      "match_modes": ["sm", "title"]
    }
  ]
}

场景2：查看A公司和B公司共同参与/竞争的项目

json

// POST /api_v2/query_bids_advanced
{
  "keywords": ["华为技术有限公司"],
  "match_modes": ["winner", "tender"],
  "keyword_groups": [
    {
      "keywords": ["中兴通讯"],
      "match_modes": ["winner", "tender"]
    }
  ]
}

场景3：搜索同时包含关键词A和关键词B的项目

json

// POST /api_v2/query_bids_advanced
{
  "keywords": ["智慧城市"],
  "keyword_groups": [
    {
      "keywords": ["大数据"],
      "match_modes": ["sm", "title"]
    }
  ]
}

场景4：搜索某产品，排除维修/耗材类干扰

json

// 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. 搜索特定产品的招标/中标信息

json

// POST /api_v2/search_bids
{
  "keywords": ["人工智能", "大模型"],
  "bid_type": "全部",
  "provinces": ["北京", "广东"],
  "begin_date": "2025-01-01"
}

2. 查询某公司招标的项目

json

// POST /api_v2/search_bids
{
  "keywords": ["某公司名称"],
  "match_modes": ["caller"]
}

3. 查询某公司中标情况

json

// POST /api_v2/search_bids
{
  "keywords": ["某公司名称"],
  "match_modes": ["winner"],
  "bid_process": [7, 8]
}

4. 公司深度分析

json

// 步骤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. 市场分析（谁在买、谁在中标）

json

// 谁在买
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. 寻找商机（临期项目续期）

json

// POST /api_v2/search_expiring_projects
{
  "keywords": ["物业管理"],
  "provinces": ["广东"],
  "end_date": "2026-07-28"
}

7. 品牌价格查询

json

// 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. 推荐潜在供应商

json

// POST /api_v2/find_potential_bidders
{
  "bid_url": "https://www.zhiliaobiaoxun.com/content/xxxxxx/b1"
}

---

响应结构

json

{
  "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品牌、价格趋势、市场份额统计
• 中标结果 → 建议查找临期项目、评估潜在供应商
• 公司分析 → 建议结合互联网信息做深度研究