Composio Search

Visão geral

O Composio Search é uma plataforma de busca abrangente que agrega resultados de viagens (voos, hotéis, eventos), e-commerce (Amazon, Walmart, compras), mercados financeiros, notícias, pesquisa acadêmica, imagens e serviços de localização. Com a integração no SquadOS, seus agentes podem realizar pesquisas na web em tempo real, comparar preços em diversas lojas, consultar dados financeiros, buscar artigos acadêmicos e muito mais — tudo sem precisar configurar chaves de API externas.

• Documentação na Composio: docs.composio.dev/toolkits/composio_search

Autenticação

Esta ferramenta utiliza sem autenticação (NO_AUTH) para conectar.

Campo	Obrigatório	Descrição
N/A	Não	Esta ferramenta não exige credenciais.

Como conectar no SquadOS

1. Acesse Ferramentas no menu lateral (/admin/tools).
2. Abra a aba Disponíveis e procure por Composio Search.
3. Clique no card para abrir o modal de detalhes e em Ativar — a ferramenta vai direto para a lista de ativas, sem etapa de login. (Detalhes do fluxo em Ferramentas da Organização.)

Ações disponíveis

Pesquisa de produtos na Amazon

COMPOSIO_SEARCH_AMAZON

Pesquisa produtos na Amazon em diferentes marketplaces internacionais. Esta ferramenta busca no catálogo de produtos da Amazon com suporte a múltiplos domínios/marketplaces internacionais. Cada domínio atende a um país diferente com preços locais, moeda, opções de entrega e disponibilidade de produtos. Ideal para pesquisa de produtos, comparação de preços internacionais e busca de produtos disponíveis em países específicos. Retorna detalhes do produto, preços na moeda local, avaliações, reviews e informações do vendedor.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
page	integer	Não	Número da página para paginação. Começa em 1. Cada página contém tipicamente ~20 resultados. Use para recuperar páginas adicionais além da primeira.
query	string	Sim	Consulta de busca de produto na Amazon. Use linguagem natural ou nomes específicos de produtos.
amazon_domain	string	Não	Domínio do marketplace Amazon baseado no país. Padrão: amazon.com. Domínios diferentes atendem a países e moedas diferentes.

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.

Busca DuckDuckGo via Composio

COMPOSIO_SEARCH_DUCK_DUCK_GO

Realiza buscas na web utilizando a API DuckDuckGo via Composio, com foco em informações e detalhes da web. Aproveita o mecanismo de busca DuckDuckGo para recuperar dados relevantes com base na consulta fornecida.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
query	string	Sim	A consulta de busca para a API DuckDuckGo do Composio, especificando o tópico de pesquisa.
start	integer	Não	Deslocamento de resultado para paginação. Use múltiplos do tamanho de página (tipicamente 10–30) para recuperar páginas subsequentes.

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.

Busca de eventos no Google via Composio

COMPOSIO_SEARCH_EVENT

Busca eventos futuros, shows, festivais, conferências e outras atividades. Suporta busca por localização (cidade, bairro, endereço), filtro por data (hoje, amanhã, fim de semana, próxima semana/mês), descoberta de eventos virtuais, busca internacional com mais de 100 idiomas e países, e paginação. Se os resultados forem escassos ou events_results_state for 'Fully empty', trate como cobertura limitada e tente COMPOSIO_SEARCH_WEB em vez de repetir a consulta.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
gl	string	Não	Código de país para a região de busca (ISO 3166-1 alpha-2). Determina quais eventos do país priorizar.
hl	string	Não	Código de idioma para a interface de busca e resultados (ISO 639-1). Controla o idioma das descrições de eventos.
query	string	Sim	Consulta de busca de eventos, especificando o tipo de evento. Deve ser não vazia e incluir um tipo específico (ex.: ‘concert’, ‘festival’); valores genéricos como ‘events’ podem retornar resultados ruidosos.
start	integer	Não	Deslocamento de resultado para paginação. Cada página contém tipicamente 10 resultados. Use múltiplos de 10. Pare de paginar quando uma página não retornar novos itens.
htichips	string	Não	Filtros avançados de eventos. Múltiplos filtros podem ser combinados com vírgulas. Apenas os valores de data e tipo de evento listados são suportados; valores não suportados retornam silenciosamente sem resultados.
location	string	Não	Localização geográfica para busca de eventos. Use especificidade no nível de cidade para melhores resultados. Se omitido, a busca usa a localização do proxy. Evite o formato ‘Cidade, País’ — use apenas nomes de cidades.

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.

