最近一個(gè)感受越來越強(qiáng)烈：

現(xiàn)在做 Agent，最缺的往往不是模型，而是“能把世界接進(jìn)來”的彈藥。

Agent 需要的不只是大腦，還需要觸手，這些觸手就是 API。

API 是 Agent 連接真實(shí)世界的接口，GitHub 上有個(gè)寶藏倉(cāng)庫(kù)，叫 public-apis[1]。41 萬 + Star，是 GitHub 歷史上最受歡迎的項(xiàng)目之一。社區(qū)維護(hù)多年，收錄了 1400+ 個(gè)免費(fèi)公開 API，覆蓋 50+ 個(gè)分類。天氣、新聞、匯率、圖書、區(qū)塊鏈、機(jī)器學(xué)習(xí)、地理編碼……你能想到的數(shù)據(jù)源，基本都有。

我把它叫做小龍蝦的彈藥庫(kù)。https://github.com/public-apis/public-apis

今天這篇文章，我?guī)阌?OpenClaw（小龍蝦）+ public-apis，實(shí)打?qū)嵉嘏軒讉€(gè)案例?？纯串?dāng) Agent 裝上彈藥庫(kù)之后，能干什么。

public-apis 倉(cāng)庫(kù)概況

分類涵蓋：

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 ……

每個(gè) API 都標(biāo)注了四個(gè)關(guān)鍵信息：

字段

含義

為什么重要

Auth

認(rèn)證方式（No / apiKey / OAuth）

No = 直接調(diào)用，零門檻

HTTPS

是否支持 HTTPS

安全性，生產(chǎn)環(huán)境必須

CORS

跨域支持

前端直調(diào)時(shí)需要關(guān)注

Description

API 簡(jiǎn)介

快速判斷是否滿足需求

這意味著你可以快速篩選出零門檻、即開即用的 API。

如果是我給 OpenClaw 接工具，我會(huì)這么看：

1. 先看 Auth

• No ：最適合原型驗(yàn)證，接起來最快

• apiKey ：適合正式一點(diǎn)的 demo，或者輕生產(chǎn)場(chǎng)景

• OAuth ：適合用戶賬號(hào)綁定，但接入復(fù)雜度會(huì)明顯上來

2. 再看 CORS

• 如果你是瀏覽器側(cè)工具、前端頁(yè)面、WebView， CORS=Yes 會(huì)省很多事

• 如果你是服務(wù)端代理調(diào)用，這一列的重要性就沒那么高

3. 最后看文檔質(zhì)量和配額

• 免費(fèi)不等于無限制

• 有 free tier，不代表能扛生產(chǎn)流量

• 文檔差的 API，接入成本有時(shí)比自己包一層還高

我今天挑的 6 個(gè)，全部都是 Auth = No（不需要 API Key）的。

實(shí)戰(zhàn)：OpenClaw + 免費(fèi) API

下面挑 6 個(gè)不需要 API Key、開箱即用的 API，每個(gè)給出場(chǎng)景、對(duì)話方式和返回效果。

1. ? Open-Meteo —— 全球天氣，零認(rèn)證

場(chǎng)景：你想在項(xiàng)目里加一個(gè)天氣查詢功能，或者單純想知道明天要不要帶傘。

API 地址：https://open-meteo.com/

你對(duì)小龍蝦說：

幫我查一下北京現(xiàn)在的天氣，用 Open-Meteo API，不需要 API Key。

小龍蝦會(huì)直接用 curl 請(qǐng)求：

curl "https://api.open-meteo.com/v1/forecast?latitude=39.9&longitude=116.4&current_weather=true"

返回示例：

{
  "current_weather": {
    "temperature": 10.0,
    "windspeed": 6.5,
    "winddirection": 186,
    "weathercode": 3,
    "is_day": 1
  }
}

北京，10°C，微風(fēng)，多云。一條命令搞定。

