context7

Context7

概述

此技能可透過 curl 查詢 Context7 API，取得軟體函式庫與元件的最新文件。請使用此技能，而非依賴可能過時的訓練資料。

工作流程

步驟 1：搜尋函式庫

若要尋找 Context7 的函式庫 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：可用的文件片段數量

步驟 2：取得文件

若要取得文件，請使用步驟 1 的函式庫 ID：

curl -s "https://context7.com/api/v2/context?libraryId=LIBRARY_ID&query=TOPIC&type=txt"

參數：

• libraryId（必填）：搜尋結果中的函式庫 ID
• query（必填）：要取得文件的特定主題
• type（選填）：回應格式 - json（預設）或 txt（純文字，較易閱讀）

範例

React hooks 文件

# 尋找 React 函式庫 ID
curl -s "https://context7.com/api/v2/libs/search?libraryName=react&query=hooks" | jq '.results[0].id'
# 回傳："/websites/react_dev_reference"

# 取得 useState 文件
curl -s "https://context7.com/api/v2/context?libraryId=/websites/react_dev_reference&query=useState&type=txt"

Next.js 路由文件

# 尋找 Next.js 函式庫 ID
curl -s "https://context7.com/api/v2/libs/search?libraryName=nextjs&query=routing" | jq '.results[0].id'

# 取得 app router 文件
curl -s "https://context7.com/api/v2/context?libraryId=/vercel/next.js&query=app+router&type=txt"

FastAPI 依賴注入

# 尋找 FastAPI 函式庫 ID
curl -s "https://context7.com/api/v2/libs/search?libraryName=fastapi&query=dependencies" | jq '.results[0].id'

# 取得依賴注入文件
curl -s "https://context7.com/api/v2/context?libraryId=/fastapi/fastapi&query=dependency+injection&type=txt"

提示

• 使用 type=txt 取得更易讀的輸出
• 使用 jq 過濾與格式化 JSON 回應
• 盡量具體描述 query 參數以提升相關性排序
• 如果第一個搜尋結果不正確，請檢查陣列中的其他結果
• 對包含空格的查詢參數進行 URL 編碼（使用 + 或 %20）
• 基本使用無需 API 金鑰（有速率限制）