每日一仓

ONE OPEN-SOURCE REPO A DAY

每天 08:00 更新 数据来源 · Atlas 精选榜 2026 年 11 月 18 日

第 3 期 · 2026-11-03

public-apis/public-apis — 免费 API 的总目录:两千多个接口按五列硬指标排好队

第 3 期看点:一个由社区维护了近 10 年的免费 API 总目录,把 2,292 个公开接口按 51 个分类排好队,每个条目只用 5 列硬指标告诉你能不能直接用。

一句话定位

public-apis/public-apis 不是一个能跑起来的程序,而是一份“免费 API 的黄页”:它把散落在全网的公开接口收进同一个 README,按领域分类、按字母排序,每个接口标注认证方式、是否支持 HTTPS、是否支持跨域,让你在动手之前先判断接入门槛。它从 2016 年维护至今,仍是 GitHub 上 Star 最高的清单类仓库之一。

源码结构

把仓库克隆下来实测,结构出乎意料地简单——整个项目几乎就是一个大文件加一套校验脚本:

  • README.md:335,205 字节、2,799 行,全部内容都在这里。文首是赞助商 APILayer 的置顶推荐区,正文是 51 个分类的接口目录,末尾新增了一节 MCP Servers。
  • scripts/validate/format.py(277 行):校验 README 的格式规则。
  • scripts/validate/links.py(274 行):校验链接是否可达、是否重复。
  • scripts/tests/:两个测试文件共 638 行,给上述校验脚本写单元测试。
  • scripts/github_pull_request.sh:供 CI 调用,只校验 PR 新增行的脚本。
  • .github/workflows/:3 个工作流,分别在 push/PR 时跑格式校验、链接校验和包校验。
  • CONTRIBUTING.md、LICENSE(MIT)、.github/ 下的 Issue/PR 模板。

值得注意的是 GitHub 把该仓库的主要语言标为 Python,但这指的是校验脚本的语言;仓库的本体是 Markdown,没有任何可运行的 API 服务代码。把它当成“代码项目”来读会找错重点——它的工程量全在内容治理上。

实测的目录体量:索引列出 51 个分类,全文 2,292 条带链接的表格行。最大的分类是 Development(226 条),其次是 Government(129 条)、Geocoding(116 条)、Games & Comics(113 条)、Finance(103 条)、Cryptocurrency(101 条)、Transportation(100 条);最小的 Patent 只有 4 条。分类分布本身就能当选型参考:开发者工具、政务开放数据、地理编码这三类供给最丰富,而专利这类冷门领域选择很少。

架构图

flowchart TD
    A[读者按分类找接口] --> B[README 目录总表]
    B --> C[51 个分类表格]
    C --> D[每条五列硬指标]
    D --> E[名称与描述]
    D --> F[认证方式]
    D --> G[HTTPS 支持]
    D --> H[CORS 支持]
    I[贡献者提交 PR] --> J[格式校验脚本]
    I --> K[链接校验脚本]
    J --> L[GitHub Actions 门禁]
    K --> L
    L --> B
    M[MCP Servers 新区] --> B

分层设计说明

这个仓库可以按四层来理解,每一层解决一个不同的问题:

  • 内容层(README 目录):51 个分类、2,292 条目,是唯一面向读者的产品。文首的分类索引用 51 条锚点链接直达各节,分类内部按字母序排列,找起来不需要搜索。每个条目固定 5 列:名称、描述、认证、HTTPS、CORS,不多不少——多一列都会让 2,799 行的表格更难维护。描述还有 100 字的硬上限(format.py 里的 max_description_length),逼着贡献者一句话说清接口是干什么的,表格才不会被长文案撑变形。
  • 新增的生态层(MCP Servers):30 行的一节,列的是能装进 Claude、Cursor、VS Code 的 MCP 服务器。它的列换成了“传输方式 / 安装入口”,因为对 Agent 来说,关键问题不是支不支持 CORS,而是怎么装、走 stdio 还是 HTTP。这说明目录在跟着调用方变化:以前是给人读的,现在也要给 Agent 读。
  • 治理层(校验脚本 + CI):format.py 规定死规则——描述不超过 100 字、每个分类至少 3 条、分类内按字母序、认证只能取 apiKey、OAuth 等枚举值;links.py 逐条请求链接,400 以上且非 Cloudflare 拦截才算死链,还会查重复链接。PR 合并前必须过这套门禁。
  • 商业层(置顶赞助区):文首的 APILayer 横幅和推荐表是赞助内容,与正文目录分开。这层不产生目录价值,但解释了项目长期维护的资金来源;读的时候要分清,置顶推荐不等于社区评分最高。

技术亮点

亮点一:用“五列硬指标”代替主观评价,选型成本降到一行。 每个条目不写“好用”“推荐”之类的评语,只给可验证的事实:要不要 Key、走不走 HTTPS、支不支持跨域。实测统计:2,292 条中认证为 No(无需 Key)的有 1,106 条,约占 48%;需要 apiKey 的 1,009 条,OAuth 的 155 条;HTTPS 为 Yes 的 2,162 条,约占 94%。这意味着“免 Key 即用”只是将近一半条目的属性,另一半接进去之前要先申请 Key、看免费额度——“免费”在这里大多指免费层,而不是无条件无限用。这个代价是诚实的:它不帮你做决定,但把做决定需要的事实一次性摆出来。