Exa Answer

COMPOSIO_SEARCH_EXA_ANSWER

Obtém respostas com citações usando a API Exa. DESCONTINUADO: Use COMPOSIO_SEARCH_WEB em vez desta ação.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
content	string	Sim	O conteúdo da mensagem do usuário para a API Exa Answer.

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.

Links similares via Composio

COMPOSIO_SEARCH_EXA_SIMILARLINK

Realiza uma busca para encontrar links similares e recupera uma lista de resultados relevantes. A busca pode opcionalmente retornar conteúdo das páginas.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
url	string	Sim	A URL para a qual você deseja encontrar links similares. Ex.: 'https://slatestarcodex.com/2014/07/30/meditations-on-moloch/'.
type	string	Não	O tipo de busca: 'keyword', 'neural' ou 'magic'.
category	string	Não	Uma categoria de dados para focar, com maior abrangência e qualidade. Categorias incluem: company, research paper, news, github, tweet, movie, song, personal site e pdf.
numResults	integer	Não	Número de resultados de busca a retornar. Ex.: 10, 20, 30.
endCrawlDate	string	Não	Os resultados incluirão links rastreados antes desta data. Ex.: '2023-01-01T00:00:00Z'.
useAutoprompt	boolean	Não	Se verdadeiro, sua consulta será convertida para uma consulta Composio Similarlinks.
excludeDomains	array	Não	Lista de domínios a excluir da busca. Ex.: ['example.com'].
includeDomains	array	Não	Lista de domínios a incluir na busca. Ex.: ['example.com'].
startCrawlDate	string	Não	Os resultados incluirão links rastreados após esta data. Ex.: '2023-01-01T00:00:00Z'.
endPublishedDate	string	Não	Apenas links publicados antes desta data serão retornados. Ex.: '2023-01-01'.
startPublishedDate	string	Não	Apenas links publicados após esta data serão retornados. Ex.: '2023-01-01'.

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 conteúdo de URL

COMPOSIO_SEARCH_FETCH_URL_CONTENT

Busca e extrai o texto limpo e legível (markdown) de páginas web públicas (conteúdo HTML) usando a API Exa. Use quando precisar recuperar conteúdo real de resultados de busca ou links de documentação para extrair etapas de configuração, requisitos ou citações. Funciona apenas com URLs de páginas web — não suporta links diretos para imagens, PDFs ou outros arquivos binários.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
text	boolean	Não	Incluir texto markdown extraído da página. Padrão: verdadeiro.
urls	array	Sim	Lista de URLs públicas de páginas web (conteúdo HTML) para buscar conteúdo. As URLs devem ser válidas e publicamente acessíveis. Não use links diretos para imagens (.jpg, .png, .gif), PDFs ou outros arquivos binários — use URLs de páginas web. Também aceita uma única string de URL.
extras	object	Não	Opções adicionais de conteúdo como contagens de imageLinks ou links (ex.: {'imageLinks': 3, 'links': 5}).
summary	string	Não	Incluir resumo gerado por IA do conteúdo da página. Pode ser booleano ou objeto com opções de query/schema.
max_characters	integer	Não	Número máximo de caracteres a extrair de cada página. Mapeado para text.maxCharacters na API Exa.

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.

Busca financeira via Composio

COMPOSIO_SEARCH_FINANCE

