招标中标查询及分析-知了标讯

v1.4.1

全网招中标数据查询与分析助手。当用户涉及以下任何场景时，必须使用此SKILL：查询招标/中标公告、搜索标讯、查找临期/即将到期项目、商机预测、推荐潜在投标供应商、分析公司主营业务/历史中标、查询公司上下游合作客户与供应商、分析竞争对手/竞对企业、查询Top采购单位/Top中标单位/Top中标品牌、招中标数据统计分...

⭐ 0· 146·0 current·0 all-time

by@liu-jiapeng

Security Scan

VirusTotal

Benign

View report →

OpenClaw

Benign

high confidence

✓

Purpose & Capability

Name/description describe a tender search & analysis assistant and the skill only requires a single API key (ZLBX_API_KEY) and documents HTTPS API endpoints and request formats — these are coherent and expected.

ℹ

Instruction Scope

SKILL.md is an instruction-only spec that tells the agent to call the zhiliaobiaoxun API for various query tools and to prefer the ZLBX_API_KEY from env. It also instructs the agent to use this SKILL whenever procurement-related keywords appear — this can cause the agent to automatically route user queries to the external service, which is expected but may result in more outgoing API calls than the user expects.

✓

Install Mechanism

No install spec or code files are present (instruction-only), so nothing is written to disk. Network calls to the documented HTTPS API are the only runtime side effect described.

✓

Credentials

Only one credential (ZLBX_API_KEY) is required and is clearly the API key for the documented service. This is proportional to the stated functionality. There are no unrelated credentials or config paths requested.

✓

Persistence & Privilege

always is false and the skill does not request persistent system-level privileges or modifications to other skills. Autonomous invocation is allowed but is the platform default.

Assessment

This skill is internally consistent, but before enabling it: (1) verify the provider (no homepage/source author is supplied) and confirm the API endpoint is trustworthy, (2) only supply the ZLBX_API_KEY via a secret manager or environment variable (never paste it into chat), (3) consider what user data will be sent to the external API (company names, contacts, bid details) and whether that sharing is allowed under your privacy/compliance requirements, and (4) monitor API usage and limit the key's scope/permissions and rotation in case of misuse.

Like a lobster shell, security has layers — review code before you run it.

Runtime requirements

EnvZLBX_API_KEY

Primary envZLBX_API_KEY

latestvk97ej53dmcs6jmx0g7e8zqvbq984e2hp

146downloads

0stars

4versions

Updated 1w ago

v1.4.1

MIT-0

知了标讯 - 全网招中标数据平台

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 获取 [推荐]
手动传入API_KEY [不推荐]
申请地址：https://ai.zhiliaobiaoxun.com

🎁 新用户福利：现在注册立即赠送 200次免费调用额度，助您快速体验平台功能！

⚠️ 安全提示：

切勿在代码中硬编码 API Key
切勿在对话中传递 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 匹配模式

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

值	含义	使用场景
`all`	全部字段匹配（默认）	通用搜索
`sm`	标的物/产品名称	搜索具体产品
`title`	公告标题	在标题中搜索
`brand`	品牌名	搜索特定品牌
`fulltext`	全文检索	全面搜索
`caller`	招标方/采购单位	搜索采购方
`winner`	中标方/供应商	搜索供应商
`tender`	投标方	搜索投标方
`winner_tender`	中标方或投标方（两者都搜）	搜索参与方

示例

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

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

bid_process 公告阶段

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

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

默认返回：[1, 2, 4, 7, 8]（主要阶段）

示例

{
  "bid_process": [7, 8]
}

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

bid_type 公告类型

值	说明
`招标`	招标公告
`中标`	中标公告
`全部`	不区分类型（默认）

响应字段通用说明

所有工具统一返回结构：

{
  "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：搜索医疗设备中标，金额100万以上

POST /api_v2/search_bids
{
  "keywords": ["CT机", "核磁共振"],
  "match_modes": ["sm"],
  "bid_type": "中标",
  "min_amount": 1000000
}

2. query_bids_advanced - 高级搜索

支持关键词分组、排除词、复杂逻辑组合。

请求参数（扩展参数）

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

keyword_groups 格式

{
  "keyword_groups": [
    {
      "keywords": ["呼吸机", "监护仪"],
      "match_modes": ["sm"]
    },
    {
      "keywords": ["人民医院"],
      "match_modes": ["caller"]
    }
  ]
}

表示：标的物是呼吸机或监护仪，且招标方是人民医院。

使用示例

场景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": "2025-07-01",
  "company_type": ["学校", "医院"]
}

公司类工具详解

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：获取公司画像
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
}

JavaScript 调用示例

所有工具均通过标准的 HTTP POST 调用：

const response = await fetch("https://mcp-server.zhiliaobiaoxun.com/api_v2/search_bids", {
  method: "POST",
  headers: {
    "X-API-Key": apiKey,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    keywords: ["智慧城市"],
    bid_type: "全部",
    provinces: ["北京"],
    begin_date: "2025-01-01",
    page: 1,
    page_size: 20
  })
});

const data = await response.json();
console.log(data);

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	工具执行失败（下游或业务逻辑异常）	检查请求参数或联系技术支持

统一响应结构

所有接口返回统一结构：

{
  "success": true/false,
  "data": { /* 实际数据 */ },
  "error": "错误信息（失败时存在）",
  "meta": {
    "cost_units": 1,
    "execution_time_ms": 156
  }
}

