context7

Context7

Context7 API に問い合わせて、ソフトウェアライブラリの最新ドキュメントを取得します。これは、API の現在のインターフェースが不明な場合に特に便利です。ライブラリのドキュメントは頻繁に変更されるため、学習データが古くなっている可能性があります。

CONTEXT7_API_KEY 環境変数が必要です。

使用する場面

• ライブラリ関数の動作を調べる場合（例：「useEffect のクリーンアップはどのように動作しますか？」）
• 新しいバージョンで API が変更されたか確認する場合
• 特定のライブラリ機能のコード例を探す場合
• 正しいインポートパスや関数シグネチャを確認する場合
• ライブラリをインストールまたは設定する際に、セットアップドキュメントが必要な場合

使用しない場面

• 一般的なプログラミングの質問（例：「JS でクロージャはどのように動作しますか？」）
• 自分のプロジェクトの内部コードに関する質問
• 特定のオープンソースライブラリやフレームワークに関連しないトピック

ワークフロー

スクリプトのソースコードを読まないでください。 スクリプトを直接実行し、使い方を確認するには --help を使用してください。

ステップ 1：ライブラリを検索する

python3 scripts/context7.py search <library> <topic>

上位 5 件の一致を TSV 形式（id、title、snippets）で返します。最もよく一致する行の id を取得ステップで使用してください。

ステップ 2：ドキュメントを取得する

python3 scripts/context7.py fetch <library_id> <topic> [--max-tokens N]

トピックに関連するドキュメントのスニペットを、トークン数の上限（デフォルト：5000）まで取得します。

--max-tokens の選び方：

シナリオ	トークン数	理由
簡単な確認（1 つの関数シグネチャ）	2000	出力を絞り込み、応答を高速化できます
一般的な使い方（API パターン、例）	5000（デフォルト）	深さと簡潔さのバランスが取れています
幅広い調査（移行ガイド、API 全体）	8000～10000	複数のセクションにまたがるトピックに必要です

使い方の詳細は python3 scripts/context7.py --help を実行してください。

例

# Find React library ID, then fetch useState docs
python3 scripts/context7.py search react "useState hook"
python3 scripts/context7.py fetch /websites/react_dev "useState hook with objects"

# Smaller budget for a quick lookup
python3 scripts/context7.py fetch /vercel/next.js "middleware redirect" --max-tokens 2000

# Broader exploration
python3 scripts/context7.py fetch /langchain-ai/langchainjs "retrieval chain setup" --max-tokens 8000

ルール

• 具体的なクエリを記述してください — "useState hook with objects" は "hooks" よりも関連性の高いスニペットを取得できます。これは、API がクエリとの関連性に基づいてスニペットをランク付けするためです。
• 取得する前に必ず検索してください — ライブラリ ID は推測できないため（例：/websites/react_dev）、適切な ID を見つけるには検索ステップが必要です。
• タスクに合わせて --max-tokens を設定してください — 上の表を参考にしてください。設定値が大きすぎるとコンテキストウィンドウを無駄にし、小さすぎると回答に必要な情報が不足する可能性があります。