Obtém preços de ações em tempo real, dados de mercado, notícias financeiras e informações sobre empresas com análise histórica. Recupera cotações de ações, índices de mercado, preços de criptomoedas, taxas de câmbio e notícias financeiras. Suporta janelas de tempo discretas (1D, 5D, 1M, 6M, YTD, 1Y, 5Y, MAX) para análise histórica. Retorna dados numéricos de séries temporais, informações de resumo e eventos principais (apenas para janelas de 6M ou mais). Verifique sempre finance_results_state na resposta — um HTTP 200 com status='Success' ainda pode retornar dados vazios.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
hl	string	Não	Código de idioma para interface e dados financeiros (ISO 639-1). Padrão inglês se não definido; configure explicitamente para locais não ingleses.
query	string	Sim	Consulta de busca financeira. Formatos suportados: (1) Ações: 'SYMBOL:EXCHANGE' (ex.: 'AAPL:NASDAQ', 'WMT:NYSE') ou apenas 'SYMBOL' para ações principais dos EUA. (2) Índices: '.DJI:INDEXDJX' (Dow Jones), '.INX:INDEXSP' (S&P 500). (3) Criptomoedas: formato 'SYMBOL-USD' (ex.: 'BTC-USD'). (4) Pares de moeda: formato 'BASE-QUOTE' (ex.: 'EUR-USD'). (5) ETFs: símbolo do ticker (ex.: 'SPY'). Use formatos exatos de ticker — nomes em linguagem natural causam resultados vazios.
window	string	Não	Intervalo de tempo para gráficos e dados financeiros. Controla o período histórico exibido. Apenas os valores discretos listados são aceitos. Eventos principais (lucros, dividendos, desdobramentos) são retornados apenas para janelas de 6M ou mais.

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.

Busca de voos

COMPOSIO_SEARCH_FLIGHTS

Busca voos com informações abrangentes de preços, horários e companhias aéreas. Encontra voos disponíveis entre cidades/aeroportos com preços detalhados, múltiplas companhias, horários de partida/chegada, duração do voo e opções de reserva. Suporta pesquisas de ida e volta e somente ida, múltiplos tipos de passageiros (adultos, crianças, bebês), diferentes classes de viagem e preços internacionais em várias moedas. Você pode usar linguagem natural ou parâmetros estruturados.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
gl	string	Não	Código de país para resultados (ISO 3166-1 alpha-2).
hl	string	Não	Código de idioma para resultados (ISO 639-1).
query	string	Não	Consulta de busca de voo em linguagem natural. Ex.: 'Lahore to San Francisco', 'NYC to London on March 15'. Se fornecido, o sistema extrai aeroportos de partida/chegada e datas.
adults	integer	Não	Número de passageiros adultos (18+ anos).
infants	integer	Não	Número de passageiros bebês (menos de 2 anos).
children	integer	Não	Número de passageiros crianças (2–11 anos).
currency	string	Não	Moeda para preços (código de moeda de 3 letras).
arrival_id	string	Não	Código IATA do aeroporto de destino (3 letras maiúsculas, ex.: SFO, LHR). Obrigatório se query não for fornecido.
return_date	string	Não	Data de retorno no formato YYYY-MM-DD. Não pode estar no passado e deve ser após outbound_date. Deixe vazio para voos somente ida.
departure_id	string	Não	Código IATA do aeroporto de origem (3 letras maiúsculas, ex.: JFK, LAX). Obrigatório se query não for fornecido.
travel_class	integer	Não	Preferência de classe de viagem. 1 = Econômica, 2 = Econômica Premium, 3 = Executiva, 4 = Primeira Classe.
outbound_date	string	Não	Data de partida no formato YYYY-MM-DD (ex.: 2025-12-25). Não pode estar no passado. Se não fornecido e query não contiver data, o padrão é 7 dias a partir de hoje.

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.

Busca no Google Maps via Composio

COMPOSIO_SEARCH_GOOGLE_MAPS

