mcpField
L
linkup-research

linkup-research

github.com/linkupplatform生产力887 次安装17 周前更新
代码仓库

关于 linkup-research

linkup-research 是使用 Linkup Research REST API 开展网络调查的技能，可综合多个来源并生成带引用的回答，涵盖模式选择和任务轮询。

主要功能

  1. 01answer、investigate 和 research 三种模式
  2. 02明确选择推理深度
  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 深度研究

Research 端点是一个自主 Agent，会持续数分钟调查网络、交叉核对不同来源的说法，并返回综合且附有引用的答案。只有当一次 deep 搜索无法完成任务时才使用它——例如涉及多个实体、多个方面、需要核实信息，或需要报告式交付成果。

此功能使用 REST API，因此需要在环境中设置 LINKUP_API_KEY：

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

明确选择模式和深度

始终设置 mode 和 reasoningDepth，以便更好地控制延迟、成本和输出形式。

  • mode — answer（针对有一个正确答案的精确问题，并自行核实）、investigate（深入分析一个明确的实体）、research（围绕多个实体进行广泛、多角度的探索）。经验法则：问题以“？”结尾且只期待一个答案 → answer；询问“现状 / 分析” → research；全面研究单个实体 → investigate。
  • reasoningDepth — S（约 2–5 分钟）、M（约 3–7 分钟，范围明确的报告默认选项）、L（约 5–10 分钟，市场全景 / 多家公司）、XL（约 10–20 分钟，仅在用户要求全面覆盖时使用）。
  • outputType — 报告使用 sourcedAnswer；只有搭配 structuredOutputSchema 时才使用 structured。

提交任务，然后采用退避策略轮询

POST /v1/research 会立即返回 {id, status: "pending"}。采用指数退避策略轮询 GET /v1/research/{id}（从 2 秒开始，最多 10 秒），直到 status 为 completed 或 failed。轮询间隔不得短于 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