前言¶
做 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 入口。