Realiza uma busca específica por localização via API do Google Maps pelo Composio, retornando resultados em results.local_results (consultas de múltiplos locais) ou results.place_results (local único); sempre trate ambas as ramificações. Campos como opening_hours, phone, rating e user_reviews podem estar ausentes — trate valores faltantes como desconhecidos. Verifique business_status: estabelecimentos fechados podem aparecer nos resultados; filtre por OPERATIONAL. Limite as chamadas a ~1 req/s; HTTP 429 ou OVER_QUERY_LIMIT indica esgotamento de cota.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
q	string	Sim	A consulta de busca. Inclua cidade/região e categoria para evitar resultados ambíguos (ex.: 'pizza downtown Chicago' e não apenas 'pizza'). Verifique nome e endereço completo antes de selecionar um resultado.
ll	string	Não	Coordenadas GPS para a busca, no formato '@latitude,longitude,zoom_level'. Obrigatório ao usar paginação.
start	integer	Não	Usado para paginação. Cada página retorna ~20 local_results; incremente start em 20 e siga os tokens de serpapi_pagination.next para recuperar páginas subsequentes.

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.

Inferência via Groq Chat

COMPOSIO_SEARCH_GROQ_CHAT

Executa inferência rápida de LLM usando o hardware otimizado e a API da Groq. A Groq oferece inferência ultra-rápida para modelos open-source incluindo LLaMA 3, Mixtral e Gemma via API de chat completions compatível com OpenAI. Casos de uso: chat em tempo real, geração de conteúdo, Q&A, geração de código, sumarização, tradução. Para saída JSON estruturada, instrua o modelo explicitamente a retornar JSON válido sem code fences em markdown; valide com json.loads. Sempre valide que a resposta contém pelo menos uma escolha com message.content não vazio antes do uso downstream.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
model	string	Não	O modelo Groq a usar para inferência. Modelos disponíveis: "llama-3.3-70b-versatile", "llama-3.1-8b-instant", "llama-3.2-1b-preview", "llama-3.2-3b-preview", "llama-3.2-11b-text-preview", "llama-3.2-90b-text-preview", "mixtral-8x7b-32768", "gemma2-9b-it", "gemma-7b-it", "openai/gpt-oss-120b", "groq/compound".
top_p	number	Não	Parâmetro de amostragem nucleus. Controla a diversidade considerando apenas a massa de probabilidade top P. Intervalo: 0.0 a 1.0.
stream	boolean	Não	Se deve transmitir a resposta incrementalmente ou retornar tudo de uma vez.
messages	array	Sim	Um array de objetos de mensagem que formam o histórico da conversa. Cada mensagem deve ter um papel (system, user ou assistant) e conteúdo. Coloque instruções de persona e sistema em uma mensagem role:'system'; mantenha as mensagens de sistema concisas.
max_tokens	integer	Não	O número máximo de tokens a gerar na resposta. Se finish_reason for 'length', a saída foi truncada — gere conteúdo grande em blocos de seção.
temperature	number	Não	Controla a aleatoriedade na saída. Valores baixos (ex.: 0.2) tornam a saída mais focada e determinística; valores altos (ex.: 1.5) mais criativa. Intervalo: 0.0 a 2.0.

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.

Busca de hotéis

COMPOSIO_SEARCH_HOTELS

Busca hotéis e aluguéis de temporada com filtragem abrangente e preços. Retorna resultados em results.properties e results.ads; extraia preços numéricos de rate_per_night.extracted_lowest, total_rate.extracted_lowest ou extracted_price (os campos variam por propriedade). Deduplique entre seções usando property_token. Páginas adicionais disponíveis via serpapi_pagination.next_page_token. Comece com filtros mínimos — combinar muitos filtros estritamente pode retornar resultados vazios.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
q	string	Sim	Localização para busca de hotéis. Pode ser cidade, bairro, ponto de referência ou nome específico de hotel.
gl	string	Não	Código de país para resultados (ISO 3166-1 alpha-2).
hl	string	Não	Código de idioma para resultados (ISO 639-1).
adults	integer	Não	Número de hóspedes adultos.
sort_by	integer	Não	Ordenar hotéis por critério. Valores válidos: 3 (menor preço), 8 (melhor avaliação), 13 (mais avaliados). Padrão é relevância.
children	integer	Não	Número de crianças.
currency	string	Não	Moeda para preços (código de 3 letras).
max_price	integer	Não	Filtro de preço máximo por noite.
min_price	integer	Não	Filtro de preço mínimo por noite.
hotel_class	string	Não	Filtrar por classificação de estrelas do hotel. Use valores separados por vírgula para múltiplas classificações.
check_in_date	string	Sim	Data de check-in no formato YYYY-MM-DD. Deve ser uma data futura.
check_out_date	string	Sim	Data de check-out no formato YYYY-MM-DD. Deve ser após a data de check-in.
vacation_rentals	boolean	Não	Incluir aluguéis de temporada (propriedades estilo Airbnb) nos resultados.
free_cancellation	boolean	Não	Filtrar por hotéis com cancelamento gratuito.

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.

