← Back to Skills Marketplace
thuanlynham-stack

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

by wangppp · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ✓ Security Clean
125
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install construction-material-bid-assistant-lubanlebiao
Description
施工建材采招助手-鲁班乐标,当查询词包含建材、钢材、管材、机械或特定建筑材料型号时调用,必须调用价格趋势查询和Top品牌接口,输出建材历史单价和主要供应商名单。
README (SKILL.md)

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

API 概览

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

调用方式: POST 请求,Headers: X-API-Key: 你的API_KEY, Content-Type: application/json

API Key 配置:

  • 通过环境变量 ZLBX_API_KEY 获取 [推荐]
  • 申请地址:https://ai.zhiliaobiaoxun.com

现在注册立即赠送 200次免费调用额度,助您快速体验平台功能!

⚠️ 安全提示

  • 切勿在代码中硬编码 API Key

工具分类(15个工具)

类别 工具名 功能
标讯搜索 search_bids 常规搜索,按关键词、地区、金额、时间等检索
query_bids_advanced 高级搜索,支持关键词分组、排除词、复杂逻辑
get_bid_detail 获取单条标讯完整详情及正文
search_expiring_projects 查询即将到期的周期性项目(商机预测)
企业分析 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 查询品牌+型号的历史中标单价记录

核心概念

match_modes 匹配模式

多个工具共用的匹配模式参数,控制关键词匹配的字段范围。

含义 使用场景
sm 标的物/产品名称 搜索具体产品
title 公告标题 在标题中搜索
brand 品牌名 搜索特定品牌
fulltext 全文检索 全面搜索
caller 招标方/采购单位 搜索招标公司,当用户需要查询xx公司招标/采购时使用
winner 中标方/供应商 搜索中标公司,当用户需要查询xx公司中标时使用
tender 投标方 搜索投标方
winner_tender 中标方或投标方(两者都搜) 搜索参与方

示例

{
  "keywords": ["服务器"],
  "match_modes": ["sm", "title"]
}

仅在标的物和标题中搜索"服务器"。

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

重点案例: 查询“阿里云计算有限公司”投标和中标的项目。

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

重点案例: 查询“阿里云计算有限公司”招标的项目。

{
  "keywords": ["阿里云"],
  "match_modes": ["winner"],
  "keyword_groups": [
    {
      "keywords": ["云存储", "云服务器", "云数据库"],
      "match_modes": ["sm", "title"]
    }
  ]
}

**重点案例:**查询阿里云中标的云存储、云服务器、云数据库相关的项目。[注意:keyword_groups筛选项需要高级搜索接口(query_bids_advanced)]

{
  "keywords": ["生产许可证"],
  "match_modes": ["fulltext"]
}

查询投标资质中需要生产许可证的项目【由于资质:生产许可证不是标准字段,所以需要使用全文查询】。

bid_process 公告阶段

标讯的生命周期阶段,用于筛选不同阶段的公告。

阶段 说明
1 采购意向 早期需求预告
2 预招标 招标前准备
4 招标 正式招标公告
5 变更 变更公告
6 中标候选人 中标候选人公示
7 中标结果 中标结果公告
8 合同 合同公示
9 验收 验收公告
10 废标 废标公告

默认返回[1, 2, 4, 7, 8](主要阶段)

示例

{
  "bid_process": [7, 8]
}

仅返回中标结果和合同公告。

响应字段通用说明

所有工具统一返回结构:

{
  "success": true,
  "data": { /* 实际数据 */ },
  "error": null,
  "meta": {
    "cost_units": 1,
    "execution_time_ms": 156
  }
}

标讯核心字段

字段 说明
bid_id 标讯ID
title 公告标题
bid_type 招标/中标
bid_process 阶段
pub_time 发布时间
money 金额(元)
money_wan 金额(万元)
caller_name 采购方
winner_names 中标方列表
sm_names 标的物列表
url 详情链接
province 省份
city 城市

分页参数

所有列表类接口支持分页:

参数 说明 默认值 限制
page 页码 1 ≥1
page_size 每页数量 20 1~50

搜索类工具详解

1. search_bids - 常规搜索

按关键词、地区、金额、时间等条件检索招/中标公告。

请求参数

参数 类型 必填 说明
keywords list[str] 搜索关键词,如 ["大模型", "人工智能"]
match_modes list[str] 匹配模式,默认 ["all"]
bid_type str 公告类型:招标/中标/全部,默认 全部
bid_process list[int] 公告阶段,默认 [1,2,4,7,8]
begin_date str 开始日期 YYYY-MM-DD
end_date str 结束日期 YYYY-MM-DD
provinces list[str] 省份列表
cities list[str] 城市列表
counties list[str] 区县列表
min_amount float 最低金额(元)
max_amount float 最高金额(元)
page int 页码,默认 1
page_size int 每页数量,默认 20

响应结构

{
  "success": true,
  "data": {
    "total": 150,
    "items": [
      {
        "bid_id": 12345678,
        "title": "XX市智慧城市建设项目",
        "bid_type": "招标",
        "pub_time": "2025-01-15",
        "money": 5000000,
        "money_wan": 500,
        "caller_name": "XX市人民政府",
        "winner_names": [],
        "sm_names": ["智慧城市平台", "数据中心建设"],
        "url": "https://www.zhiliaobiaoxun.com/content/12345678/b1"
      }
    ]
  }
}

