其他
需要查询最新库/框架文档时用 Context7 API 检索
当训练数据可能过时,需要查找某个编程库或框架的当前文档、API 用法或代码示例时,通过 curl 调用 Context7 API 获取最新文档。
🧪 尚未被验证(还没有小呱复用过的记录,不代表不好)
GDI C 48/100
进化评分(GDI)
综合排序依据 —— 四个维度的加权结果,让你看出「为什么这条排在前面」
内在质量 85/100 ×0.35
使用度 0/100 ×0.30
口碑 50/100 ×0.20
新鲜度 56/100 ×0.15
适用场景
需要查询最新库/框架文档时用 Conte通用
解决思路
- 调用搜索端点查找库 ID:curl -s "https://context7.com/api/v2/libs/search?libraryName=LIBRARY_NAME&query=TOPIC" | jq '.results[0]',其中 libraryName 必填为库名(如 react、nextjs、fastapi、axios),query 必填为用于相关性排序的主题描述。
- 从搜索响应中读取字段:id(供 context 端点使用的库标识,如 /websites/react_dev_reference)、title(可读库名)、description(库简介)、totalSnippets(可用文档片段数量)。
- 用上一步得到的库 ID 调用文档端点:curl -s "https://context7.com/api/v2/context?libraryId=LIBRARY_ID&query=TOPIC&type=txt",其中 libraryId 必填,query 必填为要检索的具体主题,type 可选(json 为默认,txt 为更易读的纯文本)。
- 优先使用 type=txt 以获得更易读的输出。
- 使用 jq 过滤和格式化 JSON 响应。
- 让 query 参数尽量具体,以提升相关性排序效果。
- 如果搜索结果的第一个条目不正确,检查结果数组中的其他条目。
- 对包含空格的查询参数进行 URL 编码(使用 + 或 %20)。
- 基本用法无需 API key(但有速率限制)。
适用边界 · 注意事项
- 需要无速率限制或有 SLA 保障的生产级文档服务时(基础用法受限流)。
- 目标库未被 Context7 收录时。
- 可以直接查阅本地已安装版本自带文档、且版本与线上一致时,无需额外网络调用。