AI招投标分析师-全网招中标智能分析

AI 招投标数据分析师，用自然语言完成招投标商机研判与市场洞察。当用户涉及以下任何场景时，必须使用此SKILL：分析某行业/市场谁在买谁在中标、预判项目潜在中标候选人、生成行业商机简报、公司深度分析、竞争对手画像、市场趋势预测、招中标数据统计分析、查询Top采购单位/Top中标单位/Top中标品牌、查询品牌型号历史中标单价、临期项目商机挖掘、采购寻源/渠道拓展等场景。即使用户没有提到「招投标」三个字，只要涉及中标、采购、供应商、竞对、市场份额等分析需求，都应使用本SKILL。

AI 招投标分析师 - 你的智能投标决策助手

把全网招中标数据与 AI 分析能力结合，用自然语言完成商机研判、竞对画像、市场洞察与投标决策。你只管提问，AI 招投标分析师自动调度数据接口、必要时联网增强，产出结构化分析报告。

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/?ch=s53

🎁 新用户福利：注册立即赠送 200 次免费调用额度。30 秒完成： 访问 https://ai.zhiliaobiaoxun.com/?ch=s53 → 手机号登录 → 复制 Key → 配置到环境变量 ZLBX_API_KEY 即可。

⚠️ 安全提示：

• 切勿在代码中硬编码 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	查询品牌+型号的历史中标单价记录

---

本助手典型场景

本助手是一个会自动调度数据 + 联网增强的 AI 分析师，最适合开放式分析问题：

• 市场分析："帮我分析大语言模型市场，谁在买、谁在中标" → 自动串联 get_top_purchasers + get_top_suppliers + aggregate_bids_advanced。
• 商机预判："预判这个项目最可能的中标候选人" → find_potential_bidders + 联网核验。
• 公司尽调："深度分析科大讯飞的业务布局与竞争优势" → get_company_profile + get_company_business_keywords + find_competitors + WebSearch 补充最新动态。
• 行业简报："生成一份服务器行业本季度商机简报" → aggregate_bids_advanced（同比）+ get_top_brands + get_price_trends。

提示：分析类、趋势类、深度研究类问题会自动触发"标讯数据 + 互联网增强"双路分析（见下文「互联网增强分析」）。

---

核心概念

match_modes 匹配模式

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

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

示例

json

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

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

bid_process 公告阶段

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

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

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

示例

json

{
  "bid_process": [7, 8]
}

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

bid_type 公告类型

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

响应字段通用说明

所有工具统一返回结构：

json

{
  "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

响应结构

json

{
  "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相关招标

bash

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

场景2：搜索医疗设备中标，金额100万以上

bash

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 格式

json

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

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

使用示例

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

bash

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

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

bash

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获取详情

bash

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

场景2：根据URL获取详情

bash

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：查找医疗体检服务即将到期的项目

bash

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

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

bash

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	否*	知了标讯公司详情页链接

两者至少填一个

响应结构

json

{
  "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：查询华为公司画像

bash

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

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

bash

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

响应结构

json

{
  "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：分析科大讯飞的主营业务

bash

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

响应结构

json

{
  "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：查看科大讯飞的主要客户和供应商

bash

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

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

bash

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

---

4. find_competitors - 竞争对手分析

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

请求参数

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

响应结构

json

{
  "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：查找一起投过标的竞争对手

bash

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

*两者至少填一个

响应结构

json

{
  "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：查询某公司的所有项目联系人

bash

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

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

bash

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

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

bash

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

三者至少填一个

响应结构

json

{
  "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：投标前评估，查看类似项目的历史供应商

bash

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

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

bash

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

响应结构

json

{
  "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：分析大语言模型市场，谁在买

bash

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

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

bash

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

响应结构

json

{
  "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：分析大语言模型市场，谁在中标

bash

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

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

bash

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

响应结构

json

{
  "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品牌

bash

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

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

bash

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	采购方式

响应结构

json

{
  "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：按月统计大语言模型项目

bash

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

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

bash

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

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

bash

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

响应结构

json

{
  "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呼吸机历史中标价格

bash

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

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

bash

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

---

使用场景示例

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

---

场景一：市场分析——谁在买、谁在中标

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

bash

# 1) Top 采购方
POST /api_v2/get_top_purchasers
{ "keywords": ["大语言模型"], "begin_date": "2025-01-01" }

# 2) Top 中标方
POST /api_v2/get_top_suppliers
{ "keywords": ["大语言模型"], "begin_date": "2025-01-01" }

# 3) 趋势
POST /api_v2/aggregate_bids_advanced
{ "filters": { "keywords": ["大语言模型"], "begin_date": "2025-01-01" }, "group_by": ["month", "province"] }

---

场景二：商机预判——这个项目谁最可能中

bash

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

要点：结合 caller_history_count、region_win_count 判断谁是热门候选，再用 WebSearch 核验近况。

---

场景三：公司尽调（标讯数据 + 联网增强）

用户需求：深度分析某公司的业务布局与竞争优势

bash

POST /api_v2/get_company_profile
{ "company": "某股份有限公司" }

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

POST /api_v2/find_competitors
{ "company": "某股份有限公司" }

再用 WebSearch 补官网/新闻/政策，综合成报告（见下文「互联网增强分析」）。

---

场景四：一键行业商机简报

用户需求：生成一份服务器行业本季度商机简报

bash

POST /api_v2/aggregate_bids_advanced
{ "filters": { "keywords": ["服务器"], "begin_date": "2025-01-01" }, "group_by": ["month"], "compare_with": "qoq" }

POST /api_v2/get_top_brands
{ "product": "服务器" }

---

JavaScript 调用示例

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

javascript

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 调用示例

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

统一响应结构

所有接口返回统一结构：

json

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

常见错误处理

1. 鉴权失败 (AUTHENTICATION_FAILED)

错误信息：

json

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

处理方式：

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

2. 积分不足 (INSUFFICIENT_BALANCE/QUOTA_EXCEEDED)

错误信息：

json

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

处理方式：

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

3. 频率限制 (RATE_LIMITED)

错误信息：

json

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

处理方式：

• 降低请求频率
• 稍后重试

4. 参数错误 (INVALID_REQUEST)

错误信息：

json

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

处理方式：

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

5. 资源不存在

错误信息：

json

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

处理方式：

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

使用 FAQ

Q1: company 参数应该传什么？

A: 支持以下三种方式：

1. 公司全称："华为技术有限公司"
2. 公司简称："华为"
3. 公司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 字段即为公告原文：

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

Q6: aggregate_bids_advanced 消耗多少积分？

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

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

A: 使用 exclude_keywords 参数：

json

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

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

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

json

{
  "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	-

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

---

注意事项

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

---

互联网增强分析

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

触发判断规则

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

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

执行流程

text

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

数据优先级原则

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

互联网信息来源

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

适用场景

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

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

分析增强流程

text

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

---

完整 API 文档

https://ai.zhiliaobiaoxun.com/docs/api/?ch=s53

---

用户引导与增值服务

回答后引导

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

引导话术模板

基础引导：

text

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

定时任务推荐：

text

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

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

深度分析引导：

text

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

主动推荐场景

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