使用示例

场景1:搜索北京地区AI相关招标

POST /api_v2/search_bids
{
  "keywords": ["人工智能", "AI"],
  "bid_type": "招标",
  "provinces": ["北京"],
  "begin_date": "2025-01-01"
}

2. query_bids_advanced - 高级搜索

  • 所有常规搜索的参数都支持
  • 支持关键词分组、排除词、复杂逻辑组合。

请求参数(扩展参数)

参数 类型 必填 说明
keyword_groups list[dict] 关键词组,实现分组匹配
exclude_keywords list[str] 排除关键词
sort_field str 排序字段,默认 pub_time
sort_order str 排序方向 asc/desc,默认 desc

使用示例

场景1:搜索服务器或大模型,排除运维和耗材

POST /api_v2/query_bids_advanced
{
  "keywords": ["服务器", "大模型"],
  "exclude_keywords": ["运维", "耗材"],
  "bid_type": 2
}

场景2:复合查询 - 广东深圳地区,搜索财产/资产关键词,标题包含"险"

POST /api_v2/query_bids_advanced
{
  "keywords": ["财产", "资产"],
  "keyword_groups": [
    {
      "keywords": ["险"], 
      "match_modes": ["title"]
    }
  ],
  "provinces": ["广东"],
  "cities": ["深圳"],
  "bid_type": 1
}

3. get_bid_detail - 获取标讯详情

根据 bid_id / uniq_key / URL 获取单条标讯完整详情及正文。

请求参数

参数 类型 必填 说明
bid_id int 否* 标讯ID(优先使用)
bid_type int 公告类型 1:招标 2:中标
bid_url str 否* 知了标讯公告链接
uniq_key str 否* 公告唯一标识

三者至少填一个

响应结构(扩展字段)

除基础标讯字段外,还包含:

字段 说明
county 区县
agency_name 代理机构
source 信息来源
service_end_date 服务截止日期
fulltext 公告原文

使用示例

场景1:根据ID获取详情

POST /api_v2/get_bid_detail
{
  "bid_id": 12345678
}

场景2:根据URL获取详情

POST /api_v2/get_bid_detail
{
  "bid_url": "https://www.zhiliaobiaoxun.com/content/1234567890/b1"
}

4. search_expiring_projects - 查询临期项目

查询即将到期的周期性项目,用于商机预测和续期机会挖掘。

请求参数

参数 类型 必填 说明
keywords list[str] 产品/服务关键词
begin_date str 到期开始日期,默认今天
end_date str 到期结束日期,默认今天起90天后
provinces list[str] 省份列表
cities list[str] 城市列表
counties list[str] 区县列表
min_amount float 最低金额
company_type list[str] 招标公司类型,如 ["学校", "医院"]
page int 页码,默认 1
page_size int 每页数量,默认 20

响应结构(扩展字段)

字段 说明
days_until_expiry 距离到期天数
service_end_date 服务截止日期

使用示例

场景1:查找医疗体检服务即将到期的项目

POST /api_v2/search_expiring_projects
{
  "keywords": ["职工体检"],
  "provinces": ["北京"]
}

场景2:查找90天内到期的物业管理项目

POST /api_v2/search_expiring_projects
{
  "keywords": ["物业管理"],
  "end_date": "2026-07-01" # 当前时间90天后
}

公司类工具详解

1. get_company_profile - 公司画像

获取公司基础工商信息、行业、招中标次数等画像数据。

请求参数

参数 类型 必填 说明
company str | int 否* 公司名称(全称或简称)或公司ID
company_url str 否* 知了标讯公司详情页链接

两者至少填一个

响应结构

{
  "success": true,
  "data": {
    "id": 1234567890,
    "fullname": "华为技术有限公司",
    "name": "华为",
    "org_base_type": "企业",
    "industry": "通信设备制造",
    "industry_l1": "制造业",
    "industry_l2": "计算机、通信和其他电子设备制造业",
    "province": "广东",
    "city": "深圳",
    "county": "龙岗区",
    "capital": "10000万人民币",
    "size": "大型企业",
    "business_status": "在营",
    "caller_count": 1500,
    "winner_count": 3200,
    "taxpayer_number": "91XXXXXXXXXXXX",
    "establishment_date": "1987-09-15",
    "business_scope": "程控交换机、传输设备...",
    "url": "https://www.zhiliaobiaoxun.com/company/1234567890"
  }
}

使用示例

场景1:查询华为公司画像

POST /api_v2/get_company_profile
{
  "company": "华为技术有限公司"
}

场景2:根据URL查询公司画像

POST /api_v2/get_company_profile
{
  "company_url": "https://www.zhiliaobiaoxun.com/company/1234567890"
}

2. get_company_business_keywords - 主营业务关键词

从中标记录提炼公司主营业务关键词。

请求参数