亮点二:把清单当成代码仓来治理,规模越大越能看出这套机制的价值。 2,799 行的 Markdown 靠人工根本维护不住,所以仓库用 format.py 的硬规则(描述限 100 字、每类至少 3 条、字母序、枚举值)加 links.py 的逐链检查,再由 3 个 GitHub Actions 工作流在每次 PR 时执行,另有 638 行单元测试覆盖校验脚本本身。最近一次合并是 2026 年 11 月 1 日的 PR #8331,说明这套流水线至今仍在运转。但也要看到边界:本地实测对当前 README 跑 format.py,会输出约 650 行提示,包括置顶赞助区不在字母序内、新增的 MCP 表格列数与五列规则不一致——规则演进(加 MCP)快于校验脚本更新,门禁并非零警告。这是所有“文档即代码”项目的通病:规则一旦变多,校验器本身就成了需要维护的第二份代码。

亮点三:CORS 一列暴露了“免费 API 最容易踩的坑”。 实测中 CORS 为 Unknown 的有 1,040 条,约占 45%,Yes 的 935 条,No 的 275 条。也就是说,近一半条目没法从表格里直接判断浏览器端能不能调。很多新手在服务端调通、搬到前端才发现被跨域挡住,这张表至少提前告诉你:Unknown 的条目要先实测,别直接写进前端代码。这个设计值得所有做 API 目录的人抄:认证、HTTPS、CORS 三列,恰好对应接 API 时最先遇到的三个问题。

值得参考的设计或实现

  • “一表五列”的信息架构:给每个条目限定固定列数和枚举值,拒绝自由发挥。想做任何清单类项目(工具、数据集、学习资源),先定死列和枚举,再谈收录标准,规模上来后才不会乱。
  • 校验脚本与内容同仓:scripts/validate/ 不是外挂工具,而是仓库的一部分,PR 门禁直接调用它。内容贡献者不需要读长篇规范,跑不通脚本就知道哪里违规。
  • 用链接检查对抗“清单腐烂”:免费 API 最大的敌人是悄悄下线。links.py 逐条请求、区分 Cloudflare 拦截与真实死链的做法,比“定期人工巡查”可靠得多;做类似目录时,死链检查应该是 CI 的一部分,而不是运营的季度任务。
  • 新生态单独成节,不破坏旧表结构:MCP 服务器没有硬塞进五列表格,而是另起一节、换一套列(传输方式、安装入口)。当新形态出现时,宁可加一节,也不要为了兼容去改已有 2,292 行的格式——这是它 10 年没散架的原因之一。

适合谁

  • 正在找公开数据源做 side project、练手项目或 Demo 的开发者:天气、汇率、动漫、体育、政务数据,基本按图索骥就能找到免 Key 的入口。
  • 需要给产品快速接第三方数据的独立开发者和小型团队:先按认证和 CORS 两列过滤,能省掉大量“接进去才发现不能用”的返工。
  • 做 AI Agent 工具集成的开发者:新增的 MCP Servers 一节直接列出了可安装的服务器和安装入口。
  • 想学习“如何长期维护一份社区清单”的开源维护者:它的治理脚本比目录本身更值得读。

怎么上手

  1. 打开仓库 README,先看顶部的分类索引,跳到你需要的分类(比如 Weather、Finance、Geocoding)。
  2. 在该分类表格里先看 Auth 列:选 No 的可以零注册直接调;选 apiKey 的先去对方官网申请免费 Key。
  3. 再看 CORS 列:浏览器端直接调用的,只选 Yes;Unknown 的先用 curl 或服务端代理验证一次。
  4. 点条目链接去官方文档确认免费额度、速率限制和商用条款——表格只告诉你“能不能接”,额度与条款以官方文档为准。
  5. 拿 Weather 分类当参照很好理解这套筛选逻辑:7Timer! 认证为 No、HTTPS 为 No,适合服务端或练手调用;AccuWeather 需要 apiKey 且 CORS 为 Unknown,浏览器端直调前必须先实测;同一分类里的条目门槛可以完全不同,逐行看 Auth、HTTPS、CORS 三列比看分类名更重要。
  6. 如果发现某个接口已失效或有新的免费 API,可以按 CONTRIBUTING.md 的格式提 PR,CI 会自动校验格式和链接。

数据卡

  • 仓库链接:https://github.com/public-apis/public-apis
  • Star:495,510(实时值;Atlas 快照为 493,381)
  • Fork:55,310
  • 主要语言:Python(校验脚本语言;内容本体为 Markdown)
  • 许可证:MIT
  • Atlas 分类与领域:后端与数据库 / 软件开发
  • 创建时间:2016-03-20
  • 最近更新:2026-11-03(最近推送 2026-11-01)
  • 默认分支:master
  • 开放 Issue:2,541
  • 实测体量:README 335,205 字节、2,799 行;51 个分类、2,292 条带链接表格行;校验脚本与测试合计约 1,194 行

← 返回仓库目录