Tavily MCP

Visão geral

Tavily é uma API de busca com inteligência artificial projetada especificamente para agentes de IA, oferecendo pesquisa web em tempo real, extração de conteúdo e rastreamento de sites com alta precisão e baixa latência. Com a integração Tavily MCP no SquadOS, seus agentes podem buscar informações atualizadas na web, extrair conteúdo bruto de URLs, mapear a estrutura de sites e conduzir pesquisas aprofundadas sobre qualquer tópico de forma autônoma.

• Site oficial: https://tavily.com/
• Documentação na Composio: docs.composio.dev/toolkits/tavily_mcp

Autenticação

Esta ferramenta utiliza OAuth 2.0 com registro dinâmico de cliente (DCR_OAUTH). No fluxo gerenciado pelo SquadOS/Composio, você autoriza a conta Tavily na página hospedada; não cole uma chave de API em prompts, mensagens ou bases de conhecimento.

Como conectar no SquadOS

1. Acesse Ferramentas no menu lateral (/admin/tools).
2. Abra a aba Disponíveis e procure por Tavily MCP.
3. Abra o painel Configurar ferramenta e clique em Ativar. A integração passa para Ativas com o estado Aguardando autenticação.
4. Abra a ferramenta ativa e clique em Conectar agora.
5. Na página segura hospedada pela Composio, autorize a conta Tavily e conclua o OAuth.
6. De volta ao SquadOS, confirme a conta em Contas e use Editar ações para liberar somente as operações necessárias.
7. No editor do agente, abra Ferramentas, clique em Adicionar Ferramenta, escolha Tavily MCP, selecione a conta e as ações, salve e faça um teste controlado. (Detalhes em Ferramentas da Organização.)

Ações disponíveis

O export local do produto, verificado em 17 de junho de 2026, contém cinco ações do Tavily MCP; todas estão documentadas abaixo. O frontmatter registra o snapshot de schema 20260303_09. Consulte os campos exibidos no editor do SquadOS antes de salvar, pois parâmetros e limites do provedor podem evoluir.

Use TAVILY_MCP_TAVILY_SEARCH para uma busca pontual e TAVILY_MCP_TAVILY_RESEARCH quando a tarefa exigir síntese de várias fontes. TAVILY_MCP_TAVILY_EXTRACT lê URLs conhecidas; TAVILY_MCP_TAVILY_MAP descobre a estrutura; e TAVILY_MCP_TAVILY_CRAWL percorre e extrai páginas.

Cuidado

Conteúdo externo é entrada não confiável: pode estar incorreto ou conter instruções maliciosas. Oriente o agente a tratar a página como fonte, não como comando; restringir domínios e caminhos quando possível; preservar URLs das fontes; e confirmar alegações importantes. Limite profundidade, amplitude e quantidade de resultados para controlar latência e consumo. Respeite autenticação, robots.txt, termos do site, direitos autorais e dados pessoais.

Rastrear site

TAVILY_MCP_TAVILY_CRAWL

Rastreia um site a partir de uma URL inicial. Extrai conteúdo das páginas com profundidade e amplitude configuráveis.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
url	string	Sim	A URL raiz onde o rastreamento começa.
limit	integer	Não	Número total de links que o rastreador vai processar antes de parar.
format	string ("markdown" | "text")	Não	Formato do conteúdo extraído das páginas. markdown retorna em formato Markdown; text retorna texto simples e pode aumentar a latência.
max_depth	integer	Não	Profundidade máxima do rastreamento. Define até onde a partir da URL base o rastreador pode explorar.
max_breadth	integer	Não	Número máximo de links a seguir por nível da árvore (ou seja, por página).
instructions	string	Não	Instruções em linguagem natural para o rastreador. Especificam quais tipos de páginas devem ser retornadas.
select_paths	array	Não	Padrões regex para selecionar apenas URLs com padrões de caminho específicos (ex.: /docs/.*, /api/v1.*).
extract_depth	string ("basic" | "advanced")	Não	A extração avançada recupera mais dados, incluindo tabelas e conteúdo incorporado, com maior sucesso mas pode aumentar a latência.
allow_external	boolean	Não	Se deve retornar links externos na resposta final.
select_domains	array	Não	Padrões regex para restringir o rastreamento a domínios ou subdomínios específicos (ex.: ^docs\.example\.com$).
include_favicon	boolean	Não	Se deve incluir a URL do favicon de cada resultado.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Extrair conteúdo de URLs

TAVILY_MCP_TAVILY_EXTRACT