参数 类型 必填 说明
company str | int 否* 公司名称或ID
company_url str 否* 知了标讯公司详情页链接
begin_date str 统计开始日期
end_date str 统计结束日期
provinces list[str] 省份列表
cities list[str] 城市列表
limit int 返回数量,默认10,最大50

响应结构

{
  "success": true,
  "data": {
    "company_name": "华为技术有限公司",
    "company_id": 1234567890,
    "total_keywords": 50,
    "keywords": [
      {"keyword": "服务器", "count": 150, "amount": 50000000},
      {"keyword": "交换机", "count": 120, "amount": 30000000},
      {"keyword": "5G设备", "count": 80, "amount": 40000000}
    ]
  }
}

使用示例

场景1:分析科大讯飞的主营业务

POST /api_v2/get_company_business_keywords
{
  "company": "科大讯飞股份有限公司",
  "begin_date": "2024-01-01"
}

3. get_company_partners - 合作客户与供应商

查询公司的合作客户(采购方)和供应商(分包方),分析上下游关系。

请求参数

参数 类型 必填 说明
company str | int 否* 公司名称或ID
company_url str 否* 知了标讯公司详情页链接
partner_type str 合作方类型:客户/供应商/全部
begin_date str 统计开始日期
end_date str 统计结束日期
provinces list[str] 省份列表
cities list[str] 城市列表
keywords list[str] 产品关键词过滤
min_amount float 最低合作金额
limit int 返回数量,默认20,最大100

响应结构

{
  "success": true,
  "data": {
    "company": "华为技术有限公司",
    "partner_type": "全部",
    "total": 500,
    "partners": [
      {
        "company_name": "中国移动通信集团",
        "company_id": 9876543210,
        "cooperation_count": 50,
        "cooperation_amount": 500000000,
        "cooperation_amount_wan": 50000,
        "last_cooperation_time": "2025-01-10",
        "products": ["5G基站", "核心网设备"]
      }
    ]
  }
}

使用示例

场景1:查看科大讯飞的主要客户和供应商

POST /api_v2/get_company_partners
{
  "company": "科大讯飞股份有限公司",
  "partner_type": "全部"
}

场景2:查看某公司在教育行业的客户

POST /api_v2/get_company_partners
{
  "company": "某公司名称",
  "partner_type": "客户",
  "keywords": ["教育", "学校"]
}

4. find_competitors - 竞争对手分析

基于投标重叠度分析竞争对手列表。

请求参数

参数 类型 必填 说明
company str | int 否* 公司名称或ID
company_url str 否* 知了标讯公司详情页链接
limit int 返回数量,默认10,最大50

响应结构

{
  "success": true,
  "data": {
    "company_name": "目标公司",
    "company_id": 1234567890,
    "total_projects": 1000,
    "total_competitors": 50,
    "competitors": [
      {
        "company_name": "竞争对手A",
        "company_id": 1111111111,
        "co_bid_count": 80,
        "latest_co_bid_time": "2025-01-05",
        "top_co_bid_products": [
          {"product": "服务器", "count": 30}
        ],
        "top_co_bid_callers": [
          {"caller": "中国移动", "count": 20}
        ],
        "top_co_bid_provinces": [
          {"province": "北京", "count": 25}
        ]
      }
    ]
  }
}

使用示例

场景1:查找一起投过标的竞争对手

POST /api_v2/find_competitors
{
  "company": "公司名称",
  "limit": 20
}

5. get_company_contacts - 公司项目联系人

查询公司的项目联系人信息,包括招标联系人和中标联系人。

请求参数

参数 类型 必填 说明
company str | int 否* 公司名称(全称或简称)或公司ID
company_url str 否* 知了标讯公司详情页链接
keywords list[str] 筛选关键词,如 ["呼吸机", "监护仪"]
match_modes list[str] 搜索范围,默认 ["sm","title"],可选:sm(标的物) title(标题) brand(品牌) caller(招标方) winner(中标方)
begin_date str 筛选开始日期 YYYY-MM-DD
end_date str 筛选截止日期 YYYY-MM-DD
role int 联系人类型:1=招标联系人,2=中标联系人,0=全部(先招标后中标补充),默认 0
limit int 返回联系人数量,默认5,最大20

响应结构

{
  "success": true,
  "data": {
    "total": 50,
    "contacts": [
      {
        "phone": "138****1234",
        "name": "张先生",
        "bid_count": 10,
        "last_pub_time": "2025-01-10",
        "last_bid_url": "https://www.zhiliaobiaoxun.com/content/1234567890/b1"
      }
    ]
  }
}

使用示例

场景1:查询某公司的所有项目联系人

POST /api_v2/get_company_contacts
{
  "company": "公司名称"
}

场景2:查询某公司在医疗设备项目中的中标联系人

POST /api_v2/get_company_contacts
{
  "company": "公司名称",
  "keywords": ["呼吸机", "监护仪"],
  "role": 2
}

场景3:查询某公司近期项目的招标联系人

POST /api_v2/get_company_contacts
{
  "company": "公司名称",
  "begin_date": "2024-01-01",
  "role": 1
}

6. find_potential_bidders - 推荐潜在供应商

