ResAPI

免费 · 只读查询 · 无需注册

把数据能力
直接接到你的产品里

免费开放 GET 查询接口，覆盖节假日、区划、高校、手机号段、邮编、非遗等场景；文档与多语言示例齐全，复制即可对接。

浏览 API 使用说明 Agent 接入

Agent · MCP 接入

AI 工具可直接调用 ResAPI

Cursor、WorkBuddy 等客户端可通过 MCP 使用 12 个中国公共数据工具——查节假日、区划、手机号归属、邮编、非遗等，无需 API Key。

  • 远程接入：连接 /mcp，无需安装本地程序
  • 本地 stdio：使用 resapi-mcp 二进制，适合开发调试
  • 能力发现：/agent.json 列出全部 Tool 与聚合接口
MCP 接入文档 查看 agent.json WorkBuddy 接入

热门 API

已上线 9 个能力，更多场景持续开放

v1 稳定

地址标准化 API

提供地址建议、地址解析与行政区划标准化

/v1/address
addressnormalizechina
查看文档 →
v1 稳定

高校基础信息 API

提供全国高校基础信息查询、搜索与元数据统计

/v1/colleges
collegeeducationchina
查看文档 →
v1 稳定

节假日判断 API

节假日判断、公历农历互查、节气、生肖星座与年度二十四节气

/v1/holidays
calendarholidaylunarworkday
查看文档 →
v1 稳定

省级非遗 API

省级非物质文化遗产代表性项目、传承人及数量统计（2005–2024）

/v1/ich
ichcultureheritage
查看文档 →
v1 稳定

手机号段 API

根据手机号或前 7 位号段查询归属省、市与运营商

/v1/phone
phonetools
查看文档 →
v1 稳定

全国行政区划 API

提供省市区镇村查询、搜索分页、子级级联与地名检索

/v1/regions
regionchinageo
查看文档 →
v1 稳定

时区与时间格式 API

提供当前时间、时区转换与时间戳互转能力

/v1/time
timetimezonedatetime
查看文档 →
v1 稳定

编码校验 API

提供 USCC、身份证、银行卡号等编码规则与校验位校验

/v1/validate
validateuscctools
查看文档 →
v1 稳定

邮政编码 API

地名查邮编、邮编查地名，覆盖区县一级行政区划

/v1/zipcode
zipcodeaddresstools
查看文档 →

标准 REST + JSON

统一响应格式与错误码，对接成本低，适合脚本、小程序与后端服务调用

文档与示例完整

每个接口含参数说明、错误码与 7 种语言示例，支持 Tab 切换与一键复制

面向个人与小团队

长期免费开放只读查询，无需注册 Key，按 IP 计数限流保护服务稳定

MCP Agent 接入

支持 Cursor 等客户端通过 /mcp 远程调用 12 个数据工具，详见 接入文档

数据本地维护

区划、高校、邮编、非遗等静态数据本地存储，响应头标注数据版本便于追踪