Busca de imagens via Composio

COMPOSIO_SEARCH_IMAGE

Realiza uma busca de imagens usando a API de Busca de Imagens do Composio, direcionada a metadados e URLs de imagens (não dados binários) via Google Imagens. Retorna resultados em results.images_results; cada entrada expõe URLs original (resolução completa) e thumbnail (baixa resolução) — verifique se as URLs são publicamente acessíveis antes de usar downstream. Verifique license_details_url por resultado antes de reutilização comercial. O número de resultados é controlado por num (1–100, padrão 20). Para mais de 100 imagens, pagine usando serpapi_pagination.next.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
ijn	integer	Não	Número de página de imagem para paginação. Começa em 0 (primeira página). Cada página retorna até 100 resultados.
num	integer	Não	Número de resultados de imagem a retornar. Padrão 20 se não especificado. O Google tipicamente retorna até 100 resultados.
query	string	Sim	A consulta de busca para a API de Busca de Imagens do Composio, especificando o tópico da imagem.

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.

Busca de notícias via Composio

COMPOSIO_SEARCH_NEWS

Busca os artigos de notícias mais recentes e eventos atuais com filtragem inteligente. Pesquisa apenas fontes orientadas a notícias (não blogs, documentações ou páginas de empresas). Os resultados ficam em data.results.news_results; uma resposta 200 com news_results vazio ou news_results_state: 'Fully empty' significa sem resultados — amplie a consulta ou a janela when. Suporta mais de 100 idiomas e países. Use operadores avançados como 'site:' para filtragem de publisher diretamente na consulta.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
gl	string	Não	Código de país para região de notícias (ISO 3166-1 alpha-2). Determina quais fontes de notícias do país priorizar.
hl	string	Não	Código de idioma para interface e resultados de notícias. A maioria dos idiomas usa códigos ISO 639-1 (ex.: 'en', 'es'). Chinês requer variantes regionais: 'zh-cn' (Simplificado) ou 'zh-tw' (Tradicional).
when	string	Não	Filtro de tempo para artigos de notícias. 'd' = dia passado, 'w' = semana passada, 'm' = mês passado, 'y' = ano passado. Combinar consultas estreitas com filtros when estritos frequentemente retorna zero resultados.
query	string	Não	Consulta de busca para artigos de notícias. Suporta operadores avançados como 'site:', 'when:', etc. Não pode ser usado com topic_token, publication_token ou story_token.
start	integer	Não	Deslocamento de resultado para paginação. Cada página contém tipicamente 10 resultados. Use múltiplos de 10.

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.

Consulta ao Registro NPI (NPPES)

COMPOSIO_SEARCH_NPPESNPI_LOOKUP

