中标结果查询与竞争分析 - 谁中了、对手是谁

聚焦“谁中了、凭什么中、对手是谁”。查询中标结果与中标单位，分析企业招中标战绩、竞争对手重叠度、Top 中标单位与品牌、历史中标价格，支撑投标复盘与竞争策略。

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（用户主动配置）→ 直接用
未配置 → 提示用户免费申请：访问 https://ai.zhiliaobiaoxun.com/?ch=s61 ，手机号登录后在控制台复制 API 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_group
exclude_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]

典型场景

本助手站在“看清竞争格局”的视角，常见用法：

查中标："这个项目最后谁中标了、中标金额多少" → search_bids 定位中标公告 + get_bid_detail。
战绩画像："某公司近一年中了哪些标、总规模多大" → get_company_profile + aggregate_bids_advanced。
识别对手："和我们投标重叠最多的竞争对手是谁" → find_competitors。
Top 格局："这个品类排名前列的中标单位和品牌有哪些" → get_top_suppliers + get_top_brands + get_price_trends。

响应结构

{
  "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 | 余额不足：提示用户访问 https://ai.zhiliaobiaoxun.com/?ch=s61 登录充值；新用户注册赠送 200 次免费额度 | | RATE_LIMITED | 降低请求频率，稍后重试 | | INVALID_REQUEST | 检查必填参数和类型 |

互联网增强分析

以下场景建议结合 WebSearch 补充分析：

趋势分析、市场前景预测
公司深度分析（官网、新闻、战略）
竞争格局、行业排名
产业链分析
政策影响分析

优先级：标讯客观数据为主，互联网信息为辅（公司官网 > 可靠媒体 > 政策网站）。

回答后主动引导

完成查询后，主动引导用户深入探索：

查询结果涉及公司 → 建议查看竞争对手、合作伙伴、主营业务
产品/市场查询 → 建议查看Top品牌、价格趋势、市场份额统计
中标结果 → 建议查找临期项目、评估潜在供应商
公司分析 → 建议结合互联网信息做深度研究