mcpField
D
deep-research

deep-research

github.com/davidondrej生産性4.2k196 回インストール今日更新
リポジトリ

deep-research について

Deep Researchは、DeepAPIの深層調査エンドポイントを使い、焦点を絞ったプロンプトの作成から出典付きレポートの保存までを案内するスキルです。構造化された回答と出典を必要とする調査に向いています。

主な機能

  1. 01調査プロンプトと小問の構成
  2. 02DeepAPIの深層調査エンドポイント呼び出し
  3. 03回答と出典URLの保存
  4. 04再試行とエラー処理の説明

活用シーン

  1. 01出典付きレポートで疑問を調査
  2. 02焦点を絞ったプロンプトで選択肢を比較
  3. 03小問ごとの調査結果を一つのレポートに統合

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/davidondrej/skills --skill deep-research

インストール後、Claude Code で/deep-researchを入力して読み込まれたか確認します。

同梱ファイルagents/openai.yaml

詳細

ディープリサーチ

すべてのディープリサーチには、DeepAPI（POST /v1/research/deep）を使用します。

API キー

環境変数から API_KEY を読み取ります。

KEY=$API_KEY
BASE=${DEEPAPI_API_BASE_URL:-https://deepapi.co}

キーがない場合は処理を中止し、ユーザーに確認してください。キーを表示またはログに記録してはいけません。キーは deepapi.co で取得できます。

1. プロンプトを作成する

research-prompt スキルに従ってください。自己完結した段落を1つ作成します。

  • 最初にメインの質問と、その質問がどのような判断に役立つかを記載します。
  • すべての背景情報と、番号付きのサブクエスチョンを3〜6個含めます。1つのプロンプトにつき、目的は1つにしてください。
  • 含める内容と避ける内容を指定します。一次情報を優先し、事実と推論を区別してください。

フィールドの上限：query は4000文字以下（プロンプト）、任意の context は8000文字以下、任意の instructions は2000文字以下です。API に拒否されるため、model や provider は送信しないでください。

2. 実行する

1回の呼び出しで、700〜1120語を目安とする、引用付きの回答が返されます。サーバーの処理には最大で約5分かかる場合があります。

IDK=$(uuidgen)   # keep this; retries must reuse the SAME Idempotency-Key
jq -n --rawfile p /tmp/dr_prompt.txt '{query:$p, maxCostUsd:"0.70"}' > /tmp/dr_body.json
curl -s --max-time 320 "$BASE/v1/research/deep" \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $IDK" \
  -d @/tmp/dr_body.json > /tmp/dr_result.json

maxCostUsd の最小値は "0.35" です。デフォルトは "0.70" とし、それ以上に引き上げる場合はユーザーに確認してください。

3. レポートを保存する

jq -r '.status'                    /tmp/dr_result.json   # succeeded | failed
jq -r '.output.answer'             /tmp/dr_result.json   # the report
jq -r '.output.sources[]?.url'     /tmp/dr_result.json   # source URLs

引用 URL を引用箇所の下に記載した Markdown レポートを保存します。ユーザーから求められた場合のみ、費用を報告してください。回答に [n] 形式の引用が含まれているのに output.sources が空の場合は、そのまま回答を提供し、その旨をユーザーに伝えてください。

レポートが長くなる場合は、番号付きのサブクエスチョンごとに、それぞれ独自の Idempotency-Key を使って個別に実行してください。その後、回答とソースを1つの Markdown ファイルにまとめます。

エラーと再試行

  • HTTP 402 insufficient_credits：処理を中止し、deepapi.co/credits でのチャージを案内してから、同じ Idempotency-Key で再試行します。
  • HTTP 429 rate_limit_exceeded：Retry-After 秒待ってから、1回だけ再試行します。
  • status: failed／HTTP 502：requestId と error.message を報告します。繰り返し再試行してはいけません。
  • 同じ Idempotency-Key を再利用すると、HTTP 200 と replayed: true が返され、新たな料金は発生しません。
  • エンベロープや認証の詳細、その他のエンドポイントについては、deepapi スキルを参照してください。

コメント

Markdown 対応