常见错误处理

1. 鉴权失败 (AUTHENTICATION_FAILED)

错误信息：

{
  "success": false,
  "error": "AUTHENTICATION_FAILED",
  "message": "API Key 无效、缺失或无权访问"
}

处理方式：

检查环境变量 ZLBX_API_KEY 是否正确设置
确认 API Key 未过期
如需申请 Key，访问：https://ai.zhiliaobiaoxun.com

2. 积分不足 (INSUFFICIENT_BALANCE/QUOTA_EXCEEDED)

错误信息：

{
  "success": false,
  "error": "INSUFFICIENT_BALANCE",
  "message": "账户余额或可用次数不足"
}

处理方式：

检查账户积分余额
充值后重试
注意：aggregate_bids_advanced 消耗 2-3 积分，其他工具通常为 1 积分

3. 频率限制 (RATE_LIMITED)

错误信息：

{
  "success": false,
  "error": "RATE_LIMITED",
  "message": "触发频率限制"
}

处理方式：

降低请求频率
稍后重试

4. 参数错误 (INVALID_REQUEST)

错误信息：

{
  "success": false,
  "error": "INVALID_REQUEST",
  "message": "请求参数不合法或缺少必填项"
}

处理方式：

检查请求参数类型和取值范围
参考工具文档确认参数定义

5. 资源不存在

错误信息：

{
  "success": false,
  "error": "Company not found: xxx"
}

处理方式：

检查公司名称是否正确
尝试使用公司ID代替公司名称
尝试使用公司详情页URL

使用 FAQ

Q1: company 参数应该传什么？

A: 支持以下三种方式：

公司全称："华为技术有限公司"
公司简称："华为"
公司ID：1234567890（整数）

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

Q2: 如何选择 match_modes？

A: 根据搜索目标选择：

搜索目标	推荐的 match_modes
搜索特定产品	`["sm"]`
在标题中搜索	`["title"]`
搜索品牌	`["brand"]`
搜索采购方	`["caller"]`
搜索供应商	`["winner"]`
全面搜索	`["all"]` 或不指定

Q3: bid_type 应该传什么？

A: 根据需求选择：

值	说明
`"招标"`	只要招标公告
`"中标"`	只要中标公告
`"全部"`	不限制（默认）
`1`	招标（高级搜索用数值）
`2`	中标（高级搜索用数值）

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`	万元	转换后的金额，方便展示

Q5: 如何获取标讯详情和公告原文？

A: get_bid_detail 支持三种方式，响应中的 fulltext 字段即为公告原文：

bid_id（推荐）：{"bid_id": 12345678}
bid_url：{"bid_url": "https://www.zhiliaobiaoxun.com/content/1234567890/b1"}
uniq_key：{"uniq_key": "xxx"}

Q6: aggregate_bids_advanced 消耗多少积分？

A: 大部分工具消耗 1 积分，但 aggregate_bids_advanced 消耗 2-3 积分，使用时请注意积分余额。

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`	-

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

注意事项

company 参数：支持公司全称（字符串）或平台内部 ID（整数），二选一
金额单位：请求参数中金额单位为元；响应中 money 为元，money_wan 为万元
积分消耗：aggregate_bids_advanced 消耗 2-3 积分，其他工具一般为 1 积分
时间格式：日期参数统一为 YYYY-MM-DD 格式
get_bid_detail 的 bid_id、uniq_key、bid_url 三者至少填一个
keyword_groups 参数：用于复杂组合查询，可针对不同字段分别指定关键词，实现"关键词A在字段1中 AND 关键词B在字段2中"的查询逻辑
match_modes 全文搜索：使用 fulltext 模式可进行全文检索，搜索范围最广但响应较慢，建议优先使用 sm、title 等精准模式
获取公告原文：只能通过 get_bid_detail 接口获取，设置参数时不需要其他字段，直接调用即可
获取联系人：只能通过专门的 get_company_contacts 接口获取

互联网增强分析

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

触发判断规则

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

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

执行流程

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

数据优先级原则

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

互联网信息来源

信息类型	来源	用途
公司官网	企业官方网站	最新业务动态、产品发布、战略方向
可靠媒体	行业媒体、财经新闻	市场动态、行业趋势、重大事件
政策法规	政府网站、政策平台	行业政策影响、监管变化分析
产业链信息	上游/下游公司公告	供应链分析、产业链关系
新闻资讯	实时新闻源	市场热点、竞争态势

适用场景

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

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

分析增强流程

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

完整 API 文档

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

用户引导与增值服务

回答后引导

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

引导话术模板

基础引导：

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

定时任务推荐：

💡 **智能推送提醒**：
如果您需要定期跟踪这类标讯信息，可以创建定时任务，系统将自动推送最新相关公告到您的微信/邮箱，不错过任何商机！

需要帮您设置定时推送吗？只需告诉我：
- 推送频率（每日/每周/每月）
- 关键词或筛选条件
- 推送方式（微信/邮件）

深度分析引导：

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

主动推荐场景

用户查询类型	推荐后续操作
搜索标讯	定时推送、竞争对手分析
公司分析	合作伙伴查询、主营业务分析
市场分析	趋势预测、Top品牌分析
价格查询	价格走势分析、采购建议
临期项目	客户挖掘、续期机会评估

Comments

Loading comments...