前言¶
做 Demo、寫腳本或讓 Agent 查天氣、查快遞時，往往需要臨時找第三方 API 文檔、覈對參數，再寫請求代碼。接口分散、文檔質量不一，還會碰到要不要申請 Key、免費額度夠不夠的問題。下面介紹 SkillHub 社區 Skill「50個免費api」（座標 @user_29dc410e/free-api-50），它把一批常見、標註爲無需 API Key 的開放能力整理成 Agent 可遵循的說明，讓對話裏直接完成查詢與工具類操作，而不必每次從零搜文檔。
這是什麼¶
「50個免費api」是 SkillHub 上的社區來源（community）技能，分類爲 dev-programming，當前版本 1.0.1，發佈者座標爲 user_29dc410e，SkillHub 頁面標註作者爲 super paul。
一句話定位：爲編程與日常開發場景提供一份「免費接口能力清單 + 使用指引」，供 Cursor、Claude Code、Codex 等支持 Skills 的 Agent 在對話中按需調用。Skill 標籤標明 requires_api_key=false，表示設計上不依賴用戶自備 API Key（具體接口仍受各開放服務自身條款與可用性約束）。
官方入口：
- API 頁：https://api.skillhub.cn/user_29dc410e/free-api-50
- SkillHub 詳情：https://www.skillhub.cn/skills/user_29dc410e/free-api-50
核心功能¶
以下能力均來自 SkillHub 對該 Skill 的簡介說明，按主題歸納，便於對照需求；未在官方簡介中出現的能力不要假設已包含。
天氣與地理
- 天氣查詢、實時天氣、7 天預報、24 小時預報
- IP 定位
通信與物流
- 手機號歸屬地 / 吉凶
- 快遞物流
車輛與金融
- 車牌歸屬地 / 估值
- 金融工具、A 股股票實時行情、全國油價、人民幣匯率
生活與日曆
- 生活服務、垃圾分類
- 日曆 / 黃曆、倒計時 / 紀念日、歷史上的今天
內容與娛樂
- 古詩詞、成語詞典 / 接龍、星座運勢
- 隨機笑話 / 土味情話 / 一言
工具類
- 抖音去水印、二維碼生成 / 解碼、短鏈接
- OCR 文字識別
- 隨機密碼 / 姓名 / 頭像 / 壁紙
- 百科查詢、翻譯、簡繁體轉換、食物熱量查詢
安裝後，Agent 會依據 Skill 內的 SKILL.md 說明選擇對應接口完成用戶意圖；具體 URL、參數與返回格式以 Skill 正文爲準，本文不展開未覈實的接口細節。
安裝與啓用¶
SkillHub 官方推薦兩種方式：用自然語言讓 AI 按安裝文檔操作，或在本機用 skillhub CLI 安裝到當前 Agent 的 skills 目錄。
方式一：提示詞安裝¶
將下面意圖發給已支持 Skill 安裝的 AI（文案來自 SkillHub 詳情頁）：
請根據 https://skillhub.cn/install/skillhub.md，安裝 `@user_29dc410e/free-api-50`。
AI 會按 SkillHub 安裝與優先源配置 檢查 CLI、選擇正確的 skills 目錄並執行安裝。
方式二：CLI 安裝¶
先做環境檢查，再安裝到對應客戶端目錄（路徑來自 SkillHub 安裝文檔）：
command -v skillhub && skillhub --version
若未安裝 CLI，可按官方腳本安裝（完整安裝含 CLI 與默認 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
安裝本 Skill 時必須使用 --dir 指向當前 Agent 的 skills 目錄，否則默認落在 ./skills/，Agent 可能無法加載：
skillhub install @user_29dc410e/free-api-50 --dir <你的 skills 目錄>
常用目錄示例（按你實際使用的客戶端擇一）：
| 客戶端 | skills 目錄 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或項目下 .agents/skills/ |
安裝完成後，按你所用客戶端的要求重啓或刷新 Agent，使新 Skill 生效。Cursor、Codex CLI、Claude Code 的差異主要體現在 skills 路徑與是否需重啓；安裝命令本身均爲 skillhub install … --dir …。
典型用法¶
官方頁面未單獨給出可複製的一鍵示例，可復現的流程是：安裝 Skill → 在對話中用自然語言描述需求。Agent 讀取 @user_29dc410e/free-api-50 中的指引後發起對應免費 API 請求並整理結果。
下列表述與簡介中的能力一一對應，便於驗證 Skill 是否正常工作（結果取決於遠端服務與網絡）：
- 「查一下北京未來 7 天天氣」——對應 7 天預報類能力。
- 「用這個快遞單號查物流：……」——對應快遞物流。
- 「把這段文字翻譯成英文」——對應翻譯。
- 「生成一個 16 位隨機密碼」——對應隨機密碼。
- 「識別這張圖片裏的文字」——在提供圖片的前提下，對應 OCR 文字識別。
若 Agent 未調用 Skill，先確認安裝目錄是否正確、版本是否爲 1.0.1，並檢查 skillhub 是否將包裝入目標路徑。
適用場景與注意¶
適合誰
- 需要在 Agent 對話裏快速完成查詢、小工具類任務，又不想爲每個場景單獨集成 SDK 的開發者。
- 做原型、教學 Demo、內部助手時，希望有一份集中羅列的免費接口索引。
使用注意
- 來源爲社區 Skill，接口列表與穩定性由 Skill 維護者與各開放服務共同決定；生產環境應自行評估 SLA、合規與數據準確性。
requires_api_key=false指 Skill 層面不要求 Key，不代表所有後端永久免費或無調用限制。- 金融、車牌估值、手機號吉凶等結果僅供信息參考，不可當作投資或決策依據。
- SkillHub 統計（以抓取資料爲準）：評分 100000，下載 16530，安裝 54；數據會隨平臺更新變化。
結尾¶
「50個免費api」把天氣、物流、金融行情、生活工具、內容與 OCR 等常用開放能力收攏到一個 Agent Skill 裏，減少反覆查文檔和配 Key 的成本。若你使用 Cursor 或 Claude Code 做日常開發輔助，可按上文安裝 @user_29dc410e/free-api-50，從一兩個簡單查詢試起。詳情與安裝提示見 SkillHub 技能頁 與 API 入口。