Consulta detalhes de prestadores de saúde dos EUA no Registro NPI do CMS (NPPES) usando um número NPI ou filtros de busca. Retorna campos estruturados normalizados incluindo nome do prestador, taxonomia/especialidade, endereços, identificadores e endpoints. Use para consultas determinísticas e autoritativas de prestadores quando precisar de dados NPI/NPPES estruturados em vez de resultados de busca na web.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
city	string	Não	Nome da cidade associada ao endereço do prestador.
skip	integer	Não	Número de registros a pular para paginação. Usado com limit para resultados paginados.
limit	integer	Não	Número máximo de registros a retornar por requisição. Intervalo: 1 a 1200. Padrão: 10.
state	string	Não	Abreviação de estado de duas letras. Não pode ser usado como único critério de busca — deve ser combinado com outros parâmetros.
number	string	Não	Número NPI de 10 dígitos para consulta exata. Quando fornecido, realiza correspondência exata do NPI.
version	string	Não	Número de versão da API. Obrigatório pela API NPPES do CMS.
last_name	string	Não	Sobrenome do prestador individual. Suporta curinga no final (*) após mínimo de 2 caracteres. Aplica-se apenas a Prestadores Individuais (NPI-1).
first_name	string	Não	Nome do prestador individual. Suporta curinga no final (*) após mínimo de 2 caracteres. Aplica-se apenas a Prestadores Individuais (NPI-1).
postal_code	string	Não	Código postal de 5 ou 9 dígitos. Suporta curinga no final (*) após mínimo de 2 caracteres.
enumeration_type	string	Não	Tipo de classificação do prestador: 'NPI-1' ou 'ind' para prestadores individuais, 'NPI-2' ou 'org' para prestadores organizacionais.
organization_name	string	Não	Nome da organização para busca de prestadores organizacionais. Suporta curinga no final (*) após mínimo de 2 caracteres.
taxonomy_description	string	Não	Descrição de taxonomia ou especialidade do prestador de saúde. Suporta curinga (*) após mínimo de 2 caracteres.

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.

Busca acadêmica via Composio Scholar

COMPOSIO_SEARCH_SCHOLAR

Raspa resultados de busca do Google Scholar via SERP API, retornando artigos acadêmicos e científicos. Os resultados ficam em results.organic_results; acesse essa chave explicitamente e use padrões .get() defensivos, pois campos como DOI, citation_count e autor podem estar ausentes. Muitos resultados são protegidos por paywall — dependa de títulos, resumos e trechos quando o texto completo não estiver disponível. Resultados podem incluir versões duplicadas de preprint e periódico da mesma obra — deduplique por DOI ou título normalizado. Apenas a primeira página é retornada por padrão; siga pagination.next para páginas adicionais.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
query	string	Sim	A consulta de busca para a API de Busca Acadêmica do Composio, especificando o tópico ou título do artigo. Prefira frases-chave curtas e focadas a frases longas entre aspas para evitar resultados zerados. Inclua nomes de autores, qualificadores de campo ou intervalos de ano para melhorar a relevância.
start	integer	Não	Deslocamento de resultado para paginação. Cada página contém tipicamente 10 resultados. Use múltiplos de 10.

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.

Busca de registros SEC EDGAR via Composio

COMPOSIO_SEARCH_SEC_FILINGS

Recupera metadados autoritativos de registros SEC EDGAR (10-K/10-Q/8-K etc.) e constrói URLs de documentos primários/índices usando as APIs de dados públicos da SEC. Use quando precisar buscar registros financeiros de empresas, relatórios anuais, relatórios trimestrais ou outras divulgações obrigatórias pela SEC.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
limit	integer	Não	Número máximo de registros a retornar. Padrão: 10.
form_types	array	Não	Lista de tipos de formulário SEC para filtrar (ex.: ['10-K', '10-Q', '8-K']). Se não especificado, todos os tipos de formulário são retornados.
ticker_or_cik	string	Sim	Símbolo de ticker da ação (ex.: 'AAPL', 'MSFT') ou Chave de Índice Central (CIK) de 10 dígitos. Se um ticker for fornecido, será automaticamente resolvido para CIK.
include_document_links	boolean	Não	Se deve incluir URLs de documentos de registro (página de índice e documento primário) para leitura downstream. Padrão: verdadeiro.

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.

Busca de compras via Composio

COMPOSIO_SEARCH_SHOPPING

