# Web Search

> Use quando a dúvida do estudante depende de informação atual ou verificável (versões, lançamentos, mercado, notícias, "em 2026"). Pesquisa na web com o You.com e responde com fontes citadas.

- Skill: `digitalinnovationone/web-search` (Agent Skill)
- Install (CLI): `npx skillmds@latest add digitalinnovationone/web-search`
- Raw SKILL.md: https://api.skillmd.com/api/skills/digitalinnovationone/web-search/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: digitalinnovationone (https://skillmd.com/u/digitalinnovationone)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/digitalinnovationone/web-search

---


# Skill: Pesquisa na Web (respostas fundamentadas)

Fundamenta a resposta em informação atual da web, usando a busca do You.com, e sempre cita as fontes. Serve para quando a base de conhecimento da DIO e o seu conhecimento interno não bastam, porque o assunto muda com o tempo.

## Quando usar

Use esta skill quando a boa resposta depende de algo atual ou que precisa ser conferido, por exemplo:

- versões atuais de uma linguagem, framework ou ferramenta (ex.: "qual a versão estável do Node hoje?");
- lançamentos, notícias ou mudanças recentes de tecnologia;
- panorama de mercado, tendências ou o que está sendo pedido em vagas;
- qualquer pergunta com "agora", "atual", "hoje" ou um ano recente;
- fatos que você não tem certeza e que seria irresponsável responder de memória.

Se a dúvida for sobre um conceito estável (o que é uma variável, como funciona um `for`), **não** precisa de busca: use a skill `explain-concept`.

## Antes de usar: a busca precisa estar conectada

Esta skill usa a ferramenta de busca do You.com, conectada ao seu harness como um servidor **MCP** (uma capacidade nativa do harness, não um script). Se a ferramenta `you-search` não estiver disponível, siga o guia `docs/youcom-mcp.md` para conectá-la uma única vez. Existe uma opção gratuita, sem cadastro, ótima para estudantes.

> IMPORTANTE: **Nunca escreva nem rode scripts ou código para buscar na web ou raspar páginas.** Buscar é uma ação nativa do harness (a ferramenta `you-search`), não uma tarefa de programação. Se você se pegar criando um arquivo, instalando bibliotecas ou vasculhando HTML, pare: isso queima tokens à toa. Se a busca não estiver disponível, avise o estudante e siga com o que você já sabe, deixando claro o que não pôde confirmar.

## Processo

### 1. Decida se a busca é mesmo necessária

Pergunte a si mesmo: a resposta muda com o tempo, ou é um conceito estável? Só busque quando a atualidade importa. Uma busca desnecessária é mais lenta e não ajuda o estudante.

### 2. Monte uma consulta boa

Escreva a consulta como uma pessoa pesquisaria, em português, curta e específica. Inclua o ano quando a atualidade for o ponto (ex.: `melhores práticas React 2026`). Uma consulta focada traz fontes melhores que uma frase longa.

### 3. Faça a busca com a ferramenta `you-search`

Chame a ferramenta `you-search` com a sua consulta no parâmetro `query`. Parâmetros úteis, todos opcionais:

- `count`: quantos resultados trazer (comece com 5);
- `freshness`: recorte de tempo (`day`, `week`, `month`, `year`) quando só interessa o recente;
- `language` e `country`: para priorizar conteúdo em português (`language=pt`, `country=BR`).

Não invente resultado. Se a ferramenta não responder, diga isso ao estudante.

### 4. Leia os resultados com olhar crítico

Cada resultado traz título, link e um trecho. Prefira fontes confiáveis (documentação oficial, sites reconhecidos) e observe a data quando ela aparecer. Descarte o que for propaganda ou claramente desatualizado.

### 5. Responda fundamentando na fonte, não copiando

Explique com as suas palavras, no tom de mentor da DIO, apoiando-se no que as fontes dizem. Não cole textão nem repita a página inteira.

### 6. Cite as fontes

Termine com uma lista curta das fontes que embasaram a resposta, cada uma com título e link. Citar é o que torna a resposta *fundamentada*: o estudante pode conferir e se aprofundar. Uma resposta sem fonte, para um assunto que muda com o tempo, não serve.

### 7. Conecte com a DIO

Quando fizer sentido, aponte onde o estudante pode se aprofundar dentro da DIO (um Curso, uma Formação ou um Desafio relacionado ao tema pesquisado).

## Lembre-se

- Só busque quando a atualidade importa. Para conceitos estáveis, explique direto.
- Sempre cite as fontes. Resposta atual sem link não é uma resposta fundamentada.
- Nunca escreva scripts para buscar ou raspar a web. Use a ferramenta nativa `you-search`.
- Fonte não confiável é pior que nenhuma. Prefira documentação oficial e sites reconhecidos.
- Se a busca não estiver disponível, seja honesto sobre o que você não pôde confirmar.