接口文档

标探提供两种接入方式，数据都是全国公共资源交易平台的工程建设、政府采购公告，按国民经济行业分类整理。MCP：接到常用的 AI 助手里，直接用自然语言查标，VIP 及以上可用。REST API：用 HTTP 拉数据，接进企业自己的系统，企业轻享版及以上可用。

鉴权与密钥

在标探个人中心「接入密钥」创建以 bt_ 开头的密钥，请求头带 Authorization: Bearer <密钥>。一把密钥同时可用于 REST API（/v1/*）和 MCP（/mcp）。

额度与限流

每天调用次数按会员计（所有密钥合计，北京时间 0 点恢复）：VIP 800 次，SVIP 3,000 次，企业轻享版、专享版 20,000 次；每把密钥每分钟 60 次（企业版 300 次），超过返回 429。

REST API

地址 https://typebid.com/v1，只支持 GET，返回 JSON，金额单位万元，时间为北京时间。

检索公告 GET /v1/notices

默认只返回还在报名的公告，按发布时间从新到旧。参数：q 关键词（项目名称、编号、单位名称，也可填 18 位标探编号）；unit 单位名称；prov 省级行政区划代码；city 城市；kind（eng 工程建设、gov 政府采购）；sector 国民经济行业门类字母或两位大类代码；band 金额档（lt100、100-500、500-2000、gt2000，万元）；dl（open、week、closed、all）；days；date_from / date_to；sort（publish、publish_asc、deadline、amount、amount_asc）；page / size（每页最多 50 条）。

公告详情 GET /v1/notices/{id}

正文、资格要求、附件下载链接、原文链接。

招标单位画像 GET /v1/buyers/{单位全称}

发标总数、正在报名数、金额合计与平均、常用代理机构、常招行业、最近的公告。

全国概况 GET /v1/stats

收录总数、正在报名的条数和金额、7 天内截止的条数、按行业和省份分布。

行业代码 GET /v1/industries

国民经济行业分类（GB/T 4754—2017）的门类与大类。

MCP 接入

服务地址 https://typebid.com/mcp，Streamable HTTP 传输，鉴权同 REST API。Claude Code：claude mcp add --transport http bidscope https://typebid.com/mcp --header "Authorization: Bearer bt_xxxxxxxx"。工具：search_notices 检索公告；get_notice 公告详情；buyer_profile 招标单位画像；market_stats 全国概况；win_probability 按账号企业资料估中标概率（概率、行业匹配、资格条件逐条比对、各项依据）。

字段说明

code 为 18 位标探编号（发布日期 8 位 + 省份 2 位 + 类别 2 位 + 序号 5 位 + 校验位）；kind 为 eng 工程建设或 gov 政府采购；amount_wan 金额（万元）；deadline 截止时间；ind_code 国民经济行业代码。

错误码

401 缺少或错误的密钥；403 会员不够（MCP 要 VIP 及以上，API 要企业轻享版及以上）或账号已停用；404 没有这条公告；429 调用太频繁或当天次数用完。