针对一个招标项目,推荐历史上参与同类项目较多的潜在供应商。

请求参数

参数 类型 必填 说明
bid_id int 否* 标讯ID(优先使用)
bid_type str 公告类型 招标/中标
bid_url str 否* 知了标讯公告链接
uniq_key str 否* 公告唯一标识
project_title str 项目标题
limit int 返回数量,默认10,最大50

三者至少填一个

响应结构

{
  "success": true,
  "data": {
    "project_title": "XX市智慧城市建设项目",
    "project_bid_id": 12345678,
    "project_bid_type": 1,
    "caller_name": "XX市人民政府",
    "province": "广东",
    "city": "深圳",
    "sm_names": ["智慧城市平台", "数据中心"],
    "total": 50,
    "bidders": [
      {
        "company_name": "潜在供应商A",
        "company_id": 2222222222,
        "source": "历史中标",
        "caller_history_count": 10,
        "caller_history_amount": 5000000,
        "region_win_count": 5,
        "region_win_amount": 2000000,
        "last_cooperation_time": "2024-11-15",
        "latest_win_time": "2024-12-01",
        "matched_products": ["智慧城市平台", "数据中心"],
        "main_customers": ["深圳市政府", "广州市政府"]
      }
    ]
  }
}

使用示例

场景1:投标前评估,查看类似项目的历史供应商

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

场景2:根据项目标题推荐供应商

POST /api_v2/find_potential_bidders
{
  "project_title": "某市智慧城市建设项目",
  "limit": 20
}

市场分析类工具详解

1. get_top_purchasers - Top采购单位

按关键词查询Top采购单位(精准获客、市场调研)。

请求参数

参数 类型 必填 说明
keywords list[str] 业务关键词,如 ["大模型", "人工智能"]
match_modes list[str] 匹配模式,默认 ["all"]
begin_date str 统计开始日期
end_date str 统计结束日期
provinces list[str] 省份列表
cities list[str] 城市列表
exclude_keywords list[str] 排除关键词,如 ['维修', '耗材']
min_amount float 最低金额
max_amount float 最高金额
limit int 返回数量,默认20,最大100
sort_field str 排序字段:count/amount/pub_time,默认 count

响应结构

{
  "success": true,
  "data": {
    "total": 100,
    "items": [
      {
        "company_name": "XX市人民政府",
        "company_id": 1234567890,
        "purchase_count": 50,
        "total_amount": 100000000,
        "total_amount_wan": 10000,
        "latest_purchase_time": "2025-01-10",
        "top_winners": [
          {"winner": "华为技术有限公司", "count": 10}
        ],
        "company_url": "https://www.zhiliaobiaoxun.com/company/1234567890"
      }
    ]
  }
}

使用示例

场景1:分析大语言模型市场,谁在买

POST /api_v2/get_top_purchasers
{
  "keywords": ["大语言模型"],
  "begin_date": "2025-01-01"
}

场景2:查找北京地区AI采购大户

POST /api_v2/get_top_purchasers
{
  "keywords": ["人工智能", "AI"],
  "provinces": ["北京"],
  "min_amount": 1000000,
  "sort_field": "amount"
}

2. get_top_suppliers - Top中标单位

按关键词查询Top中标单位(渠道扩展、竞对分析)。

请求参数

参数 类型 必填 说明
keywords list[str] 业务关键词
match_modes list[str] 匹配模式,默认 ["all"]
begin_date str 统计开始日期
end_date str 统计结束日期
provinces list[str] 省份列表
cities list[str] 城市列表
exclude_keywords list[str] 排除关键词
min_amount float 最低金额
max_amount float 最高金额
limit int 返回数量,默认20,最大100
sort_field str 排序字段:count/amount/pub_time,默认 count

响应结构

{
  "success": true,
  "data": {
    "total": 100,
    "items": [
      {
        "company_name": "华为技术有限公司",
        "company_id": 1234567890,
        "win_count": 100,
        "total_amount": 500000000,
        "total_amount_wan": 50000,
        "latest_win_time": "2025-01-10",
        "top_provinces": [
          {"province": "北京", "count": 30, "amount": 150000000}
        ],
        "top_cities": [
          {"city": "深圳", "count": 20, "amount": 100000000}
        ],
        "top_callers": [
          {"caller": "中国移动", "count": 15}
        ],
        "company_url": "https://www.zhiliaobiaoxun.com/company/1234567890"
      }
    ]
  }
}

使用示例

场景1:分析大语言模型市场,谁在中标

POST /api_v2/get_top_suppliers
{
  "keywords": ["大语言模型"],
  "begin_date": "2025-01-01"
}

场景2:查找服务器Top供应商

POST /api_v2/get_top_suppliers
{
  "keywords": ["服务器"],
  "exclude_keywords": ["维修", "维保"],
  "sort_field": "amount"
}

3. get_top_brands - Top中标品牌

按产品/品类查询Top中标品牌及型号。

请求参数

