API 概述

知了标讯 AI 开放平台通过统一的 HTTP 接口暴露 MCP 工具能力：所有接口均为 POST，路径为 /api_v2/{tool_name}，使用 X-API-Key 鉴权。

Base URL

https://mcp-server.zhiliaobiaoxun.com

完整请求地址示例：https://mcp-server.zhiliaobiaoxun.com/api_v2/search_bids

认证方式

所有请求须在 Header 中携带 API Key（非 Bearer Token）：

X-API-Key: YOUR_API_KEY

获取 API Key

在个人中心创建

安全传输

请使用 HTTPS

按次计费

计费以接口返回的 cost_units 为准

快速开始

以下示例调用「搜索招中标」工具：

cURL 示例bash

curl -X POST "https://mcp-server.zhiliaobiaoxun.com/api_v2/search_bids" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "keywords": ["智慧城市", "信息化"],
    "page": 1,
    "page_size": 20
  }'

响应格式

统一 JSON 结构如下：

成功响应结构json

{
  "success": true,
  "data": { },
  "error": null,
  "meta": {
    "request_id": "req_abc123",
    "tool_name": "search_bids",
    "cost_units": 1,
    "execution_time_ms": 128
  }
}

失败时 success 为 false，error 含错误码与说明：

错误响应结构json

{
  "success": false,
  "data": null,
  "error": {
    "code": "INVALID_REQUEST",
    "message": "keywords 不能为空"
  },
  "meta": {
    "request_id": "req_xyz789",
    "tool_name": "search_bids",
    "cost_units": 0,
    "execution_time_ms": 12
  }
}

错误码（error.code）

与平台 MCP 响应 ErrorCode 枚举一致：

错误码	说明
AUTHENTICATION_FAILED	API Key 无效、缺失或无权访问
INSUFFICIENT_BALANCE	账户余额或可用次数不足
RATE_LIMITED	触发频率限制
INVALID_REQUEST	请求参数不合法或缺少必填项
INTERNAL_ERROR	服务内部错误
TOOL_EXECUTION_ERROR	工具执行失败（下游或业务逻辑异常）

接口列表

加载中…

频率限制

每个 API Key：

每秒最多 5 次请求
每小时最多 2000 次请求
超出限制将返回 RATE_LIMITED，需降低并发或联系商务提升配额