🔍 WebSearch: Busca na Web
WebSearch permite buscar na internet e usar resultados para informar suas respostas. Ideal para documentacao atualizada e informacoes alem do cutoff.
📋 Parametros do WebSearch
| Parametro | Tipo | Descricao |
|---|---|---|
| query | string | Termo de busca (min 2 chars) |
| allowed_domains | string[] | Limitar a estes dominios |
| blocked_domains | string[] | Excluir estes dominios |
Exemplos de Uso
# Buscar docs de framework
WebSearch(query="React 19 new features 2026")
# Buscar apenas em docs oficiais
WebSearch( query="Python asyncio tutorial", allowed_domains=["docs.python.org", "realpython.com"] )
📄 WebFetch: Extrair Conteudo de URL
WebFetch acessa uma URL especifica, converte HTML para markdown e processa com um prompt. Ideal para analisar paginas especificas.
📋 Parametros do WebFetch
| Parametro | Tipo | Descricao |
|---|---|---|
| url | string | URL completa a acessar |
| prompt | string | O que extrair da pagina |
Exemplo
WebFetch( url="https://docs.python.org/3/library/asyncio.html", prompt="Extraia os principais conceitos de asyncio e exemplos de uso" )
⚠️ Limitacoes Importantes
WebFetch tem limitacoes importantes que voce precisa conhecer para evitar erros.
🚫 WebFetch NAO funciona para:
- ✗ URLs autenticadas - Google Docs, Confluence, Jira
- ✗ GitHub - use gh CLI em vez disso
- ✗ Paginas com login - qualquer conteudo privado
- ✗ SPAs pesadas - conteudo renderizado por JS
✓ WebFetch funciona bem para:
- ✓ Documentacao publica (MDN, docs oficiais)
- ✓ Blogs e artigos tecnicos
- ✓ Stack Overflow e similares
- ✓ Paginas estaticas de API reference
🔄 Cache e Performance
WebFetch inclui um cache de 15 minutos para URLs acessadas repetidamente, melhorando performance e economizando requests.
Como funciona o cache
- • Primeira request: busca na web
- • Proximas 15 min: usa cache
- • Auto-limpeza apos 15 min
Redirects
Se uma URL redireciona para outro host, WebFetch informa e pede nova request.
Faca novo WebFetch com a URL de destino.
💡 Dica
HTTP e automaticamente convertido para HTTPS. Nao precisa se preocupar com o protocolo.
📊 Boas Praticas com WebSearch
Para obter os melhores resultados com WebSearch, siga estas praticas recomendadas.
✓ Boas Queries
- ✓ Inclua ano: "React 19 features 2026"
- ✓ Seja especifico: "Python asyncio gather vs wait"
- ✓ Use termos tecnicos corretos
- ✓ Filtre dominios quando relevante
✗ Queries Problematicas
- ✗ Muito vagas: "como programar"
- ✗ Sem contexto temporal
- ✗ Frases muito longas
- ✗ Perguntas naturais complexas
📚 Incluir Fontes
Apos usar WebSearch, sempre inclua uma secao "Sources:" com links para as fontes usadas:
- [React 19 Release Notes](https://react.dev/blog/2026/...)
- [Migration Guide](https://react.dev/...)
🔧 Alternativas para Servicos Autenticados
Para servicos que requerem autenticacao, use ferramentas especializadas em vez de WebFetch.
GitHub
Use gh CLI para PRs, issues, repos
gh pr view 123
gh issue list
APIs Autenticadas
Use curl ou ferramentas MCP
curl -H "Authorization: Bearer $TOKEN" https://api.service.com/...
MCP Tools
Se disponivel, prefira ferramentas MCP especializadas
Ferramentas MCP podem ter autenticacao configurada e menos restricoes que WebFetch.
📋 Resumo do Modulo
Proximo Modulo:
2.7 - Task e Subagentes Nativos - listas de tarefas e delegacao