mcpField
L
linkup-research

linkup-research

github.com/linkupplatform生産性887 回インストール17 週間前に更新
リポジトリ

linkup-research について

linkup-researchは、LinkupのResearch REST APIでウェブ上の情報を調査するスキルです。複数の情報源を照合した回答の作成に向け、モード選択やタスクのポーリングを案内します。

主な機能

  1. 01answer、investigate、researchの3モード
  2. 02reasoningDepthの明示的な選択
  3. 03非同期タスクの送信とポーリング
  4. 04レポート向けの出典付き回答
  5. 05プロンプトの範囲設定ガイダンス

活用シーン

  1. 01具体的な質問を情報源に基づいて検証
  2. 02単一の対象を詳しく調査
  3. 03複数の対象を多角的に比較
  4. 04出典付きの調査レポートを作成

インストール

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

$npx skills add https://github.com/linkupplatform/skills --skill linkup-research

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

同梱ファイルreferences/LINKUP_SPECIALIZED_ENDPOINTS.md

詳細

Linkup Deep Research

Research エンドポイントは、自律型エージェントとして数分間にわたり反復的にウェブを調査し、複数の情報源を照合して主張を検証したうえで、引用付きの回答をまとめて返します。1 回の deep 検索では対応しきれない場合にのみ使用してください。たとえば、対象が多い場合、複数の観点から調べる必要がある場合、検証が必要な場合、レポート形式の成果物が必要な場合などです。

これは REST API を使用するため、環境に LINKUP_API_KEY が必要です。

test -n "$LINKUP_API_KEY" || echo "Missing LINKUP_API_KEY"

モードと深度を明示的に選択する

レイテンシー、コスト、出力形式を予測しやすくするため、必ず mode と reasoningDepth を設定してください。

  • mode — answer（正解が 1 つに定まる明確な質問。自己検証付き）、investigate（定義された 1 つの対象を詳細に分析）、research（複数の対象を幅広く、多角的に調査）。目安：「？」で終わり、回答が 1 つ期待される場合は answer、「現状」や「分析」について尋ねる場合は research、1 つの対象を包括的に調べる場合は investigate を選びます。
  • reasoningDepth — S（約 2～5 分）、M（約 3～7 分。範囲が限定されたレポートのデフォルト）、L（約 5～10 分。市場マップや複数企業の調査向け）、XL（約 10～20 分。ユーザーが網羅的な調査を求めている場合のみ）。
  • outputType — レポートには sourcedAnswer を使用します。structuredOutputSchema がある場合に限り、structured を使用します。

送信後、バックオフしながらポーリングする

POST /v1/research は {id, status: "pending"} をすぐに返します。status が completed または failed になるまで、指数バックオフ（2 秒から開始し、上限は 10 秒）を使用して GET /v1/research/{id} をポーリングしてください。ポーリングの間隔は、1 秒未満にしないでください。失敗したタスクは課金されません。

curl -sS -X POST "https://api.linkup.so/v1/research" \
  -H "Authorization: Bearer $LINKUP_API_KEY" -H "Content-Type: application/json" \
  -d '{"q":"Compare 2024 cloud revenue growth for Microsoft, Amazon, and Google from primary sources.","mode":"answer","reasoningDepth":"M","outputType":"sourcedAnswer"}'

curl -sS "https://api.linkup.so/v1/research/RESEARCH_ID" -H "Authorization: Bearer $LINKUP_API_KEY"

範囲を適切に定めたプロンプトを書く

調査する観点、追跡する手がかり、検証する事実、比較する対象、制約や除外事項、出力構成を指定してください。入力を正確にするほど、より徹底的で意図に沿った出力が得られます。

ガイダンス

  • Research はコストが高く、完了まで数分かかります（深度に応じて $0.25～$2.50）。実行前に、これから何を実行するのか、なぜ実行するのかをユーザーに伝えてください。
  • すべての主張の根拠を、返された sources に示してください。完了したら、調査した内容、回答、主な情報源、およその所要時間を平易な日本語で要約してください。
  • 一時的な障害（429、5xx）の場合に限り、バックオフしながら再試行してください。

判断基準、モードの例、パターン、ポーリングの詳細については、このスキルのディレクトリにある references/LINKUP_SPECIALIZED_ENDPOINTS.md（Research セクション）を参照してください。

コメント

Markdown 対応