you-research

Официальный навык You.com для выбора маршрута web research между экономичным агентским поиском, скриптами Research API и управляемым MCP fallback. Он не утверждает, что один способ подходит для всех запросов: выбор зависит от цели, нужной глубины, доступных инструментов и способа авторизации. Для простого поиска навык предлагает один вызов you-search, а если пользователь передал конкретный URL — you-contents. Для более сложного исследования нужно определить, требуется ли управляемый Research API, agent-led workflow или платёжно-осведомлённый MCP-маршрут. В agent-led варианте используется профиль you-research-base с инструментами you-search и you-contents, когда он доступен. Такой путь отмечен как cost-conscious workflow для исследовательских задач и для разработки самого навыка. В нём важно читать источники до использования точных утверждений, перепроверять ключевые факты, давать реальные ссылки и доводить ответ до наиболее хорошо подтверждённого результата даже при неполных данных. Если пользователь просит простую проверку, дополнительная глубокая оркестрация не нужна; если URL уже известен, полезнее извлечь его содержимое напрямую. Для You.com Research API навык рекомендует небольшой скрипт или прямой HTTP-запрос, особенно для режимов deep, exhaustive или frontier, а не вызов одноимённого MCP-инструмента. Перед написанием или обновлением такого скрипта нужно обратиться к You.com Docs и проверить текущие сведения о Research API v1, фоновой задаче, потоке SSE, source control, output schema и research_effort. В качестве канонических запасных страниц указаны официальные reference-страницы v1 research, research task и research task stream. Поэтому сведения о форме запроса, статусах и потоковой выдаче должны быть извлечены из документации во время работы, а не зашиты по старому примеру. Для API с YDC_API_KEY навык указывает заголовок X-API-Key и специальный User-Agent SKILL/(@youdotcom-oss/agent-skills you-research). Также описан MPP/x402-capable HTTP client для платных keyless-вызовов: Research API тарифицируется по research_effort, а управляемый запрос может потребовать подтверждения стоимости не менее одного цента. MPP и x402 не смешиваются автоматически: для Research API используется платежный путь, подходящий этому API, а для search и contents REST-вызовов — x402. Клиент должен обрабатывать 402 как payment challenge только при наличии соответствующей платёжной поддержки; навык не предлагает добавлять собственную логику подписи кошелька. Дерево решений также явно описывает ограничения. Если пользовательский запрос требует OAuth, оплаты или длительного managed research, а прямой API-скрипт неудобен, MCP допустим только при поддержке ожидаемого времени ответа и платёжного потока. Если обязательный доступ, YDC_API_KEY или профиль you-research-base недоступны, нужно сообщить, чего не хватает, показать варианты подключения и запросить одобрение до установки или изменения конфигурации. Это делает навык полезным для планирования стоимости и границ доступа: он не создаёт видимость исследовательского результата там, где нет источников, авторизации или подтверждённого способа выполнить запрос. Практическое применение — сначала классифицировать запрос, затем выбрать минимальный маршрут, прочитать первоисточники и сохранить цитируемые ссылки. Для глубокой работы стоит проверить актуальный контракт API и статус фоновой задачи; для обычной ссылки — извлечь её содержимое; для недоступного провайдера — остановиться на явном блокере. Навык принадлежит youdotcom-oss, имеет лицензию MIT, категорию research и версию 0.3.0, но эти метаданные не заменяют текущую проверку документации и настроек доступа.