buscar_feriados
Busca feriados brasileiros com filtros flexíveis.
Use esta tool para consultas gerais quando precisar filtrar por múltiplos critérios ao mesmo tempo.
Pode filtrar por data, tipo (NACIONAL/ESTADUAL/MUNICIPAL/FACULTATIVO), estado (UF), cidade (código IBGE), ano e mês.
Para buscas mais específicas, prefira usar as tools especializadas (feriados_nacionais, feriados_por_estado, etc.).
Retorna lista paginada de feriados com nome, data (DD/MM/YYYY), tipo e descrição.
feriados_nacionais
Lista todos os feriados nacionais do Brasil para um ano específico.
Inclui feriados como Carnaval, Sexta-feira Santa, Tiradentes, Dia do Trabalho, Independência, Nossa Senhora Aparecida, Finados, Proclamação da República e Natal.
Opcionalmente pode incluir feriados facultativos nacionais (Ponto Facultativo).
Se nenhum ano for informado, retorna feriados de todos os anos disponíveis.
feriados_por_estado
Lista todos os feriados de um estado brasileiro (feriados nacionais + estaduais daquele UF).
Use quando o usuário perguntar sobre feriados em um estado específico, como "feriados em São Paulo" ou "feriados do RJ".
As siglas dos estados (UF) são: AC, AL, AP, AM, BA, CE, DF, ES, GO, MA, MT, MS, MG, PA, PB, PR, PE, PI, RJ, RN, RS, RO, RR, SC, SP, SE, TO.
feriados_por_cidade
Lista todos os feriados de uma cidade brasileira (feriados nacionais + estaduais + municipais).
Use quando o usuário perguntar sobre feriados em uma cidade específica.
Requer o código IBGE do município. Se não souber o código IBGE, use primeiro a tool 'buscar_municipios' para encontrá-lo.
Exemplos de códigos IBGE: São Paulo = 3550308, Rio de Janeiro = 3304557, Belo Horizonte = 3106200, Brasília = 5300108.
verificar_data
Verifica se uma data específica é feriado no Brasil.
Use quando o usuário perguntar algo como "amanhã é feriado?", "25 de dezembro é feriado?", ou "segunda-feira vai ser feriado?".
Retorna todos os feriados que caem naquela data (pode ter mais de um: nacional + municipal, por exemplo).
Se retornar lista vazia, a data NÃO é feriado.
listar_estados
Lista todos os 27 estados brasileiros (26 estados + Distrito Federal) com suas siglas UF.
Use quando precisar consultar as siglas dos estados ou quando o usuário perguntar "quais são os estados do Brasil".
Retorna sigla (UF) e nome completo de cada estado.
buscar_municipios
Busca municípios brasileiros por estado. Retorna nome, UF e código IBGE de cada município.
Use esta tool para descobrir o código IBGE de uma cidade antes de consultar feriados municipais com 'feriados_por_cidade'.
Pode filtrar por UF para listar apenas municípios de um estado.
O Brasil possui mais de 5.500 municípios; use o filtro de UF para resultados mais precisos.