参数 类型 必填 说明
product str 产品名称,如 "呼吸机", "服务器"
exclude_keywords list[str] 排除关键词,如 ['维修', '耗材']
min_price float 最低价格
max_price float 最高价格
begin_date str 统计开始日期
end_date str 统计结束日期
provinces list[str] 省份列表
cities list[str] 城市列表
counties list[str] 区县列表
limit int 返回品牌数量,默认10,最大50

响应结构

{
  "success": true,
  "data": {
    "product": "呼吸机",
    "total": 20,
    "brands": [
      {
        "brand": "迈瑞",
        "brand_id": 1001,
        "win_count": 500,
        "total_amount": 100000000,
        "total_amount_wan": 10000,
        "total_count": 2000,
        "avg_price": 50000,
        "avg_price_wan": 5,
        "top_models": ["SV300", " BeneVision T1"],
        "last_win_time": "2025-01-10"
      }
    ]
  }
}

使用示例

场景1:查询呼吸机Top品牌

POST /api_v2/get_top_brands
{
  "product": "呼吸机",
  "exclude_keywords": ["维修", "耗材"]
}

场景2:查询服务器品牌市场占有率

POST /api_v2/get_top_brands
{
  "product": "服务器",
  "begin_date": "2024-01-01",
  "limit": 20
}

4. aggregate_bids_advanced - 多维度聚合统计

按月/季/年/省份/城市/行业/品牌等维度进行招中标数据统计分析。

请求参数

参数 类型 必填 说明
filters object 筛选条件(与搜索工具类似)
filters.keywords list[str] 关键词
filters.match_modes list[str] 匹配模式
filters.keyword_groups list[dict] 关键词组
filters.exclude_keywords list[str] 排除关键词
filters.bid_type int 1=招标 2=中标
filters.begin_date str 开始日期
filters.end_date str 结束日期
filters.provinces list[str] 省份列表
filters.cities list[str] 城市列表
filters.min_money float 最低金额
filters.max_money float 最高金额
group_by list[str] 聚合维度
metrics list[str] 统计指标,默认 ["count", "sum_amount"]
compare_with str 对比类型:yoy=同比 qoq=环比
compare_period str 对比周期

group_by 可选值

说明
month 按月统计
quarter 按季度统计
year 按年统计
province 按省份统计
city 按城市统计
industry 采购行业
brand 品牌
company_type 招标公司类型
bid_method 采购方式

响应结构

{
  "success": true,
  "data": {
    "total_count": 1000,
    "total_amount": 5000000000,
    "total_amount_wan": 500000,
    "buckets": [
      {
        "key": "2025-01",
        "count": 100,
        "sum_amount": 500000000,
        "sum_amount_wan": 50000,
        "avg_amount": 5000000,
        "yoy_count": 10.5,
        "yoy_amount": 15.3
      }
    ],
    "group_by": ["month"]
  }
}

使用示例

场景1:按月统计大语言模型项目

POST /api_v2/aggregate_bids_advanced
{
  "filters": {
    "keywords": ["大语言模型"],
    "begin_date": "2024-01-01"
  },
  "group_by": ["month"]
}

场景2:按省份和城市统计服务器市场

POST /api_v2/aggregate_bids_advanced
{
  "filters": {
    "keywords": ["服务器"],
    "begin_date": "2024-01-01"
  },
  "group_by": ["province", "city"]
}

场景3:同比分析AI项目趋势

POST /api_v2/aggregate_bids_advanced
{
  "filters": {
    "keywords": ["人工智能", "AI"],
    "bid_type": 2
  },
  "group_by": ["month"],
  "compare_with": "yoy"
}

5. get_price_trends - 品牌型号价格查询

查询品牌+型号的历史中标单价记录(采购寻源、价格参考)。

请求参数

参数 类型 必填 说明
brand str 品牌名称,如 "联想", "迈瑞"
model str 型号
product str 产品类别
exclude_keywords list[str] 排除关键词
min_price float 最低价格
max_price float 最高价格
begin_date str 统计开始日期
end_date str 统计结束日期
provinces list[str] 省份列表
cities list[str] 城市列表
counties list[str] 区县列表
limit int 返回记录数量,默认20,最大200

响应结构

{
  "success": true,
  "data": {
    "brand": "迈瑞",
    "model": "SV300",
    "total": 50,
    "price_stats": {
      "min": 30000,
      "max": 80000,
      "avg": 50000,
      "median": 48000
    },
    "records": [
      {
        "bid_id": 12345678,
        "bid_type": 2,
        "title": "XX医院医疗设备采购项目",
        "sm_name": "呼吸机",
        "brand": "迈瑞",
        "model": "SV300",
        "sku_price": 50000,
        "sku_count": 5,
        "sku_total_money": 250000,
        "caller_name": "XX市人民医院",
        "pub_time": "2025-01-10",
        "province": "广东",
        "city": "深圳",
        "winner_names": ["XX医疗器械公司"],
        "url": "https://www.zhiliaobiaoxun.com/content/12345678/b1"
      }
    ]
  }
}

使用示例

场景1:查询迈瑞SV300呼吸机历史中标价格

POST /api_v2/get_price_trends
{
  "brand": "迈瑞",
  "model": "SV300",
  "product": "呼吸机",
  "exclude_keywords": ["耗材", "维修", "维保"]
}

