文档【免费下载链接】public-apisA collective list of free APIs项目地址https://gitcode.com/GitHub_Trending/pu/public-apis点击查看免费下载本指南围绕当前仓库根文档 README.md 展开系统讲解 public-apis 这一社区人工维护的免费公共 API 精选集的组织方式从 50 领域分类的索引体系、每条 API 条目的五大字段规范到 MCPModel Context Protocol服务器专区再到配套的格式校验、链接健康检查脚本与单元测试的完整使用流程。读完本文你将能快速定位任意领域的可用公共 API、准确读懂并编写符合仓库规范的 API 条目并能在本地复现仓库维护者使用的自动化校验工具链。项目定位一份社区人工精选的免费 API 清单README 开篇即明确了仓库的定位由社区成员与 APILayer 团队共同人工维护manually curated的公共 API 集合覆盖众多领域可直接用于开发者自己的产品。它并非自动抓取的目录而是经过筛选与格式约束的质量清单核心标准是免费可用要求被收录的 API 具有完整免费访问权或至少提供免费档位free tier且不依赖购买实体设备才能使用详见 CONTRIBUTING.md 顶部说明。与之配套仓库还提供了完整的工具链来保证清单质量集中在 scripts 目录scripts │ github_pull_request.sh # PR 变更的链接校验脚本 │ requirements.txt # validate 包的依赖 ├───tests # validate 包的单元测试 │ test_validate_format.py │ test_validate_links.py └───validate # 校验包 format.py # Markdown 表格格式校验 links.py # 链接重复与可用性校验全局索引50 领域的分类导航README 在正文中段## Index之后维护了一张完整的领域导航表每个分类既是章节锚点也是该领域的 API 表头。当前仓库共收录约 50 个分类覆盖从基础开发工具到垂直行业数据的方方面面领域分组包含分类数据与开发Animals、Anime、Anti-Malware、Art Design、Authentication Authorization、Blockchain、Books、Business、Calendar、Cloud Storage File Sharing、Continuous Integration、Cryptocurrency、Currency Exchange、Data Validation、Development、Dictionaries、Documents Productivity内容与资讯Email、Entertainment、Environment、Events、Finance、Food Drink、Games Comics、Geocoding、Government、Health、Jobs、Machine Learning、Music、News、Open Data、Open Source Projects、Patent、Personality、Phone、Photography业务与生活Programming、Science Math、Security、Shopping、Social、Sports Fitness、Test Data、Text Analysis、Tracking、Transportation、URL Shorteners、Vehicle、Video、Weather每个分类下都遵循统一表格结构。以 Animals 分类为例其结构为### Animals API | Description | Auth | HTTPS | CORS |:---|:---|:---|:---|:---| | Cat Facts | Random cat facts | No | Yes | Yes | | Dogs | Based on the Stanford Dogs Dataset | No | Yes | Yes | | The Dog | A public service all about Dogs... | apiKey | Yes | No |各分类的典型条目仅举代表性示例均出自 READMEWeather 分类下的 OpenWeatherMapapiKey与 wttr.in支持终端输出与 JSONCryptocurrency 下的 CoinGecko无需鉴权Geocoding 下的 IPstackapiKeyTest Data 下的 JSONPlaceholder无鉴权、适合原型测试。你既可以在 README 中按领域浏览也可以直接 CtrlF 搜索 API 名称快速定位。条目字段规范五列表格的取值约束README 中每条 API 条目均固定为五列这是仓库数据质量的核心契约。字段含义与取值规范如下规范来源CONTRIBUTING.md 的 Formatting 章节并与 格式校验脚本 的常量一一对应字段含义合法取值API链接到官方文档的 API 名称Markdown 格式TITLE名称不应以 API 结尾仓库中每条本来就是 APIDescription对该 API 的一句话描述首字符大写、不以标点结尾、不超过 100 字符Auth是否需要鉴权OAuth、apiKey、X-Mashape-Key、No、User-Agent除No外均需用反引号包裹如apiKeyHTTPS是否支持 HTTPSYes、NoCORS是否支持跨域浏览器直连Yes、No、Unknown其中Auth字段的五种取值语义见 CONTRIBUTING.mdOAuth—— API 支持 OAuth 授权流程apiKey—— API 使用私有的密钥字符串/令牌进行鉴权X-Mashape-Key—— 需要发送指定名称的请求头No—— API 无需任何鉴权即可调用User-Agent—— 需要随请求发送 User-Agent 头。CORS字段的意义在于提示该 API 能否被浏览器前端直接调用CONTRIBUTING.md 明确提醒缺少正确的 CORS 配置时API 只能服务端使用Without proper CORS configuration an API will only be usable server side。因此Unknown是一个诚实且被允许的取值——不确定时如实标注而不是猜一个Yes。格式校验脚本 format.py 将这些规范固化成了可执行的规则核心常量与检查点包括枚举常量auth_keys、https_keys、cors_keys 直接对应上述合法取值条目约束num_segments 5、min_entries_per_category 3每个分类至少 3 条、max_description_length 100逐行检查逻辑check_file_format 会依次校验——分类头必须登记在 Index 索引中、每分类条目数不低于最小值、每个字段列两侧恰好各 1 个空格、缺失列数检查再对每条记录执行 check_entry 的五项子校验标题语法、描述、鉴权、HTTPS、CORS全局检查check_alphabetical_order要求每个分类内的 API 按名称字母序排列乱序会直接报错退出。MCP Servers 专区为 AI Agent 准备的独立入口README 在## MCP Servers章节为 Model Context Protocol 服务器单独设置了专区这是它与普通 REST API 条目的关键差异MCP 服务器不是被调用的 HTTP 接口而是被安装进 AI 客户端如 Claude、Cursor、VS Code的工具。因此其表格字段也完全不同NameDescriptionAuthTransportInstallIPstack MCPIP 地理定位、威胁与时区查询apiKeystdio,HTTPCursor · GlamaGitHub仓库、Issue、PR、代码搜索OAuthstdio,HTTPGlamaFilesystem本地文件读写Nostdio–该专区的字段规范在 CONTRIBUTING.md 中有专门说明Auth字段沿用普通 API 的同一套合法取值OAuth、apiKey、X-Mashape-Key、No、User-AgentTransport目前仅接受三种取值stdio作为本地子进程通过标准输入输出运行、HTTP通过流式 HTTP 可达、SSE传统 Server-Sent Events 传输支持多种时用逗号分隔如stdio, HTTPInstall字段链接到该服务器实际发布的市场仓库当前跟踪 Cursor、Anthropic、Glama 三个市场若尚未在任何市场收录则用–标注这是正常状态、不扣分但只允许链接真实存在的市场页面指向 404 页面的链接会导致 PR 被关闭。链接健康检查从格式到可达性的双重保障除了表格格式仓库还通过 links.py 对 README 中所有链接做两层检查1. 重复链接检测脚本从 README 的## Index章节开始提取全部 URL见 find_links_in_file忽略 Index 之前的广告与说明区域再去掉尾部/后比较发现重复即列出并退出码 1见 check_duplicate_links。2. 链接可达性检测对每条链接发起真实 HTTP 请求见 check_if_link_is_working技术要点包括25 秒超时并携带随机挑选的浏览器 User-Agent部分托管服务会拦截非白名单 UA见 fake_user_agent同时发送匹配的host请求头从 URL 解析主机名见 get_host_from_link针对 Cloudflare 防护的误报处理当状态码为 403/503 且响应头Server: cloudflare时进一步在 HTML 中查找 Cloudflare、We are checking your browser...、cf-spinner等特征标志命中则视为链接其实可用而非错误见 has_cloudflare_protection错误分类清晰ERR:CLTHTTP ≥400、ERR:SSLTLS 错误、ERR:CNT连接失败、ERR:TMO超时、ERR:TMR重定向过多、ERR:UKN未知异常。此外github_pull_request.sh 用于 CI 中对 Pull Request 的 diff 增量行单独做链接校验它拉取patch-diff.githubusercontent.com的补丁、提取以开头的增行仅对新添加的链接执行校验从而把全量扫描的耗时隔离在 PR 之外。本地复现校验命令行实操按 scripts/README.md 的说明你可以在本地完整复现这套校验流程。前置条件是需要安装 Python 与 pip随后安装依赖python -m pip install -r scripts/requirements.txt在仓库根目录对 README 执行格式校验python scripts/validate/format.py README.md执行链接校验注意链接数量庞大、全量可达性检查可能耗时较长python scripts/validate/links.py README.md若只想检查重复链接而跳过可达性检查可加-odlc即--only_duplicate_links_checker的缩写python scripts/validate/links.py README.md -odlc运行整套单元测试需先进入 scripts 目录cd scripts python -m unittest discover tests/ --verbose只跑格式测试或只跑链接测试时可通过--pattern参数过滤python -m unittest discover tests/ --verbose --pattern test_validate_format.py python -m unittest discover tests/ --verbose --pattern test_validate_links.py测试用例视角校验规则的验收标准校验逻辑的正确性由 scripts/tests/test_validate_format.py 与 scripts/tests/test_validate_links.py 两个测试文件保障它们本身就是仓库规范的可执行文档。例如格式测试覆盖了标题语法A(https://www.ex.com)这种残缺写法会被拒绝Title syntax should be [TITLE标题命名A API会被拒绝Title should not end with ... API描述质量首字母未大写、以标点结尾、超过 100 字符分别触发对应错误字段枚举yes/no/Unknown等大小写或取值错误分别触发 Auth/HTTPS/CORS 的非法取值报错结构性约束分类头未登记到 Index、分类条目不足 3 条、缺少必需列、列间空格不足 1 个均有对应错误消息。链接测试则覆盖了 URL 正则提取带参数与锚点的合法链接 vshttps:/example.com等非法写法、重复链接判定、User-Agent 生成、host 解析以及 Cloudflare 防护特征检测通过构造 403/503 响应模拟验证见 test_validate_links.py。快速上手三条实操路径纯使用者打开 README.md通过## Index定位领域分类直接浏览对应表格阅读条目时重点看Auth是否需要密钥与CORS能否浏览器直连两列结合HTTPS列判断传输安全级别即可快速评估某 API 是否适合你的项目。AI Agent 开发者优先查看## MCP Servers专区按Transportstdio 或 HTTP与Install市场渠道选择合适的 MCP 服务器安装进客户端。贡献者阅读 CONTRIBUTING.md 掌握条目格式与 PR 规范每条新增一个 API、保持字母序、描述 ≤100 字符、PR 标题形如Add Api-name API等提交前先在本地跑一遍format.py与links.py校验并确认 CI 构建通过。附许可证与延伸阅读仓库采用 MIT 许可证。与此主题强相关的仓库内文档还有用于理解条目编写规范的 CONTRIBUTING.md、用于掌握校验工具链使用方法的 scripts/README.md以及可直接阅读并运行的校验实现 scripts/validate/format.py 与 scripts/validate/links.py。如需提交变更可参考 README 中 Get Involved 章节的指引并遵循贡献规范操作。赞分享文档【免费下载链接】public-apisA collective list of free APIs项目地址https://gitcode.com/GitHub_Trending/pu/public-apis点击查看免费下载相关推荐【亲测免费】 公共API的统一入口Public API for Public APIs公共API的统一入口Public API for Public APIs 在这个数字化的时代开放API已成为数据共享和技术创新的关键驱动力。 Publichiring-without-whiteboards 贡献指南公司列表格式规范、入选标准与自动化校验全解析hiring without whiteboards 贡献指南公司列表格式规范、入选标准与自动化校验全解析 本篇指南以 CONTRIBUTING.md htt文档知识库Parler-TTS模型安全更新通知2025年Q2重要补丁预告Parler TTS模型安全更新通知2025年Q2重要补丁预告 你是否还在为文本转语音Text to Speech, TTS模型的安全漏洞担忧是否担心训知识库文档创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考