OpenWeatherMap

Visão geral

O OpenWeatherMap é um serviço de dados meteorológicos que fornece previsões visuais, condições climáticas em tempo real e mapeamento geográfico do clima, ajudando usuários a entender padrões climáticos ou rastrear condições severas de tempo. Com a integração no SquadOS, seus agentes podem consultar o clima atual de qualquer cidade e converter nomes de locais em coordenadas de latitude/longitude para uso em outras consultas baseadas em localização.

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

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 OpenWeatherMap.
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

Geocodificar localização em coordenadas

WEATHERMAP_GEOCODE_LOCATION

Converte um nome de lugar legível por humanos em coordenadas canônicas de latitude/longitude usando a API de Geocodificação do OpenWeather. Use quando precisar converter strings de localização (nomes de cidades, endereços) em coordenadas para previsões do tempo ou outras consultas baseadas em localização. Retorna até 5 resultados candidatos; o primeiro resultado é tipicamente o mais relevante.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
q	string	Sim	String de consulta de localização no formato cidade ou cidade,código_país ou cidade,estado,código_país. Para locais nos EUA, pode incluir o código de estado (ex: Austin,TX,US). Use códigos de país ISO 3166 (ex: London,GB, Paris,FR). A API suporta mais de 200.000 localizações cadastradas.
limit	integer	Não	Número máximo de correspondências de localização a retornar (1–5). Use para limitar os resultados quando múltiplos locais compartilham o mesmo nome. Padrão: 5.

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.

Informações do tempo

WEATHERMAP_WEATHER

Consulta a API do OpenWeatherMap e retorna as condições meteorológicas atuais — sem índice UV, qualidade do ar (AQI) ou alertas oficiais. Os timestamps são em UTC; aplique o campo de offset de fuso horário antes de agrupar por dia local.

Parâmetros de entrada

Nome	Tipo	Obrigatório	Descrição
location	string	Sim	Nome real de uma cidade (ex: London, New York, Tokyo). DEVE ser um nome de cidade real — NÃO um placeholder como “sua localização”, “localização atual” ou “minha localização”. Nomes de cidade devem estar em caracteres latinos/inglês. Opcionalmente, pode acrescentar um código de país (ex: London,GB). Para cidades dos EUA com abreviação de estado, use o formato de 3 partes Cidade,CódigoEstado,US (ex: Redding,CA,US, Portland,OR,US) — o formato de 2 partes Cidade,CódigoEstado será interpretado como código de país (CA = Canadá, não Califórnia). Se ocorrer erro de “cidade não encontrada”, tente novamente com uma string mais simples (ex: remova o código de estado, use só Cidade ou Cidade,CódigoPaís). Locais pequenos ou remotos podem não retornar dados; trate isso de forma adequada em vez de tentar repetidamente.

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.