场景2:查询某品牌服务器价格区间

POST /api_v2/get_price_trends
{
  "brand": "联想",
  "product": "服务器",
  "begin_date": "2024-01-01",
  "limit": 50
}

使用场景示例

本文档提供7个典型使用场景的完整调用示例,涵盖标讯搜索、企业分析、市场研究等常见需求。


场景一:公司深度分析(互联网增强)

用户需求:帮我深度分析一下科大讯飞,包括业务布局、竞争优势、最新动态

分析思路

  1. 获取公司基础画像和主营业务(标讯数据)
  2. 分析竞争对手(标讯数据)
  3. 搜索公司官网获取最新动态
  4. 查找行业新闻了解市场地位
  5. 综合分析生成报告

标讯数据调用

# 步骤1:获取公司画像
POST https://mcp-server.zhiliaobiaoxun.com/api_v2/get_company_profile
{
  "company": "科大讯飞股份有限公司"
}

# 步骤2:获取主营业务关键词
POST https://mcp-server.zhiliaobiaoxun.com/api_v2/get_company_business_keywords
{
  "company": "科大讯飞股份有限公司",
  "begin_date": "2024-01-01"
}

# 步骤3:分析竞争对手
POST https://mcp-server.zhiliaobiaoxun.com/api_v2/find_competitors
{
  "company": "科大讯飞股份有限公司"
}

互联网信息补充:使用 WebSearch 搜索公司官网、最新动态、行业政策等


场景二:市场趋势与价格分析(互联网增强)

用户需求:分析服务器市场2025年发展趋势及价格区间

标讯数据调用

# 按月统计服务器中标趋势
POST https://mcp-server.zhiliaobiaoxun.com/api_v2/aggregate_bids_advanced
{
  "filters": {
    "keywords": ["服务器"],
    "bid_type": 2,
    "begin_date": "2024-01-01"
  },
  "group_by": ["month", "province"],
  "compare_with": "yoy"
}

# 获取Top品牌及价格区间
POST https://mcp-server.zhiliaobiaoxun.com/api_v2/get_top_brands
{
  "product": "服务器",
  "begin_date": "2024-01-01"
}

# 查询特定品牌价格走势
POST https://mcp-server.zhiliaobiaoxun.com/api_v2/get_price_trends
{
  "brand": "联想",
  "product": "服务器",
  "exclude_keywords": ["维修", "维保", "耗材"]
}

场景三:产业链分析(互联网增强)

用户需求:分析新能源汽车充电桩产业链

标讯数据调用

# 获取充电桩Top供应商
POST https://mcp-server.zhiliaobiaoxun.com/api_v2/get_top_suppliers
{
  "keywords": ["充电桩", "充电设施"],
  "begin_date": "2024-01-01",
  "limit": 50
}

# 获取Top采购方
POST https://mcp-server.zhiliaobiaoxun.com/api_v2/get_top_purchasers
{
  "keywords": ["充电桩", "充电设施"],
  "begin_date": "2024-01-01",
  "limit": 50
}

# 分析某供应商的合作伙伴(上下游关系)
POST https://mcp-server.zhiliaobiaoxun.com/api_v2/get_company_partners
{
  "company": "特来电新能源有限公司",
  "partner_type": "全部"
}

场景四:寻找商机(临期项目续期)

用户需求:找一些医疗体检服务即将到期的项目

调用示例

POST https://mcp-server.zhiliaobiaoxun.com/api_v2/search_expiring_projects
{
  "keywords": ["职工体检"],
  "provinces": ["北京"]
}

响应分析要点

  • days_until_expiry:距离到期天数,越小越紧急
  • service_end_date:服务截止日期
  • caller_name:潜在续约客户
  • money:历史项目金额,可参考报价

场景五:竞对分析

用户需求:找找跟我们公司一起投过标的竞争对手

调用示例

POST https://mcp-server.zhiliaobiaoxun.com/api_v2/find_competitors
{
  "company": "公司名称",
  "limit": 20
}

响应分析要点

  • co_bid_count:共同投标次数,越大竞争越激烈
  • top_co_bid_products:竞争产品领域
  • top_co_bid_callers:共同争夺的客户
  • top_co_bid_provinces:竞争活跃地区

场景六:投标前评估潜在供应商

用户需求:这个项目我要不要参与?看看历史上参与过类似项目的供应商

调用示例

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

响应分析要点

  • caller_history_count:与该采购方的历史合作次数
  • region_win_count:在该地区的中标次数
  • matched_products:匹配的产品领域
  • main_customers:主要客户资源

场景七:市场分析(获客+竞对)

用户需求:帮我分析大语言模型市场,谁在买,谁在中标

标讯数据调用

# 步骤1:找Top采购方
POST https://mcp-server.zhiliaobiaoxun.com/api_v2/get_top_purchasers
{
  "keywords": ["大语言模型"],
  "begin_date": "2025-01-01"
}

# 步骤2:找Top供应商
POST https://mcp-server.zhiliaobiaoxun.com/api_v2/get_top_suppliers
{
  "keywords": ["大语言模型"],
  "begin_date": "2025-01-01"
}

