
最近一个感受越来越强烈:
现在做 Agent,最缺的往往不是模型,而是“能把世界接进来”的弹药。
Agent 需要的不只是大脑,还需要触手,这些触手就是 API。
API 是 Agent 连接真实世界的接口,GitHub 上有个宝藏仓库,叫 public-apis[1]。41 万 + Star,是 GitHub 历史上最受欢迎的项目之一。社区维护多年,收录了 1400+ 个免费公开 API,覆盖 50+ 个分类。天气、新闻、汇率、图书、区块链、机器学习、地理编码……你能想到的数据源,基本都有。
我把它叫做小龙虾的弹药库。https://github.com/public-apis/public-apis
今天这篇文章,我带你用 OpenClaw(小龙虾)+ public-apis,实打实地跑几个案例。看看当 Agent 装上弹药库之后,能干什么。
分类涵盖:
Animals · Anime · Blockchain · Books · Business · Calendar · Cloud Storage · Cryptocurrency · Currency Exchange · Data Validation · Development · Email · Entertainment · Finance · Food & Drink · Games · Geocoding · Government · Health · Jobs · Machine Learning · Music · News · Open Data · Photography · Programming · Science & Math · Security · Social · Sports · Test Data · Text Analysis · Transportation · URL Shorteners · Video · Weather ……
每个 API 都标注了四个关键信息:
字段 | 含义 | 为什么重要 |
|---|---|---|
Auth | 认证方式(No / apiKey / OAuth) | No = 直接调用,零门槛 |
HTTPS | 是否支持 HTTPS | 安全性,生产环境必须 |
CORS | 跨域支持 | 前端直调时需要关注 |
Description | API 简介 | 快速判断是否满足需求 |
这意味着你可以快速筛选出零门槛、即开即用的 API。
如果是我给 OpenClaw 接工具,我会这么看:
1. 先看 Auth
No:最适合原型验证,接起来最快apiKey:适合正式一点的 demo,或者轻生产场景OAuth:适合用户账号绑定,但接入复杂度会明显上来2. 再看 CORS
CORS=Yes 会省很多事3. 最后看文档质量和配额
我今天挑的 6 个,全部都是 Auth = No(不需要 API Key)的。
下面挑 6 个不需要 API Key、开箱即用的 API,每个给出场景、对话方式和返回效果。
场景:你想在项目里加一个天气查询功能,或者单纯想知道明天要不要带伞。
API 地址:https://open-meteo.com/
你对小龙虾说:
帮我查一下北京现在的天气,用 Open-Meteo API,不需要 API Key。
小龙虾会直接用 curl 请求:
curl "https://api.open-meteo.com/v1/forecast?latitude=39.9&longitude=116.4¤t_weather=true"
返回示例:
{
"current_weather": {
"temperature": 10.0,
"windspeed": 6.5,
"winddirection": 186,
"weathercode": 3,
"is_day": 1
}
}
北京,10°C,微风,多云。一条命令搞定。
Open-Meteo 的强大之处在于参数极其丰富。你可以查小时级预报、7 天趋势、历史数据、降水概率、紫外线指数、海洋数据……而且完全免费、无需注册。每天 10,000 次请求额度,个人用完全够。
进阶玩法:让小龙虾写一个 Python 脚本,每天早上自动查天气,生成一句话播报("今天北京 10°C,多云,适合出门"),然后推送到你的 Slack 或企业微信。把 cron 一设,你就有了一个 AI 天气秘书。
场景:你是技术人,想每天花 1 分钟看完 HN 热榜。
API 地址:https://github.com/HackerNews/API
你对小龙虾说:
用 Hacker News API 获取当前 Top 5 热帖,给我标题和链接。
小龙虾的做法:
# 1. 获取热帖 ID 列表
curl -s "https://hacker-news.firebaseio.com/v0/topstories.json" | jq '.[0:5]'
# 2. 逐个获取详情
curl -s "https://hacker-news.firebaseio.com/v0/item/47367129.json"
返回示例:
1. 1M context is now generally available for Opus 4.6 and Sonnet 4.6
🔗 https://claude.com/blog/1m-context-ga
👍 Score: 560
进阶玩法:让小龙虾写一个定时脚本,每天早上抓取 Top 10,调用大模型生成中文摘要,保存为 Markdown 每日简报。你甚至可以让它自动判断哪些文章跟你的技术栈相关,只推送你关心的内容。Agent + API + LLM,三件套组合拳,信息获取效率直接翻倍。
场景:你想按关键词搜书,或者给读书会找推荐书目。
API 地址:https://openlibrary.org/developers/api
你对小龙虾说:
帮我在 Open Library 上搜一下 "deep learning" 相关的书,列出前 5 本的书名、作者和出版年份。
curl -s "https://openlibrary.org/search.json?q=deep+learning&limit=5"
返回示例(节选):
书名 | 作者 | 出版年份 |
|---|---|---|
Deep Learning | Ian Goodfellow, Yoshua Bengio | 2016 |
Deep Learning with Python | François Chollet | 2017 |
Hands-On Machine Learning | Aurélien Géron | 2017 |
Open Library 是 Internet Archive 的项目,数据覆盖面极广,而且完全免费、无需注册。除了搜索,它还支持按 ISBN 查询、获取封面图片、获取完整元数据。你可以让小龙虾帮你做一个"技术书单生成器"——输入关键词,输出一份带封面、作者、出版年份的 Markdown 书单。
场景:做跨境业务、海淘比价,或者纯粹想知道今天美元兑人民币多少。
API 地址:https://open.er-api.com/
你对小龙虾说:
查一下当前美元兑人民币、欧元、日元的汇率。
curl -s "https://open.er-api.com/v6/latest/USD"
返回示例:
1 USD = 6.91 CNY
1 USD = 0.87 EUR
1 USD = 159.54 JPY
免费版每天更新一次,对大多数场景够用了。
进阶玩法:让小龙虾写一个汇率监控脚本,当人民币跌破某个阈值时自动发送提醒。或者做一个"海淘比价助手"——输入商品美元价格,自动换算成人民币并加上关税估算。
场景:你在做安全分析、访问日志审计,或者纯粹想知道某个 IP 在哪。
API 地址:http://ip-api.com/
你对小龙虾说:
帮我查一下 IP 地址 8.8.8.8 的地理位置信息。
curl -s "http://ip-api.com/json/8.8.8.8"
返回示例:
{
"country": "United States",
"regionName": "Virginia",
"city": "Ashburn",
"org": "Google Public DNS",
"isp": "Google LLC",
"query": "8.8.8.8"
}
ip-api 免费版每分钟支持 45 次请求,返回国家、地区、城市、ISP、经纬度等完整信息。不需要注册,不需要 Key。
进阶玩法:让小龙虾写一个日志分析脚本,读取 Nginx access log,提取所有访问 IP,批量查询地理位置,生成一份"访客地区分布报告"。
场景:你在写文档,想给 HTTP 状态码配一张直观的图片。
API 地址:https://http.cat/
你对小龙虾说:
给我生成一个 Markdown 文件,列出常见的 HTTP 状态码(200、404、500、403、418),每个配上 HTTP Cat 的图片。
小龙虾生成的 Markdown:
## HTTP 状态码速查
### 200 OK