Busca produtos com filtragem avançada de preços, segmentação por localização e descoberta de promoções. Fornece busca abrangente de produtos com filtragem por faixa de preço, segmentação geográfica para varejistas locais, ordenação por preço (crescente/decrescente) e filtragem por frete grátis ou itens em promoção. Retorna detalhes do produto, preços, disponibilidade, informações do vendedor e avaliações.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
gl	string	Não	Código de país para região de compras (ISO 3166-1 alpha-2).
hl	string	Não	Código de idioma para interface de compras (ISO 639-1).
query	string	Sim	Consulta de busca de produto. Use qualquer texto que você pesquisaria no Google Shopping.
on_sale	boolean	Não	Filtrar para mostrar apenas produtos atualmente em promoção.
sort_by	integer	Não	Ordenar produtos por preço. 1 = Preço: menor primeiro, 2 = Preço: maior primeiro.
location	string	Não	Localização geográfica para busca de compras. Use nomes de cidades para melhores resultados. Ajuda a encontrar varejistas locais e preços regionais.
max_price	integer	Não	Filtro de preço máximo em USD (valor inteiro). Mostrar apenas produtos com preço igual ou inferior.
min_price	integer	Não	Filtro de preço mínimo em USD (valor inteiro). Mostrar apenas produtos com preço igual ou superior.
free_shipping	boolean	Não	Filtrar para mostrar apenas produtos com frete grátis.

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.

Busca LLM via Composio

COMPOSIO_SEARCH_TAVILY

A busca LLM do Composio serve como gateway para a API de Busca LLM do Composio, permitindo que usuários realizem buscas em uma ampla gama de conteúdo com múltiplas opções de filtragem. Acomoda consultas complexas, incluindo buscas por palavras-chave e frases, com parâmetros adicionais para refinar os resultados. Permite uma experiência de busca personalizada ao permitir especificar a profundidade da busca, incluir imagens e respostas diretas, aplicar filtros específicos de domínio e controlar o número de resultados retornados.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
query	string	Sim	O texto principal usado para realizar a busca. Este é o termo ou frase-chave que a funcionalidade de busca usará para recuperar resultados.
max_results	integer	Não	O número máximo de resultados de busca que a API deve retornar. Limita o tamanho do conjunto de resultados para a consulta.
search_depth	string	Não	Determina a profundidade da busca. 'basic' realiza uma busca rápida e ampla; 'advanced' indica uma busca mais intensiva e específica.
include_answer	boolean	Não	Especifica se deve incluir respostas diretas à consulta nos resultados. Útil para consultas que esperam uma resposta factual.
include_images	boolean	Não	Indica se deve incluir imagens nos resultados. Quando verdadeiro, a resposta conterá links de imagens relacionados à consulta.
exclude_domains	array	Não	Lista de nomes de domínio a excluir dos resultados. Resultados desses domínios não serão incluídos, ajudando a filtrar conteúdo indesejado.
include_domains	array	Não	Lista de nomes de domínio a incluir nos resultados. Apenas resultados desses domínios especificados serão retornados, permitindo buscas direcionadas.
include_raw_content	boolean	Não	Se verdadeiro, os resultados incluirão o conteúdo bruto do índice de busca, que pode conter HTML ou texto não processado.

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.

Busca de tendências via Composio

COMPOSIO_SEARCH_TRENDS