# 步骤3:趋势分析
POST https://mcp-server.zhiliaobiaoxun.com/api_v2/aggregate_bids_advanced
{
  "filters": {
    "keywords": ["大语言模型"],
    "begin_date": "2025-01-01"
  },
  "group_by": ["month", "province"]
}

场景八:高级搜索技巧

排除干扰词 + 复合条件

# 场景A:排除运维和耗材
POST https://mcp-server.zhiliaobiaoxun.com/api_v2/query_bids_advanced
{
  "keywords": ["服务器", "大模型"],
  "exclude_keywords": ["运维", "耗材"],
  "provinces": ["北京"],
  "bid_type": 2
}

# 场景B:keyword_groups实现AND逻辑
POST https://mcp-server.zhiliaobiaoxun.com/api_v2/search_bids
{
  "keywords": ["财产", "资产"],
  "keyword_groups": [
    {"keywords": ["险"], "match_modes": ["title"]}
  ],
  "provinces": ["广东"],
  "cities": ["深圳"],
  "bid_type": 1
}

Python 调用示例

import requests

url = "https://mcp-server.zhiliaobiaoxun.com/api_v2/search_bids"
headers = {
    "X-API-Key": api_key,
    "Content-Type": "application/json"
}
payload = {
    "keywords": ["智慧城市"],
    "bid_type": "全部",
    "provinces": ["北京"],
    "begin_date": "2025-01-01",
    "page": 1,
    "page_size": 20
}

response = requests.post(url, json=payload, headers=headers)
data = response.json()
print(data)

错误处理与FAQ

API 错误码

错误码 说明 处理方式
AUTHENTICATION_FAILED API Key 无效、缺失或无权访问 检查 API Key 配置,确认Key正确有效
INSUFFICIENT_BALANCE / QUOTA_EXCEEDED 账户余额或可用次数不足 充值后重试
RATE_LIMITED 触发频率限制 降低请求频率,稍后重试
INVALID_REQUEST 请求参数不合法或缺少必填项 检查请求参数类型和取值范围
INTERNAL_ERROR 服务内部错误 稍后重试或联系技术支持
TOOL_EXECUTION_ERROR 工具执行失败(下游或业务逻辑异常) 检查请求参数或联系技术支持

使用 FAQ

Q1: company 参数应该传什么?

A: 支持以下三种方式:

  1. 公司全称"华为技术有限公司"
  2. 公司简称"华为"
  3. 公司ID1234567890(整数)

优先级:公司ID > 公司全称 > 公司简称

Q4: 如何按金额筛选?响应中的金额字段有什么区别?

A: 金额筛选:不同工具使用不同参数名

工具 金额参数 单位
search_bids min_amount, max_amount
query_bids_advanced min_money, max_money
get_top_brands min_price, max_price

响应字段

字段 单位 说明
money 原始金额
money_wan 万元 转换后的金额,方便展示

Q7: 如何排除特定关键词?

A: 使用 exclude_keywords 参数:

{
  "keywords": ["服务器"],
  "exclude_keywords": ["维修", "耗材", "维保"]
}

Q8: 如何进行复合条件搜索?

A: 使用 keyword_groups 参数实现 AND 逻辑:

{
  "keywords": ["服务器"],
  "keyword_groups": [
    {"keywords": ["华为"], "match_modes": ["winner"]},
    {"keywords": ["北京"], "match_modes": ["caller"]}
  ]
}

这表示:搜索服务器相关项目,且中标方是华为,且采购方在北京。


使用场景速查

场景 使用工具 互联网增强
公司深度分析 get_company_profile + get_company_business_keywords + find_competitors ✅ 官网、新闻、政策
市场趋势与价格分析 aggregate_bids_advanced + get_top_brands + get_price_trends ✅ 行业报告、技术趋势
产业链分析 get_top_suppliers + get_top_purchasers + get_company_partners ✅ 产业链信息
寻找商机(临期项目续期) search_expiring_projects -
竞对分析 find_competitors ✅ 行业新闻
投标前评估潜在供应商 find_potential_bidders -
市场分析(获客+竞对) get_top_purchasers + get_top_suppliers + aggregate_bids_advanced ✅ 市场报告
高级搜索技巧 query_bids_advanced + keyword_groups -

说明:标记 ✅ 的场景建议结合互联网信息进行增强分析。


互联网增强分析

对于分析类、趋势分析或深度研究需求,本技能可结合标讯数据与最新互联网信息,提供更全面的分析结果。

触发判断规则

当用户需求满足以下任一条件时,可启用互联网增强分析:

触发条件 示例关键词/描述
趋势分析类 趋势、前景、预测、发展方向、未来走向
深度分析类 深度分析、全面分析、综合分析、调研
竞争格局类 竞争格局、市场地位、行业排名、市场份额
战略类 战略、战略方向、业务布局、发展策略
产业链类 产业链、上下游、供应链、生态链
政策影响类 政策影响、行业政策、监管变化、政策支持

执行流程

用户需求输入
    ↓
判断是否需要互联网增强?
    ├─ 是 → 标讯API获取数据 + WebSearch补充信息 → 综合分析报告
    └─ 否 → 标讯API获取数据 → 基础分析结果