Open-Meteo 的強(qiáng)大之處在于參數(shù)極其豐富。你可以查小時(shí)級(jí)預(yù)報(bào)、7 天趨勢(shì)、歷史數(shù)據(jù)、降水概率、紫外線指數(shù)、海洋數(shù)據(jù)……而且完全免費(fèi)、無需注冊(cè)。每天 10,000 次請(qǐng)求額度，個(gè)人用完全夠。

進(jìn)階玩法：讓小龍蝦寫一個(gè) Python 腳本，每天早上自動(dòng)查天氣，生成一句話播報(bào)（"今天北京 10°C，多云，適合出門"），然后推送到你的 Slack 或企業(yè)微信。把 cron 一設(shè)，你就有了一個(gè) AI 天氣秘書。

2. Hacker News —— 科技熱點(diǎn)每日簡(jiǎn)報(bào)

場(chǎng)景：你是技術(shù)人，想每天花 1 分鐘看完 HN 熱榜。

API 地址：https://github.com/HackerNews/API

你對(duì)小龍蝦說：

用 Hacker News API 獲取當(dāng)前 Top 5 熱帖，給我標(biāo)題和鏈接。

小龍蝦的做法：

# 1. 獲取熱帖 ID 列表
curl -s "https://hacker-news.firebaseio.com/v0/topstories.json" | jq '.[0:5]'


 # 2. 逐個(gè)獲取詳情
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

進(jìn)階玩法：讓小龍蝦寫一個(gè)定時(shí)腳本，每天早上抓取 Top 10，調(diào)用大模型生成中文摘要，保存為 Markdown 每日簡(jiǎn)報(bào)。你甚至可以讓它自動(dòng)判斷哪些文章跟你的技術(shù)棧相關(guān)，只推送你關(guān)心的內(nèi)容。Agent + API + LLM，三件套組合拳，信息獲取效率直接翻倍。

3. Open Library —— 全球圖書搜索

場(chǎng)景：你想按關(guān)鍵詞搜書，或者給讀書會(huì)找推薦書目。

API 地址：https://openlibrary.org/developers/api

你對(duì)小龍蝦說：

幫我在 Open Library 上搜一下 "deep learning" 相關(guān)的書，列出前 5 本的書名、作者和出版年份。

curl -s "https://openlibrary.org/search.json?q=deep+learning&limit=5"

返回示例（節(jié)選）：

書名

作者

出版年份

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 的項(xiàng)目，數(shù)據(jù)覆蓋面極廣，而且完全免費(fèi)、無需注冊(cè)。除了搜索，它還支持按 ISBN 查詢、獲取封面圖片、獲取完整元數(shù)據(jù)。你可以讓小龍蝦幫你做一個(gè)"技術(shù)書單生成器"——輸入關(guān)鍵詞，輸出一份帶封面、作者、出版年份的 Markdown 書單。

4. ExchangeRate API —— 實(shí)時(shí)匯率

場(chǎng)景：做跨境業(yè)務(wù)、海淘比價(jià)，或者純粹想知道今天美元兌人民幣多少。

API 地址：https://open.er-api.com/

你對(duì)小龍蝦說：

查一下當(dāng)前美元兌人民幣、歐元、日元的匯率。

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

免費(fèi)版每天更新一次，對(duì)大多數(shù)場(chǎng)景夠用了。

進(jìn)階玩法：讓小龍蝦寫一個(gè)匯率監(jiān)控腳本，當(dāng)人民幣跌破某個(gè)閾值時(shí)自動(dòng)發(fā)送提醒。或者做一個(gè)"海淘比價(jià)助手"——輸入商品美元價(jià)格，自動(dòng)換算成人民幣并加上關(guān)稅估算。

5. IP Geolocation (ip-api) —— IP 定位，免費(fèi)好用

場(chǎng)景：你在做安全分析、訪問日志審計(jì)，或者純粹想知道某個(gè) IP 在哪。