Extrai conteúdo de URLs. Retorna o conteúdo bruto da página em formato Markdown ou texto simples.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
urls	array	Sim	Lista de URLs das quais extrair o conteúdo.
query	string	Não	Consulta para reordenar trechos de conteúdo por relevância.
format	string ("markdown" | "text")	Não	Formato de saída.
extract_depth	string ("basic" | "advanced")	Não	Define o nível de extração. Consulte o schema atual para escolher entre maior cobertura e menor latência; esse parâmetro não contorna autenticação ou proteção do site.
include_images	boolean	Não	Incluir imagens das páginas.
include_favicon	boolean	Não	Incluir URLs de favicon.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Mapear estrutura do site

TAVILY_MCP_TAVILY_MAP

Mapeia a estrutura de um site. Retorna uma lista de URLs encontradas a partir da URL base.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
url	string	Sim	A URL raiz onde o mapeamento começa.
limit	integer	Não	Número total de links que o rastreador vai processar antes de parar.
max_depth	integer	Não	Profundidade máxima do mapeamento. Define até onde a partir da URL base o rastreador pode explorar.
max_breadth	integer	Não	Número máximo de links a seguir por nível da árvore (ou seja, por página).
instructions	string	Não	Instruções em linguagem natural para o rastreador.
select_paths	array	Não	Padrões regex para selecionar apenas URLs com padrões de caminho específicos (ex.: /docs/.*, /api/v1.*).
allow_external	boolean	Não	Se deve retornar links externos na resposta final.
select_domains	array	Não	Padrões regex para restringir o mapeamento a domínios ou subdomínios específicos (ex.: ^docs\.example\.com$).

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Pesquisa aprofundada

TAVILY_MCP_TAVILY_RESEARCH

Realiza uma pesquisa abrangente sobre um tópico ou pergunta. Use esta ação quando precisar reunir informações de múltiplas fontes, incluindo páginas web, documentos e outros recursos, para responder a uma pergunta ou concluir uma tarefa. Retorna uma resposta detalhada com base nos resultados da pesquisa.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
input	string	Sim	Descrição abrangente da tarefa de pesquisa.
model	string ("mini" | "pro" | "auto")	Não	Define o grau de profundidade da pesquisa. mini é indicado para tarefas mais específicas com poucos subtópicos; pro é indicado para tarefas abrangentes com muitos subtópicos.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.

Buscar na web

TAVILY_MCP_TAVILY_SEARCH

Busca na web por informações atuais sobre qualquer tópico. Use para notícias, fatos ou dados além do seu corte de conhecimento. Retorna trechos e URLs das fontes.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
query	string	Sim	Consulta de busca.
topic	string	Não	A categoria da busca. Determina qual agente será usado para realizar a pesquisa.
country	string	Não	Prioriza resultados de busca de um país específico. Disponível apenas quando topic é general.
end_date	string	Não	Retorna todos os resultados anteriores à data de término especificada. Deve estar no formato YYYY-MM-DD.
start_date	string	Não	Retorna todos os resultados posteriores à data de início especificada. Deve estar no formato YYYY-MM-DD.
time_range	string	Não	O intervalo de tempo retroativo a partir da data atual a incluir nos resultados.
max_results	integer	Não	Número máximo de resultados de busca a retornar.
search_depth	string ("basic" | "advanced" | "fast" | "ultra-fast")	Não	A profundidade da busca. basic para resultados genéricos, advanced para busca mais completa, fast para baixa latência com alta relevância, ultra-fast para priorizar latência acima de tudo.
include_images	boolean	Não	Incluir uma lista de imagens relacionadas à consulta na resposta.
exclude_domains	array	Não	Lista de domínios a excluir especificamente dos resultados, se o usuário solicitar a exclusão de algum domínio.
include_domains	array	Não	Lista de domínios a incluir especificamente nos resultados de busca, se o usuário solicitar busca em sites específicos.
include_favicon	boolean	Não	Se deve incluir a URL do favicon de cada resultado.
include_raw_content	boolean	Não	Incluir o conteúdo HTML limpo e processado de cada resultado de busca.
include_image_descriptions	boolean	Não	Incluir uma lista de imagens relacionadas à consulta e suas descrições na resposta.

Saída

Nome	Tipo	Obrigatório	Descrição
data	string	Sim	Dados retornados pela execução da ação.
error	string	Não	Mensagem de erro caso a execução tenha falhado.
successful	boolean	Sim	Indica se a ação foi executada com sucesso.