数据优先级原则

  1. 标讯数据为主:历史中标记录、项目金额、合作关系等客观数据
  2. 互联网信息为辅:用于背景补充、趋势验证、动态更新
  3. 信息源优先级:公司官网 > 可靠媒体 > 政策网站 > 一般新闻

适用场景

当用户需求包含以下关键词时,可主动引入互联网信息:

  • 趋势分析、市场分析、行业分析
  • 竞争分析、竞对研究
  • 公司深度分析、公司调研
  • 政策影响、行业前景
  • 产业链分析、供应链研究
  • 市场规模、市场预测

分析增强流程

标讯数据
    ↓
初步分析 ← → 互联网信息补充
    ↓              ↓
                - 搜索公司官网
                - 查找行业新闻
                - 获取政策文件
                - 产业链信息
    ↓
综合分析报告

用户引导与增值服务

回答后引导

在完成用户查询后,应主动引导用户进行进一步探索或使用增值服务。

引导话术模板

基础引导

以上是查询结果。您还可以:
- 查看相关公司的合作伙伴和竞争对手分析
- 分析该领域的市场趋势和Top品牌
- 查询临期项目寻找商机

深度分析引导

如需更深入的分析,我还可以帮您:
- 产业链上下游分析
- 竞争对手深度画像
- 价格趋势与采购寻源
- 市场规模与趋势预测

完整 API 文档

https://ai.zhiliaobiaoxun.com/docs/api/

Usage Guidance
This skill is internally coherent: it needs only one API key and its instructions match the documented endpoints. Before installing, verify the third‑party service (mcp-server.zhiliaobiaoxun.com / ai.zhiliaobiaoxun.com) is trustworthy — the registry metadata lists no homepage or source. Limit the API key's permissions if possible, monitor its usage, and avoid sharing a high‑privilege credential. If you need stronger assurance, ask the publisher for an official homepage, privacy/retention policy, and expected data fields sent to their API.
Capability Analysis
Type: OpenClaw Skill Name: construction-material-bid-assistant-lubanlebiao Version: 1.0.0 The skill bundle consists of documentation and instructions (SKILL.md) for an AI agent to interact with the Lubanlebiao (zhiliaobiaoxun.com) bidding information API. It defines 15 tools for searching bids, analyzing companies, and market trends. The instructions are well-structured, align with the stated purpose of a construction material bid assistant, and do not contain any malicious commands, data exfiltration logic, or harmful prompt injection. The requirement for the ZLBX_API_KEY environment variable is standard for this type of service integration.
Capability Tags
requires-sensitive-credentials
Capability Assessment
Purpose & Capability
Name/description require price trends and top-brand/supplier data for construction materials; SKILL.md documents matching API endpoints (get_price_trends, get_top_brands, get_top_suppliers, etc.) and a single API key (ZLBX_API_KEY). The requested credential aligns with the stated purpose.
Instruction Scope
Instructions only describe making POST requests to https://mcp-server.zhiliaobiaoxun.com/api_v2/{tool} with header X-API-Key and expected request/response schemas. There are no instructions to read unrelated files, system configuration, or other environment variables, nor to transmit data to unrelated endpoints.
Install Mechanism
Instruction-only skill with no install spec and no code files. Nothing is written to disk or downloaded by the skill itself according to the provided artifacts.
Credentials
Only a single API credential (ZLBX_API_KEY) is required and declared as the primary credential. This is proportionate to the described external API usage; no unrelated secrets or system config paths are requested.
Persistence & Privilege
always:false and no privileged install behavior. The skill is user-invocable and can be called autonomously (disable-model-invocation:false) which is the platform default and acceptable here given the limited scope and single API key requirement.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install construction-material-bid-assistant-lubanlebiao
  3. After installation, invoke the skill by name or use /construction-material-bid-assistant-lubanlebiao
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Construction Material Bid Assistant - Lubanlebiao 1.0.0 - Initial release with comprehensive documentation for 15 construction bidding and market analysis tools. - Supports keyword-based queries for construction materials and related products. - Mandatory integration of price trend and top brand queries for relevant material searches. - Enables retrieval of historical unit prices and main supplier lists for construction materials. - Provides detailed API usage guidelines, parameters, and unified response formats for all supported tools.
Metadata
Slug construction-material-bid-assistant-lubanlebiao
Version 1.0.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

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

施工建材采招助手-鲁班乐标,当查询词包含建材、钢材、管材、机械或特定建筑材料型号时调用,必须调用价格趋势查询和Top品牌接口,输出建材历史单价和主要供应商名单。 It is an AI Agent Skill for Claude Code / OpenClaw, with 125 downloads so far.

How do I install 施工建材采招助手-鲁班乐标?

Run "/install construction-material-bid-assistant-lubanlebiao" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

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

Yes, 施工建材采招助手-鲁班乐标 is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does 施工建材采招助手-鲁班乐标 support?

施工建材采招助手-鲁班乐标 is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

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

It is built and maintained by wangppp (@thuanlynham-stack); the current version is v1.0.0.

💬 Comments