Descobre tópicos em tendência, padrões de busca e dados de popularidade. Analisa o interesse de busca ao longo do tempo, compara múltiplos tópicos e identifica tendências emergentes. Retorna índices de interesse relativos normalizados de 0–100 (não volumes absolutos de busca) via interest_over_time.timeline_data. Os dados tipicamente atrasam ~24–48 horas. O esquema de resposta varia por data_type: TIMESERIES retorna timeline_data, GEO_MAP retorna desagregações regionais, RELATED_TOPICS/RELATED_QUERIES retornam listas de tópicos/consultas.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
date	string	Não	Intervalo de tempo para dados de tendências. Intervalos predefinidos: 'now 1-H' (última hora), 'now 4-H' (últimas 4 horas), 'now 1-d' (último dia), 'now 7-d' (últimos 7 dias), 'today 1-m' (últimos 30 dias), 'today 3-m' (últimos 90 dias), 'today 12-m' (últimos 12 meses), 'today 5-y' (últimos 5 anos), 'all' (de 2004 até o presente). Intervalos personalizados: 'yyyy-mm-dd yyyy-mm-dd'. Padrão: últimos 12 meses.
query	string	Sim	A consulta de busca para a API do Google Trends, especificando o tópico de tendência. Para TIMESERIES, aceita até 5 tópicos separados por vírgula (ex.: 'Python,JavaScript,Rust'); exceder 5 retorna erro.
data_type	string	Não	Define o tipo de busca. Opções: TIMESERIES — interesse ao longo do tempo (padrão); GEO_MAP — comparação por região; GEO_MAP_0 — interesse por região (consulta única); RELATED_TOPICS — tópicos relacionados (consulta única); RELATED_QUERIES — consultas relacionadas (consulta única).

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.

Busca de viagens no TripAdvisor

COMPOSIO_SEARCH_TRIP_ADVISOR

Busca no TripAdvisor recomendações de viagem e planejamento de roteiros sem autenticação. Pesquisa atrações, restaurantes, hotéis, passeios e atividades. Retorna avaliações detalhadas, reviews, fotos e recomendações de viajantes. Os dados de resposta ficam em results → locations. Os resultados podem incluir artigos evergreen junto com locais específicos; verifique o tipo de resultado antes de usar em roteiros.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
ssrc	string	Não	Filtro de busca para especificar o tipo de resultado. 'a' = Todos os Resultados, 'r' = Restaurantes, 'A' = O que Fazer, 'h' = Hotéis, 'g' = Destinos, 'v' = Aluguéis de Temporada, 'f' = Fóruns.
limit	integer	Não	Número máximo de resultados a retornar por página.
query	string	Sim	Consulta de busca para o TripAdvisor. Use linguagem natural para buscar atrações, restaurantes, hotéis ou atividades. Inclua o nome do destino, região e contexto de viagem para melhores resultados.
offset	integer	Não	Deslocamento de resultado para paginação. Incremente pelo tamanho da página (tipicamente 10–30) para navegar pelas páginas.
tripadvisor_domain	string	Não	Domínio do TripAdvisor para diferentes países. Padrão: tripadvisor.com para resultados internacionais.

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.

Busca de produtos no Walmart

COMPOSIO_SEARCH_WALMART

Busca produtos no Walmart com filtragem de preços. Esta ferramenta pesquisa o catálogo de produtos do Walmart incluindo mantimentos, eletrônicos, roupas, itens para o lar, farmácia e serviços automotivos. Suporta filtragem básica por faixa de preço. Os resultados podem aparecer em response.data.results.shopping_results ou data.products — não hardcode um único formato de resposta. Os resultados misturam listagens patrocinadas e orgânicas; verifique flags de anúncio/patrocínio ao classificar.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
query	string	Sim	Consulta de busca de produto para o Walmart. Use linguagem natural ou nomes específicos de produtos.
max_price	number	Não	Filtro de preço máximo em USD.
min_price	number	Não	Filtro de preço mínimo em USD.

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.

Busca web via Composio

COMPOSIO_SEARCH_WEB

Realiza uma busca na web usando a API Exa. Retorna uma estrutura aninhada: resumo narrativo em results.answer, fontes em results.citations (e opcionalmente results.organic_results). Priorize results.citations como evidência primária em detrimento de results.answer, que pode ser vago. Indexa apenas conteúdo publicamente disponível — sem conteúdo protegido por paywall, exigente de login ou privado. Limite a ~1–2 requisições/segundo; consultas em rajadas disparam HTTP 429.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
query	string	Sim	A consulta de busca para a API Exa do Composio. Deve ser não vazia; usar qualquer outro nome de parâmetro (ex.: 'q') causa erro de requisição inválida. Inclua qualificadores (ano, região, plataforma, intenção) para melhores resultados — consultas amplas retornam conteúdo genérico.

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.