Skill · Claude · Open-Meteo

O tempo, interpretado — sem chave de API.

Uma skill que consulta previsão, qualidade do ar, mar, rios e histórico no Open-Meteo — e responde o que isso significa para a sua atividade.

Capa do projeto Clima
O que é

Dados meteorológicos com leitura prática

A skill junta um script Python de consulta (scripts/clima.py) a um guia de interpretação. O Claude busca o dado certo, lê só os campos relevantes à pergunta e responde com conclusão, janela de tempo, números essenciais e recomendação.

🔓 Sem cadastro

Todos os endpoints do Open-Meteo usados são abertos: nenhuma chave, nenhum .env, nenhum limite de conta para consultar.

🌍 Seis consultas

geocode, forecast, air, marine, flood e history — do clima atual à reanálise entre duas datas.

🧭 Interpretação honesta

Códigos WMO, faixas de AQI e níveis UV documentados; risk_flags é triagem por limiar, nunca alerta oficial. Sem falsa precisão.

Como funciona

Da pergunta à recomendação

O fluxo da skill é fixo: resolver o lugar, escolher a consulta certa, ler só o que importa e responder começando pela conclusão.

Local + período + atividade→ geocode→ consulta (forecast / air / marine / flood / history)→ interpretação→ resposta + risco + recomendação

1. Resolver o lugar

Nome de cidade vira latitude/longitude. Se houver ambiguidade, a skill apresenta as opções ou pede estado/país — ou aceita coordenadas direto.

2. Escolher a consulta

Cada subcomando cobre um domínio. A skill não puxa tudo: só a consulta que responde à pergunta feita.

3. Traduzir em decisão

Roupa, exercício, viagem, praia ou saúde — a recomendação combina temperatura, sensação, vento, chuva, UV e AQI.

Pré-requisitos

O mínimo para rodar

Não há serviço para subir nem credencial para configurar. Só Python 3 e conexão de rede.

Python 3

O script usa apenas a biblioteca padrão — nada de pip install.

# conferir a versão
python3 --version

A skill instalada

Clone o repositório dentro da pasta de skills do Claude.

git clone https://github.com/inematds/clima-skill \
  ~/.claude/skills/clima

Acesso ao Open-Meteo

Rede liberada para open-meteo.com. Sem chave, sem conta.

# teste rápido
python3 scripts/clima.py --help
Guia de uso · passo a passo

Da instalação à primeira previsão

Todos os comandos abaixo rodam a partir da pasta da skill. Use --latitude e --longitude no lugar de --location quando já tiver coordenadas.

1

Instalar a skill

Clone o repositório na pasta de skills do Claude. Na próxima sessão o Claude passa a acionar a skill sozinho quando você perguntar sobre tempo.

git clone https://github.com/inematds/clima-skill ~/.claude/skills/clima
cd ~/.claude/skills/clima  # os comandos seguintes rodam daqui
2

Resolver o local

Antes de qualquer previsão, confirme para onde o nome aponta. Use --country-code para restringir o país quando o nome for ambíguo.

python3 scripts/clima.py geocode --location "São Paulo, SP"
python3 scripts/clima.py geocode --location "Santa Cruz" --country-code BR  # desambigua
3

Consultar clima atual e previsão

forecast cobre condições atuais e até 16 dias. Acrescente --hourly quando a pergunta for sobre horários — "chove na hora do jogo?".

python3 scripts/clima.py forecast --location "São Paulo, SP" --days 7
python3 scripts/clima.py forecast --location "Curitiba, PR" --days 3 --hourly  # janela por hora
4

Qualidade do ar, UV e pólen

air traz AQI, índice UV e pólen para até 7 dias — a consulta certa para exercício ao ar livre, alergia e grupos sensíveis.

python3 scripts/clima.py air --location "Brasília, DF" --days 5 --hourly
5

Mar e rios

marine dá ondas, maré modelada, temperatura e correntes; flood dá vazão fluvial modelada. Ambos são modelos — não substituem salvamento, carta náutica ou alerta oficial de enchente.

python3 scripts/clima.py marine --location "Ubatuba, SP" --days 5
python3 scripts/clima.py flood --location "Blumenau, SC" --days 14
6

Histórico entre duas datas

history usa reanálise para comparar períodos, checar uma data passada ou montar médias.

python3 scripts/clima.py history --location "Porto Alegre, RS" \
  --start 2025-01-01 --end 2025-01-31
7

Ver todas as opções

Cada subcomando tem o próprio --help com as variáveis e limites disponíveis.

python3 scripts/clima.py --help
python3 scripts/clima.py forecast --help
Exemplos

Perguntas que a skill responde

Você não precisa lembrar dos comandos: pergunte em português e o Claude escolhe a consulta, lê os campos relevantes e responde. Por baixo, é isto que roda.

🏃 "Posso correr amanhã de manhã?"

Combina previsão horária com UV e qualidade do ar para achar a melhor janela.

python3 scripts/clima.py forecast --location "Curitiba, PR" --days 2 --hourly
python3 scripts/clima.py air --location "Curitiba, PR" --days 2 --hourly

🏖️ "Dá praia no fim de semana em Ubatuba?"

Junta o tempo em terra com ondas e temperatura do mar — com o aviso de que modelo não substitui salvamento.

python3 scripts/clima.py forecast --location "Ubatuba, SP" --days 3
python3 scripts/clima.py marine --location "Ubatuba, SP" --days 3

🧳 "O que levar para São Paulo semana que vem?"

Temperatura, sensação térmica, vento e chuva viram recomendação de roupa e itens úteis.

python3 scripts/clima.py forecast --location "São Paulo, SP" --days 7

📊 "Janeiro passado foi mais chuvoso que a média?"

Reanálise entre duas datas, com o período e a fonte declarados na resposta.

python3 scripts/clima.py history --location "Porto Alegre, RS" \
  --start 2025-01-01 --end 2025-01-31
Roadmap

Onde está e para onde vai

A skill já cobre as seis consultas e a camada de interpretação. O que vem depois é profundidade, não escopo novo.

Pronto
Consulta + interpretaçãoOs seis subcomandos, o guia de códigos WMO / AQI / UV, as regras de risco e o modelo de resposta estruturada.
Pronto
Recomendação por atividadeRoupa, exercício, viagem/evento, praia/mar e saúde — cada uma com o conjunto de variáveis que importa.
Próximo
Comparação entre cidadesConsulta em lote para colocar dois ou mais lugares lado a lado na mesma janela de tempo.
Depois
Ponte com alertas oficiaisApontar a autoridade meteorológica adequada ao país quando a triagem indicar risco relevante.