用途
public-api-lookup 用于搜索和发现 public-apis 目录中的免费公共 API,该目录包含 50 多个分类下的 1400 多个 API。当用户要求查找某个公共 API、需要免费 API 时可以使用。
主要能力
- 关键词搜索 API
- 按分类浏览
- 按认证方式(--auth)、HTTPS(--https)、CORS(--cors)筛选
- 限制结果数量(--limit)
- 随机返回若干 API(--random)
- 列出所有分类及其数量(--categories)
- 结果输出为 JSON,每个 API 包含 name、description、auth、https、cors、url、category
- 搜索结果本地缓存 5 分钟
使用方式
运行 scripts/search_apis.py(需要 Python 3,零依赖)。示例命令:
# 关键词搜索
python3 scripts/search_apis.py --search "weather"
# 浏览分类
python3 scripts/search_apis.py --category "Finance"
# 按认证、HTTPS、CORS 筛选
python3 scripts/search_apis.py --auth none --https yes --cors yes
# 限制结果数量
python3 scripts/search_apis.py --search "image" --limit 5
# 随机 API
python3 scripts/search_apis.py --random 3
# 组合条件
python3 scripts/search_apis.py --category "Weather" --auth none --limit 5
# 列出所有分类及数量
python3 scripts/search_apis.py --categories
结果呈现建议
- 始终格式化为带可点击链接的 Markdown 表格,列为:API、Description、Auth、HTTPS、CORS、Link。
- 当用户有具体项目时,不只罗列 API,而是推荐最匹配的 1-3 个,并说明理由(如无需认证即可上手、支持 CORS 可在浏览器直接使用)及权衡(如免费但有限流、需要 API key 但数据更丰富)。
- 当用户只是浏览探索时,展示 5-10 个结果并按分类分组,用 --limit 避免输出过多。
- 当用户说“惊喜一下”或“给点建议”时,使用 --random 3 随机选取并用一句话描述可用它构建什么。
适用场景
- 查找特定功能的免费公共 API
- 按认证、HTTPS、CORS 等条件筛选可用 API
- 浏览分类或随机探索 API 以获取灵感
- 为具体项目寻找最合适的 API 并了解取舍
限制
- 分类共 51 个,其余具体功能与使用限制资料未提供。