### 404 Not Found

### 418 I'm a Teapot

这个 API 没什么"实用价值",但它说明了一件事:API 的世界比你想的有趣得多。类似的还有 HTTP Dog[2]、Random Fox[3]、PlaceKitten[4] 等。
场景:你在搭前端原型,需要假数据来跑通流程。
API 地址:https://jsonplaceholder.typicode.com/
你对小龙虾说:
用 JSONPlaceholder 帮我生成一个博客前端的假数据方案:获取文章列表、单篇文章、文章评论。
# 文章列表
curl -s "https://jsonplaceholder.typicode.com/posts?_limit=3"
# 单篇文章
curl -s "https://jsonplaceholder.typicode.com/posts/1"
# 文章评论
curl -s "https://jsonplaceholder.typicode.com/posts/1/comments"
JSONPlaceholder 提供 6 类资源:posts、comments、albums、photos、todos、users。支持 GET / POST / PUT / DELETE,完整模拟 RESTful API。搭原型、写测试、学前端,全靠它。
上面 7 个例子都是"一个 API 一个用法"。但真正的威力在于组合。
你可以直接对小龙虾说:
帮我写一个 Python 脚本,同时查询:
小龙虾会一口气把三个 API 的调用逻辑写完,输出一个格式化的每日报告。这个脚本你加个 cron 定时任务,就是一个完整的自动化信息聚合系统。
关键是你不需要自己去读每个 API 的文档——告诉 Agent 你要什么数据,它自己去查文档、写调用代码、处理异常。
如果你想让 API 作为 OpenClaw 的持久工具而不是每次手动调用,可以把它封装成 MCP Server。MCP(Model Context Protocol)是 Agent 调用外部工具的标准协议。
简化逻辑:
API endpoint → 封装成 MCP Tool → 注册到 OpenClaw → Agent 按需自动调用
举个例子:你把 Open-Meteo 封装成一个 get_weather 工具,注册到 OpenClaw。以后你只要说"明天北京会不会下雨",Agent 就会自己调用这个工具,你都不用提"用 Open-Meteo API"。
社区已经有不少现成的 MCP Server 可以直接用。你也可以让小龙虾帮你从零写一个——告诉它 API 的 endpoint 和参数,它几分钟就能生成一个完整的 MCP Server。
public-apis 的 README 是个 19 万字的 Markdown 文件。你可以直接让小龙虾帮你筛选:
从 public-apis 仓库的 README 中,找出所有不需要 API Key、支持 HTTPS 的天气类 API,列成表格。
Agent 读 Markdown、解析表格、过滤条件,这些都是它的强项。
用 public-apis 之前,有几个坑你需要知道:
1. API Key 安全
有些 API 需要注册获取 Key。千万不要把 Key 硬编码在代码里,更不要提交到 Git。用环境变量或 .env 文件管理。如果你用小龙虾写代码,可以直接告诉它"API Key 从环境变量读取",它会自动用 os.environ 的方式来处理。
2. Rate Limit(请求频率限制)
免费 API 几乎都有频率限制。比如:
超限会被封 IP 或返回错误。写定时脚本的时候注意控制频率。
3. 数据时效性
public-apis 仓库是社区维护的,有些 API 可能已经下线、改了地址、或者修改了认证方式。用之前先手动 curl 一下验证可用性。好消息是,上面推荐的几个都是长期稳定运行的项目。
4. CORS 限制
如果你从浏览器前端直接调用 API,注意 CORS 策略。从后端、终端、或 Agent 调用则完全没有这个问题。
5. 数据准确性
免费 API 的数据精度可能不如付费版。比如天气预报的精确度、汇率数据的更新频率。对精度要求高的生产场景,建议还是用付费 API。
public-apis 不是一个新项目,它已经存在很多年了。但在 AI Agent 时代,它的价值被重新放大了。
以前,这些 API 是给开发者手动调用的。现在,它们是 Agent 的弹药库——你不需要自己写调用代码,只需要告诉 Agent 你想干什么,它会自己去找 API、写调用、解析结果。
1400+ 个免费 API,就是 1400+ 个 Agent 可以直接使用的能力。
去翻翻 public-apis[5] 的分类列表吧,总有几个能让你的小龙虾变得更强。