Back to Details

you-research

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

You.com Research Routing

You.com 研究任务路由

Use this skill to choose the right You.com research path for the user's goal: agent-led search, Research API scripts, or managed MCP fallback.
使用此技能为用户的目标选择合适的You.com研究路径：代理主导的搜索、Research API脚本或托管MCP备选方案。

Prerequisites

前提条件

For API scripts:
  • Use 
    YDC_API_KEY
    when available, or an MPP/x402-capable HTTP client for keyless paid Research API calls.
  • With 
    YDC_API_KEY
    , use these API request headers: 
    X-API-Key: ${YDC_API_KEY}
    and 
    User-Agent: SKILL/(@youdotcom-oss/agent-skills you-research)
    .
  • With MPP/x402, expect Research API pricing by 
    research_effort
    and at least a 1 cent charge; confirm the user expects a paid managed research request before sending it.
For the agent-led workflow, use the 
you-research-base
MCP profile with 
you-search
and 
you-contents
when available. Those tools and their REST endpoints should use x402 for keyless paid retries, not MPP. See the agent-led deep-search workflow for setup and workflow details.
MPP/x402-aware MCP or HTTP clients may receive HTTP 
402
payment challenges from You.com tools and endpoints, then retry with payment headers. Use MPP/x402 for managed Research API calls where appropriate. Let the host client handle external payment and retry; do not add wallet signing logic to this skill.
针对API脚本：
  • 当
    YDC_API_KEY
    可用时使用该密钥，或使用支持MPP/x402的HTTP客户端进行无密钥付费Research API调用。
  • 使用
    YDC_API_KEY
    时，需使用以下API请求头：
    X-API-Key: ${YDC_API_KEY}
    和 
    User-Agent: SKILL/(@youdotcom-oss/agent-skills you-research)
    。
  • 使用MPP/x402时，Research API将按
    research_effort
    计费，最低收费1美分；在发送请求前，请确认用户知晓这是付费托管研究请求。
针对代理主导工作流，当
you-search
和
you-contents
可用时，使用
you-research-base
MCP配置文件。这些工具及其REST端点应使用x402进行无密钥付费重试，而非MPP。有关设置和工作流详情，请参阅代理主导深度搜索工作流。
支持MPP/x402的MCP或HTTP客户端可能会收到来自You.com工具和端点的HTTP 
402
支付挑战，随后需携带支付头进行重试。在合适的场景下，为托管Research API调用使用MPP/x402。让宿主客户端处理外部支付和重试逻辑，请勿在此技能中添加钱包签名逻辑。

Research API scripts

Research API脚本

When the user wants You.com managed research APIs, write a small script or direct HTTP request instead of calling 
you-research
through MCP, especially for 
deep
, 
exhaustive
, or 
frontier
work.
Before coding or updating a script, query the You.com Docs MCP server, usually through 
searchDocs
, for current API details. Use targeted queries such as:
  • Research API v1 research background source_control output_schema research_effort
  • Research task status v1 research task
  • Research task stream SSE v1 research task stream
If Docs MCP is unavailable, use the canonical pages:
Keep the script aligned with the docs returned at runtime and include the auth or payment headers listed above. If the user wants keyless MPP/x402 direct HTTP usage for Research API, verify current payment guidance in Docs MCP first, then handle 
402 payment-required
as a challenge and retry only through a payment-capable client or library. For the direct x402 REST client pattern, follow x402 direct client; for the MCP-composition alternative (You.com MCP + Coinbase Payments MCP, no manual signing), see Coinbase Payments MCP path. Do not apply MPP guidance to plain search or contents REST calls; those should use x402 only.
当用户需要You.com托管研究API时，请编写小型脚本或直接发送HTTP请求，而非通过MCP调用
you-research
，尤其是在处理
deep
、
exhaustive
或
frontier
类型的任务时。
在编写或更新脚本前，请通过
searchDocs
查询You.com Docs MCP服务器以获取当前API详情。可使用以下针对性查询：
  • Research API v1 research background source_control output_schema research_effort
  • Research task status v1 research task
  • Research task stream SSE v1 research task stream
若Docs MCP不可用，请使用官方文档页面：
确保脚本与运行时返回的文档保持一致，并包含上述认证或支付请求头。如果用户希望通过无密钥MPP/x402直接调用Research API，请先在Docs MCP中确认当前支付指引，随后仅通过支持支付的客户端或库处理
402 payment-required
挑战并重试。对于直接x402 REST客户端模式，请遵循x402直接客户端；对于MCP组合替代方案（You.com MCP + Coinbase Payments MCP，无需手动签名），请参阅Coinbase Payments MCP路径。请勿将MPP指引应用于普通搜索或内容REST调用；这些场景应仅使用x402。

Decision Tree

决策树

  • User is cost-conscious or wants to develop/fine-tune a research skill -> follow the agent-led deep-search workflow.
  • User asks for You.com managed API output, structured output, source controls, background tasks, or 
    deep
    /
    exhaustive
    /
    frontier
    research -> write a script against the Research API.
  • User needs OAuth or MPP/x402 payment handling and direct API scripts are not practical -> use MCP only if the MCP client supports the expected response time and payment flow.
  • Required API access or 
    you-research-base
    MCP tools are unavailable -> tell the user what is missing, provide the relevant API or MCP setup options from the prerequisites above, and request approval before installing, connecting, or changing configuration.
  • Simple lookup -> use 
    you-research-base
    you-search
    once, answer directly.
  • URL provided -> use 
    you-research-base
    you-contents
    on those URLs.
  • Everything else -> use the base agent-led workflow.
  • 用户注重成本或希望开发/微调研究技能 -> 遵循代理主导深度搜索工作流。
  • 用户要求You.com托管API输出、结构化输出、源控制、后台任务，或
    deep
    /
    exhaustive
    /
    frontier
    类型研究 -> 编写针对Research API的脚本。
  • 用户需要OAuth或MPP/x402支付处理，且直接API脚本不可行 -> 仅当MCP客户端支持预期响应时间和支付流程时，才使用MCP。
  • 所需API访问权限或
    you-research-base
    MCP工具不可用 -> 告知用户缺失的内容，提供上述前提条件中相关的API或MCP设置选项，并在安装、连接或更改配置前请求用户批准。
  • 简单查询 -> 使用
    you-research-base
    的
    you-search
    查询一次，直接给出答案。
  • 提供了URL -> 使用
    you-research-base
    的
    you-contents
    处理这些URL。
  • 其他所有情况 -> 使用基础代理主导工作流。

Agent-led workflow reference

代理主导工作流参考

When choosing the cost-conscious skill-building path, open and follow the agent-led deep-search workflow. Adapt its tool budget, source policy, and output format to the user's agent environment. Preserve its core requirements: read sources before relying on exact claims, cross-check key facts, cite real URLs, and finish with the best supported answer even when evidence is incomplete.
当选择注重成本的技能构建路径时，请打开并遵循代理主导深度搜索工作流。根据用户的代理环境调整其工具预算、源策略和输出格式。保留其核心要求：在依赖确切声明前先阅读源内容，交叉验证关键事实，引用真实URL，即使证据不完整也要提供最具依据的答案。