API 地址：http://ip-api.com/

你對(duì)小龍蝦說：

幫我查一下 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 免費(fèi)版每分鐘支持 45 次請(qǐng)求，返回國(guó)家、地區(qū)、城市、ISP、經(jīng)緯度等完整信息。不需要注冊(cè)，不需要 Key。

進(jìn)階玩法：讓小龍蝦寫一個(gè)日志分析腳本，讀取 Nginx access log，提取所有訪問 IP，批量查詢地理位置，生成一份"訪客地區(qū)分布報(bào)告"。

6. HTTP Cat —— API 也可以很好玩

場(chǎng)景：你在寫文檔，想給 HTTP 狀態(tài)碼配一張直觀的圖片。

API 地址：https://http.cat/

你對(duì)小龍蝦說：

給我生成一個(gè) Markdown 文件，列出常見的 HTTP 狀態(tài)碼（200、404、500、403、418），每個(gè)配上 HTTP Cat 的圖片。

小龍蝦生成的 Markdown：

## HTTP 狀態(tài)碼速查

 ### 200 OK
![200](https://http.cat/200)

 ### 404 Not Found
![404](https://http.cat/404)

 ### 418 I'm a Teapot
![418](https://http.cat/418)

這個(gè) API 沒什么"實(shí)用價(jià)值"，但它說明了一件事：API 的世界比你想的有趣得多。類似的還有 HTTP Dog[2]、Random Fox[3]、PlaceKitten[4] 等。

7. JSONPlaceholder —— 原型開發(fā)的瑞士軍刀

場(chǎng)景：你在搭前端原型，需要假數(shù)據(jù)來跑通流程。

API 地址：https://jsonplaceholder.typicode.com/

你對(duì)小龍蝦說：

用 JSONPlaceholder 幫我生成一個(gè)博客前端的假數(shù)據(jù)方案：獲取文章列表、單篇文章、文章評(píng)論。

# 文章列表
curl -s "https://jsonplaceholder.typicode.com/posts?_limit=3"

 # 單篇文章
curl -s "https://jsonplaceholder.typicode.com/posts/1"

 # 文章評(píng)論
curl -s "https://jsonplaceholder.typicode.com/posts/1/comments"

JSONPlaceholder 提供 6 類資源：posts、comments、albums、photos、todos、users。支持 GET / POST / PUT / DELETE，完整模擬 RESTful API。搭原型、寫測(cè)試、學(xué)前端，全靠它。

進(jìn)階：怎么批量接入？

上面 7 個(gè)例子都是"一個(gè) API 一個(gè)用法"。但真正的威力在于組合。

方法一：讓小龍蝦寫組合腳本

你可以直接對(duì)小龍蝦說：

幫我寫一個(gè) Python 腳本，同時(shí)查詢： 北京天氣（Open-Meteo） 當(dāng)前美元兌人民幣匯率（ExchangeRate API） HN Top 3 熱帖標(biāo)題 然后把結(jié)果整理成一個(gè)每日簡(jiǎn)報(bào)的 Markdown 文件，保存到桌面。

小龍蝦會(huì)一口氣把三個(gè) API 的調(diào)用邏輯寫完，輸出一個(gè)格式化的每日?qǐng)?bào)告。這個(gè)腳本你加個(gè) cron 定時(shí)任務(wù)，就是一個(gè)完整的自動(dòng)化信息聚合系統(tǒng)。

關(guān)鍵是你不需要自己去讀每個(gè) API 的文檔——告訴 Agent 你要什么數(shù)據(jù)，它自己去查文檔、寫調(diào)用代碼、處理異常。

方法二：通過 MCP Server 接入

如果你想讓 API 作為 OpenClaw 的持久工具而不是每次手動(dòng)調(diào)用，可以把它封裝成 MCP Server。MCP（Model Context Protocol）是 Agent 調(diào)用外部工具的標(biāo)準(zhǔn)協(xié)議。

簡(jiǎn)化邏輯：

API endpoint → 封裝成 MCP Tool → 注冊(cè)到 OpenClaw → Agent 按需自動(dòng)調(diào)用

舉個(gè)例子：你把 Open-Meteo 封裝成一個(gè) get_weather 工具，注冊(cè)到 OpenClaw。以后你只要說"明天北京會(huì)不會(huì)下雨"，Agent 就會(huì)自己調(diào)用這個(gè)工具，你都不用提"用 Open-Meteo API"。

社區(qū)已經(jīng)有不少現(xiàn)成的 MCP Server 可以直接用。你也可以讓小龍蝦幫你從零寫一個(gè)——告訴它 API 的 endpoint 和參數(shù)，它幾分鐘就能生成一個(gè)完整的 MCP Server。

方法三：批量篩選 API

public-apis 的 README 是個(gè) 19 萬字的 Markdown 文件。你可以直接讓小龍蝦幫你篩選：

從 public-apis 倉(cāng)庫(kù)的 README 中，找出所有不需要 API Key、支持 HTTPS 的天氣類 API，列成表格。

Agent 讀 Markdown、解析表格、過濾條件，這些都是它的強(qiáng)項(xiàng)。

注意事項(xiàng)

用 public-apis 之前，有幾個(gè)坑你需要知道：

1. API Key 安全

有些 API 需要注冊(cè)獲取 Key。千萬不要把 Key 硬編碼在代碼里，更不要提交到 Git。用環(huán)境變量或 .env 文件管理。如果你用小龍蝦寫代碼，可以直接告訴它"API Key 從環(huán)境變量讀取"，它會(huì)自動(dòng)用 os.environ 的方式來處理。

2. Rate Limit（請(qǐng)求頻率限制）

免費(fèi) API 幾乎都有頻率限制。比如：

• Open-Meteo：10,000 次/天

• ip-api：45 次/分鐘

• ExchangeRate 免費(fèi)版：每天更新一次

超限會(huì)被封 IP 或返回錯(cuò)誤。寫定時(shí)腳本的時(shí)候注意控制頻率。

3. 數(shù)據(jù)時(shí)效性

public-apis 倉(cāng)庫(kù)是社區(qū)維護(hù)的，有些 API 可能已經(jīng)下線、改了地址、或者修改了認(rèn)證方式。用之前先手動(dòng) curl 一下驗(yàn)證可用性。好消息是，上面推薦的幾個(gè)都是長(zhǎng)期穩(wěn)定運(yùn)行的項(xiàng)目。

4. CORS 限制

如果你從瀏覽器前端直接調(diào)用 API，注意 CORS 策略。從后端、終端、或 Agent 調(diào)用則完全沒有這個(gè)問題。

5. 數(shù)據(jù)準(zhǔn)確性

免費(fèi) API 的數(shù)據(jù)精度可能不如付費(fèi)版。比如天氣預(yù)報(bào)的精確度、匯率數(shù)據(jù)的更新頻率。對(duì)精度要求高的生產(chǎn)場(chǎng)景，建議還是用付費(fèi) API。

最后

public-apis 不是一個(gè)新項(xiàng)目，它已經(jīng)存在很多年了。但在 AI Agent 時(shí)代，它的價(jià)值被重新放大了。

以前，這些 API 是給開發(fā)者手動(dòng)調(diào)用的?，F(xiàn)在，它們是 Agent 的彈藥庫(kù)——你不需要自己寫調(diào)用代碼，只需要告訴 Agent 你想干什么，它會(huì)自己去找 API、寫調(diào)用、解析結(jié)果。

1400+ 個(gè)免費(fèi) API，就是 1400+ 個(gè) Agent 可以直接使用的能力。

去翻翻 public-apis[5] 的分類列表吧，總有幾個(gè)能讓你的小龍蝦變得更強(qiáng)。