bcb-br-mcp 1.0.1 → 1.2.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +394 -303
- package/README.pt-BR.md +388 -0
- package/dist/index.js +101 -541
- package/dist/index.js.map +1 -1
- package/dist/tools.d.ts +280 -0
- package/dist/tools.d.ts.map +1 -0
- package/dist/tools.js +725 -0
- package/dist/tools.js.map +1 -0
- package/dist/worker.d.ts +20 -0
- package/dist/worker.d.ts.map +1 -0
- package/dist/worker.js +236 -0
- package/dist/worker.js.map +1 -0
- package/package.json +5 -2
package/dist/tools.js
ADDED
|
@@ -0,0 +1,725 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* BCB BR MCP Server — Shared Tools Logic
|
|
3
|
+
* Extracted from index.ts to be shared between stdio (index.ts) and HTTP (worker.ts) transports.
|
|
4
|
+
*
|
|
5
|
+
* Author: Sidney Bissoli
|
|
6
|
+
* License: MIT
|
|
7
|
+
*/
|
|
8
|
+
// ==================== CONSTANTS ====================
|
|
9
|
+
export const BCB_API_BASE = "https://api.bcb.gov.br/dados/serie/bcdata.sgs";
|
|
10
|
+
export const CONFIG = {
|
|
11
|
+
TIMEOUT_MS: 30000,
|
|
12
|
+
MAX_RETRIES: 3,
|
|
13
|
+
RETRY_DELAY_MS: 1000,
|
|
14
|
+
USER_AGENT: "bcb-br-mcp/1.2.0"
|
|
15
|
+
};
|
|
16
|
+
// Worker uses shorter timeout (Cloudflare has its own limits)
|
|
17
|
+
export const WORKER_CONFIG = {
|
|
18
|
+
TIMEOUT_MS: 10000,
|
|
19
|
+
MAX_RETRIES: 2,
|
|
20
|
+
RETRY_DELAY_MS: 1000,
|
|
21
|
+
USER_AGENT: "bcb-br-mcp/1.2.0"
|
|
22
|
+
};
|
|
23
|
+
// ==================== SERIES CATALOG ====================
|
|
24
|
+
export const SERIES_POPULARES = [
|
|
25
|
+
// ==================== JUROS E TAXAS ====================
|
|
26
|
+
{ codigo: 11, nome: "Taxa de juros - Selic acumulada no mês", categoria: "Juros", periodicidade: "Mensal" },
|
|
27
|
+
{ codigo: 432, nome: "Taxa de juros - Selic anualizada base 252", categoria: "Juros", periodicidade: "Diária" },
|
|
28
|
+
{ codigo: 1178, nome: "Taxa de juros - Selic - Meta definida pelo Copom", categoria: "Juros", periodicidade: "Diária" },
|
|
29
|
+
{ codigo: 4189, nome: "Taxa de juros - Selic acumulada no mês anualizada", categoria: "Juros", periodicidade: "Mensal" },
|
|
30
|
+
{ codigo: 4390, nome: "Taxa de juros - Selic mensal", categoria: "Juros", periodicidade: "Mensal" },
|
|
31
|
+
{ codigo: 12, nome: "Taxa de juros - CDI diária", categoria: "Juros", periodicidade: "Diária" },
|
|
32
|
+
{ codigo: 4389, nome: "Taxa de juros - CDI anualizada base 252", categoria: "Juros", periodicidade: "Diária" },
|
|
33
|
+
{ codigo: 4391, nome: "Taxa de juros - CDI acumulada no mês", categoria: "Juros", periodicidade: "Mensal" },
|
|
34
|
+
{ codigo: 4392, nome: "Taxa de juros - CDI acumulada no mês anualizada", categoria: "Juros", periodicidade: "Mensal" },
|
|
35
|
+
{ codigo: 226, nome: "Taxa Referencial (TR) - diária", categoria: "Juros", periodicidade: "Diária" },
|
|
36
|
+
{ codigo: 7811, nome: "Taxa Referencial (TR) - mensal", categoria: "Juros", periodicidade: "Mensal" },
|
|
37
|
+
{ codigo: 7812, nome: "Taxa Referencial (TR) - anualizada", categoria: "Juros", periodicidade: "Mensal" },
|
|
38
|
+
{ codigo: 256, nome: "Taxa de Juros de Longo Prazo (TJLP)", categoria: "Juros", periodicidade: "Mensal" },
|
|
39
|
+
{ codigo: 253, nome: "Taxa de juros - CDB pré-fixado - 30 dias", categoria: "Juros", periodicidade: "Diária" },
|
|
40
|
+
{ codigo: 14, nome: "Taxa de juros - Poupança", categoria: "Juros", periodicidade: "Mensal" },
|
|
41
|
+
// ==================== INFLAÇÃO ====================
|
|
42
|
+
{ codigo: 433, nome: "IPCA - Variação mensal", categoria: "Inflação", periodicidade: "Mensal" },
|
|
43
|
+
{ codigo: 13522, nome: "IPCA - Variação acumulada em 12 meses", categoria: "Inflação", periodicidade: "Mensal" },
|
|
44
|
+
{ codigo: 7478, nome: "IPCA-15 - Variação mensal", categoria: "Inflação", periodicidade: "Mensal" },
|
|
45
|
+
{ codigo: 7479, nome: "IPCA-15 - Variação acumulada em 12 meses", categoria: "Inflação", periodicidade: "Mensal" },
|
|
46
|
+
{ codigo: 10764, nome: "IPCA-E - Variação mensal", categoria: "Inflação", periodicidade: "Mensal" },
|
|
47
|
+
{ codigo: 16121, nome: "IPCA - Núcleo por exclusão - EX0", categoria: "Inflação", periodicidade: "Mensal" },
|
|
48
|
+
{ codigo: 16122, nome: "IPCA - Núcleo de dupla ponderação", categoria: "Inflação", periodicidade: "Mensal" },
|
|
49
|
+
{ codigo: 11426, nome: "IPCA - Núcleo de médias aparadas com suavização", categoria: "Inflação", periodicidade: "Mensal" },
|
|
50
|
+
{ codigo: 11427, nome: "IPCA - Núcleo de médias aparadas sem suavização", categoria: "Inflação", periodicidade: "Mensal" },
|
|
51
|
+
{ codigo: 10841, nome: "IPCA - Alimentação e bebidas", categoria: "Inflação", periodicidade: "Mensal" },
|
|
52
|
+
{ codigo: 10842, nome: "IPCA - Habitação", categoria: "Inflação", periodicidade: "Mensal" },
|
|
53
|
+
{ codigo: 10843, nome: "IPCA - Artigos de residência", categoria: "Inflação", periodicidade: "Mensal" },
|
|
54
|
+
{ codigo: 10844, nome: "IPCA - Serviços", categoria: "Inflação", periodicidade: "Mensal" },
|
|
55
|
+
{ codigo: 10845, nome: "IPCA - Vestuário", categoria: "Inflação", periodicidade: "Mensal" },
|
|
56
|
+
{ codigo: 10846, nome: "IPCA - Transportes", categoria: "Inflação", periodicidade: "Mensal" },
|
|
57
|
+
{ codigo: 10847, nome: "IPCA - Saúde e cuidados pessoais", categoria: "Inflação", periodicidade: "Mensal" },
|
|
58
|
+
{ codigo: 10848, nome: "IPCA - Despesas pessoais", categoria: "Inflação", periodicidade: "Mensal" },
|
|
59
|
+
{ codigo: 10849, nome: "IPCA - Educação", categoria: "Inflação", periodicidade: "Mensal" },
|
|
60
|
+
{ codigo: 10850, nome: "IPCA - Comunicação", categoria: "Inflação", periodicidade: "Mensal" },
|
|
61
|
+
{ codigo: 4449, nome: "IPCA - Preços administrados", categoria: "Inflação", periodicidade: "Mensal" },
|
|
62
|
+
{ codigo: 11428, nome: "IPCA - Preços livres", categoria: "Inflação", periodicidade: "Mensal" },
|
|
63
|
+
{ codigo: 188, nome: "INPC - Variação mensal", categoria: "Inflação", periodicidade: "Mensal" },
|
|
64
|
+
{ codigo: 13523, nome: "INPC - Variação acumulada em 12 meses", categoria: "Inflação", periodicidade: "Mensal" },
|
|
65
|
+
{ codigo: 189, nome: "IGP-M - Variação mensal", categoria: "Inflação", periodicidade: "Mensal" },
|
|
66
|
+
{ codigo: 7447, nome: "IGP-10 - Variação mensal", categoria: "Inflação", periodicidade: "Mensal" },
|
|
67
|
+
{ codigo: 7448, nome: "IGP-M - 1ª prévia", categoria: "Inflação", periodicidade: "Mensal" },
|
|
68
|
+
{ codigo: 7449, nome: "IGP-M - 2ª prévia", categoria: "Inflação", periodicidade: "Mensal" },
|
|
69
|
+
{ codigo: 190, nome: "IGP-DI - Variação mensal", categoria: "Inflação", periodicidade: "Mensal" },
|
|
70
|
+
{ codigo: 7450, nome: "IPA-M - Variação mensal", categoria: "Inflação", periodicidade: "Mensal" },
|
|
71
|
+
{ codigo: 225, nome: "IPA-DI - Geral - Variação mensal", categoria: "Inflação", periodicidade: "Mensal" },
|
|
72
|
+
{ codigo: 7459, nome: "IPA-DI - Produtos industriais", categoria: "Inflação", periodicidade: "Mensal" },
|
|
73
|
+
{ codigo: 7460, nome: "IPA-DI - Produtos agrícolas", categoria: "Inflação", periodicidade: "Mensal" },
|
|
74
|
+
{ codigo: 191, nome: "IPC-DI - Variação mensal", categoria: "Inflação", periodicidade: "Mensal" },
|
|
75
|
+
{ codigo: 193, nome: "IPC-Fipe - Variação mensal", categoria: "Inflação", periodicidade: "Mensal" },
|
|
76
|
+
{ codigo: 17679, nome: "IPC-3i - Variação mensal", categoria: "Inflação", periodicidade: "Mensal" },
|
|
77
|
+
{ codigo: 17680, nome: "IPC-C1 - Variação mensal", categoria: "Inflação", periodicidade: "Mensal" },
|
|
78
|
+
// ==================== CÂMBIO ====================
|
|
79
|
+
{ codigo: 1, nome: "Taxa de câmbio - Livre - Dólar americano (venda)", categoria: "Câmbio", periodicidade: "Diária" },
|
|
80
|
+
{ codigo: 10813, nome: "Taxa de câmbio - Livre - Dólar americano (compra)", categoria: "Câmbio", periodicidade: "Diária" },
|
|
81
|
+
{ codigo: 3698, nome: "Taxa de câmbio - PTAX - Dólar americano (venda)", categoria: "Câmbio", periodicidade: "Diária" },
|
|
82
|
+
{ codigo: 3697, nome: "Taxa de câmbio - PTAX - Dólar americano (compra)", categoria: "Câmbio", periodicidade: "Diária" },
|
|
83
|
+
{ codigo: 3695, nome: "Taxa de câmbio - PTAX - Dólar americano (média)", categoria: "Câmbio", periodicidade: "Diária" },
|
|
84
|
+
{ codigo: 21619, nome: "Taxa de câmbio - Euro (venda)", categoria: "Câmbio", periodicidade: "Diária" },
|
|
85
|
+
{ codigo: 21620, nome: "Taxa de câmbio - Euro (compra)", categoria: "Câmbio", periodicidade: "Diária" },
|
|
86
|
+
{ codigo: 21623, nome: "Taxa de câmbio - Libra Esterlina (venda)", categoria: "Câmbio", periodicidade: "Diária" },
|
|
87
|
+
{ codigo: 21624, nome: "Taxa de câmbio - Libra Esterlina (compra)", categoria: "Câmbio", periodicidade: "Diária" },
|
|
88
|
+
{ codigo: 21621, nome: "Taxa de câmbio - Iene (venda)", categoria: "Câmbio", periodicidade: "Diária" },
|
|
89
|
+
{ codigo: 21622, nome: "Taxa de câmbio - Iene (compra)", categoria: "Câmbio", periodicidade: "Diária" },
|
|
90
|
+
{ codigo: 21625, nome: "Taxa de câmbio - Franco Suíço (venda)", categoria: "Câmbio", periodicidade: "Diária" },
|
|
91
|
+
{ codigo: 21626, nome: "Taxa de câmbio - Franco Suíço (compra)", categoria: "Câmbio", periodicidade: "Diária" },
|
|
92
|
+
{ codigo: 21637, nome: "Taxa de câmbio - Peso Argentino (venda)", categoria: "Câmbio", periodicidade: "Diária" },
|
|
93
|
+
{ codigo: 21638, nome: "Taxa de câmbio - Peso Argentino (compra)", categoria: "Câmbio", periodicidade: "Diária" },
|
|
94
|
+
{ codigo: 21639, nome: "Taxa de câmbio - Yuan Chinês (venda)", categoria: "Câmbio", periodicidade: "Diária" },
|
|
95
|
+
{ codigo: 21640, nome: "Taxa de câmbio - Yuan Chinês (compra)", categoria: "Câmbio", periodicidade: "Diária" },
|
|
96
|
+
// ==================== PIB E ATIVIDADE ECONÔMICA ====================
|
|
97
|
+
{ codigo: 4380, nome: "PIB mensal - Valores correntes (R$ milhões)", categoria: "Atividade Econômica", periodicidade: "Mensal" },
|
|
98
|
+
{ codigo: 4381, nome: "PIB acumulado no ano - Valores correntes (R$ milhões)", categoria: "Atividade Econômica", periodicidade: "Mensal" },
|
|
99
|
+
{ codigo: 4382, nome: "PIB acumulado dos últimos 12 meses - Valores correntes (R$ milhões)", categoria: "Atividade Econômica", periodicidade: "Mensal" },
|
|
100
|
+
{ codigo: 4385, nome: "PIB mensal em US$ (milhões)", categoria: "Atividade Econômica", periodicidade: "Mensal" },
|
|
101
|
+
{ codigo: 4386, nome: "PIB acumulado no ano em US$ (milhões)", categoria: "Atividade Econômica", periodicidade: "Mensal" },
|
|
102
|
+
{ codigo: 7324, nome: "PIB anual em US$ (milhões)", categoria: "Atividade Econômica", periodicidade: "Anual" },
|
|
103
|
+
{ codigo: 24363, nome: "IBC-Br - Índice de Atividade Econômica (sem ajuste)", categoria: "Atividade Econômica", periodicidade: "Mensal" },
|
|
104
|
+
{ codigo: 24364, nome: "IBC-Br - Índice de Atividade Econômica (com ajuste sazonal)", categoria: "Atividade Econômica", periodicidade: "Mensal" },
|
|
105
|
+
{ codigo: 29601, nome: "IBC-Br - Agropecuária (sem ajuste)", categoria: "Atividade Econômica", periodicidade: "Mensal" },
|
|
106
|
+
{ codigo: 29602, nome: "IBC-Br - Agropecuária (com ajuste sazonal)", categoria: "Atividade Econômica", periodicidade: "Mensal" },
|
|
107
|
+
{ codigo: 29603, nome: "IBC-Br - Indústria (sem ajuste)", categoria: "Atividade Econômica", periodicidade: "Mensal" },
|
|
108
|
+
{ codigo: 29604, nome: "IBC-Br - Indústria (com ajuste sazonal)", categoria: "Atividade Econômica", periodicidade: "Mensal" },
|
|
109
|
+
{ codigo: 29605, nome: "IBC-Br - Serviços (sem ajuste)", categoria: "Atividade Econômica", periodicidade: "Mensal" },
|
|
110
|
+
{ codigo: 29606, nome: "IBC-Br - Serviços (com ajuste sazonal)", categoria: "Atividade Econômica", periodicidade: "Mensal" },
|
|
111
|
+
{ codigo: 22099, nome: "PIB trimestral - Taxa de variação (%)", categoria: "Atividade Econômica", periodicidade: "Trimestral" },
|
|
112
|
+
{ codigo: 22103, nome: "Exportação de bens e serviços - Trimestral", categoria: "Atividade Econômica", periodicidade: "Trimestral" },
|
|
113
|
+
{ codigo: 22104, nome: "Importação de bens e serviços - Trimestral", categoria: "Atividade Econômica", periodicidade: "Trimestral" },
|
|
114
|
+
{ codigo: 22109, nome: "Consumo das famílias - Trimestral", categoria: "Atividade Econômica", periodicidade: "Trimestral" },
|
|
115
|
+
{ codigo: 22110, nome: "Consumo do governo - Trimestral", categoria: "Atividade Econômica", periodicidade: "Trimestral" },
|
|
116
|
+
{ codigo: 22111, nome: "Formação bruta de capital fixo - Trimestral", categoria: "Atividade Econômica", periodicidade: "Trimestral" },
|
|
117
|
+
{ codigo: 21859, nome: "Produção industrial - Geral - Variação mensal", categoria: "Atividade Econômica", periodicidade: "Mensal" },
|
|
118
|
+
{ codigo: 21860, nome: "Produção industrial - Geral - Variação acum. 12 meses", categoria: "Atividade Econômica", periodicidade: "Mensal" },
|
|
119
|
+
{ codigo: 21862, nome: "Utilização da capacidade instalada - Indústria", categoria: "Atividade Econômica", periodicidade: "Mensal" },
|
|
120
|
+
// ==================== EMPREGO ====================
|
|
121
|
+
{ codigo: 24369, nome: "Taxa de desocupação - PNAD Contínua", categoria: "Emprego", periodicidade: "Mensal" },
|
|
122
|
+
{ codigo: 28763, nome: "Taxa de desocupação - PNAD Contínua - Trimestral", categoria: "Emprego", periodicidade: "Trimestral" },
|
|
123
|
+
{ codigo: 24370, nome: "Taxa de participação na força de trabalho", categoria: "Emprego", periodicidade: "Mensal" },
|
|
124
|
+
{ codigo: 24380, nome: "Rendimento médio real habitual - Todos os trabalhos", categoria: "Emprego", periodicidade: "Mensal" },
|
|
125
|
+
{ codigo: 24381, nome: "Massa de rendimento real habitual", categoria: "Emprego", periodicidade: "Mensal" },
|
|
126
|
+
{ codigo: 28785, nome: "Pessoal ocupado - Total (milhões)", categoria: "Emprego", periodicidade: "Mensal" },
|
|
127
|
+
{ codigo: 28561, nome: "CAGED - Saldo de empregos formais", categoria: "Emprego", periodicidade: "Mensal" },
|
|
128
|
+
// ==================== DÍVIDA PÚBLICA E FISCAL ====================
|
|
129
|
+
{ codigo: 4503, nome: "Dívida líquida do setor público (% PIB)", categoria: "Fiscal", periodicidade: "Mensal" },
|
|
130
|
+
{ codigo: 4513, nome: "Dívida bruta do governo geral (% PIB)", categoria: "Fiscal", periodicidade: "Mensal" },
|
|
131
|
+
{ codigo: 4505, nome: "Dívida líquida do governo federal (% PIB)", categoria: "Fiscal", periodicidade: "Mensal" },
|
|
132
|
+
{ codigo: 4536, nome: "Necessidade de financiamento - Setor público (% PIB)", categoria: "Fiscal", periodicidade: "Mensal" },
|
|
133
|
+
{ codigo: 4537, nome: "Resultado primário - Setor público (% PIB)", categoria: "Fiscal", periodicidade: "Mensal" },
|
|
134
|
+
{ codigo: 4538, nome: "Juros nominais - Setor público (% PIB)", categoria: "Fiscal", periodicidade: "Mensal" },
|
|
135
|
+
{ codigo: 4539, nome: "Resultado nominal - Setor público (% PIB)", categoria: "Fiscal", periodicidade: "Mensal" },
|
|
136
|
+
{ codigo: 5364, nome: "Receita total do governo central", categoria: "Fiscal", periodicidade: "Mensal" },
|
|
137
|
+
{ codigo: 5793, nome: "Despesa total do governo central", categoria: "Fiscal", periodicidade: "Mensal" },
|
|
138
|
+
// ==================== SETOR EXTERNO ====================
|
|
139
|
+
{ codigo: 3546, nome: "Reservas internacionais - Conceito liquidez - Total", categoria: "Setor Externo", periodicidade: "Diária" },
|
|
140
|
+
{ codigo: 13621, nome: "Reservas internacionais - Conceito liquidez - Mensal", categoria: "Setor Externo", periodicidade: "Mensal" },
|
|
141
|
+
{ codigo: 22707, nome: "Balança comercial - Saldo mensal (US$ milhões)", categoria: "Setor Externo", periodicidade: "Mensal" },
|
|
142
|
+
{ codigo: 22708, nome: "Exportação de bens - Mensal (US$ milhões)", categoria: "Setor Externo", periodicidade: "Mensal" },
|
|
143
|
+
{ codigo: 22709, nome: "Importação de bens - Mensal (US$ milhões)", categoria: "Setor Externo", periodicidade: "Mensal" },
|
|
144
|
+
{ codigo: 22714, nome: "Balança comercial - Saldo acumulado 12 meses (US$ milhões)", categoria: "Setor Externo", periodicidade: "Mensal" },
|
|
145
|
+
{ codigo: 22701, nome: "Transações correntes - Saldo mensal (US$ milhões)", categoria: "Setor Externo", periodicidade: "Mensal" },
|
|
146
|
+
{ codigo: 22704, nome: "Transações correntes - Saldo acumulado 12 meses (% PIB)", categoria: "Setor Externo", periodicidade: "Mensal" },
|
|
147
|
+
{ codigo: 22715, nome: "Serviços - Saldo mensal (US$ milhões)", categoria: "Setor Externo", periodicidade: "Mensal" },
|
|
148
|
+
{ codigo: 22716, nome: "Renda primária - Saldo mensal (US$ milhões)", categoria: "Setor Externo", periodicidade: "Mensal" },
|
|
149
|
+
{ codigo: 22846, nome: "Investimento direto no país - Mensal (US$ milhões)", categoria: "Setor Externo", periodicidade: "Mensal" },
|
|
150
|
+
{ codigo: 22885, nome: "Investimento em carteira - Mensal (US$ milhões)", categoria: "Setor Externo", periodicidade: "Mensal" },
|
|
151
|
+
{ codigo: 13690, nome: "Dívida externa total (US$ milhões)", categoria: "Setor Externo", periodicidade: "Mensal" },
|
|
152
|
+
// ==================== CRÉDITO ====================
|
|
153
|
+
{ codigo: 20539, nome: "Saldo da carteira de crédito - Total", categoria: "Crédito", periodicidade: "Mensal" },
|
|
154
|
+
{ codigo: 20540, nome: "Saldo da carteira de crédito - Pessoas físicas", categoria: "Crédito", periodicidade: "Mensal" },
|
|
155
|
+
{ codigo: 20541, nome: "Saldo da carteira de crédito - Pessoas jurídicas", categoria: "Crédito", periodicidade: "Mensal" },
|
|
156
|
+
{ codigo: 20542, nome: "Saldo de crédito com recursos livres - Total", categoria: "Crédito", periodicidade: "Mensal" },
|
|
157
|
+
{ codigo: 20570, nome: "Saldo de crédito com recursos livres - Pessoas físicas", categoria: "Crédito", periodicidade: "Mensal" },
|
|
158
|
+
{ codigo: 20592, nome: "Saldo de crédito com recursos livres - Pessoas jurídicas", categoria: "Crédito", periodicidade: "Mensal" },
|
|
159
|
+
{ codigo: 20615, nome: "Saldo de crédito com recursos direcionados - Total", categoria: "Crédito", periodicidade: "Mensal" },
|
|
160
|
+
{ codigo: 20631, nome: "Concessões de crédito - Total", categoria: "Crédito", periodicidade: "Mensal" },
|
|
161
|
+
{ codigo: 20665, nome: "Concessões de crédito - Cheque especial - Pessoas físicas", categoria: "Crédito", periodicidade: "Mensal" },
|
|
162
|
+
{ codigo: 20714, nome: "Taxa média de juros - Crédito total", categoria: "Crédito", periodicidade: "Mensal" },
|
|
163
|
+
{ codigo: 20716, nome: "Taxa média de juros - Crédito pessoas físicas", categoria: "Crédito", periodicidade: "Mensal" },
|
|
164
|
+
{ codigo: 20740, nome: "Taxa média de juros - Crédito recursos livres - PF", categoria: "Crédito", periodicidade: "Mensal" },
|
|
165
|
+
{ codigo: 20749, nome: "Taxa média de juros - Aquisição de veículos - PF", categoria: "Crédito", periodicidade: "Mensal" },
|
|
166
|
+
{ codigo: 20772, nome: "Taxa média de juros - Financiamento imobiliário - PF", categoria: "Crédito", periodicidade: "Mensal" },
|
|
167
|
+
{ codigo: 25497, nome: "Taxa média de juros - Financiamento imobiliário taxas de mercado", categoria: "Crédito", periodicidade: "Mensal" },
|
|
168
|
+
{ codigo: 20783, nome: "Spread médio - Crédito total", categoria: "Crédito", periodicidade: "Mensal" },
|
|
169
|
+
{ codigo: 20785, nome: "Spread médio - Crédito pessoas físicas", categoria: "Crédito", periodicidade: "Mensal" },
|
|
170
|
+
{ codigo: 20786, nome: "Spread médio - Crédito pessoas jurídicas", categoria: "Crédito", periodicidade: "Mensal" },
|
|
171
|
+
{ codigo: 21082, nome: "Inadimplência - Crédito total", categoria: "Crédito", periodicidade: "Mensal" },
|
|
172
|
+
{ codigo: 21084, nome: "Inadimplência - Crédito pessoas físicas", categoria: "Crédito", periodicidade: "Mensal" },
|
|
173
|
+
{ codigo: 21085, nome: "Inadimplência - Crédito pessoas jurídicas", categoria: "Crédito", periodicidade: "Mensal" },
|
|
174
|
+
{ codigo: 21128, nome: "Inadimplência - Cartão de crédito parcelado - PF", categoria: "Crédito", periodicidade: "Mensal" },
|
|
175
|
+
{ codigo: 21129, nome: "Inadimplência - Cartão de crédito total - PF", categoria: "Crédito", periodicidade: "Mensal" },
|
|
176
|
+
{ codigo: 13685, nome: "Inadimplência - Instituições financeiras privadas", categoria: "Crédito", periodicidade: "Mensal" },
|
|
177
|
+
// ==================== AGREGADOS MONETÁRIOS ====================
|
|
178
|
+
{ codigo: 1788, nome: "Base monetária - Saldo fim de período", categoria: "Agregados Monetários", periodicidade: "Mensal" },
|
|
179
|
+
{ codigo: 1833, nome: "Base monetária ampliada - M4 - Saldo fim de período", categoria: "Agregados Monetários", periodicidade: "Mensal" },
|
|
180
|
+
{ codigo: 27788, nome: "Meios de pagamento - M1 - Saldo fim de período", categoria: "Agregados Monetários", periodicidade: "Mensal" },
|
|
181
|
+
{ codigo: 27789, nome: "Meios de pagamento - M2 - Saldo fim de período", categoria: "Agregados Monetários", periodicidade: "Mensal" },
|
|
182
|
+
{ codigo: 27790, nome: "Meios de pagamento - M3 - Saldo fim de período", categoria: "Agregados Monetários", periodicidade: "Mensal" },
|
|
183
|
+
{ codigo: 27791, nome: "Meios de pagamento - M4 - Saldo fim de período", categoria: "Agregados Monetários", periodicidade: "Mensal" },
|
|
184
|
+
{ codigo: 27815, nome: "Multiplicador monetário - Base para M4", categoria: "Agregados Monetários", periodicidade: "Mensal" },
|
|
185
|
+
{ codigo: 7530, nome: "Multiplicador monetário - Média do mês", categoria: "Agregados Monetários", periodicidade: "Mensal" },
|
|
186
|
+
// ==================== POUPANÇA ====================
|
|
187
|
+
{ codigo: 25, nome: "Poupança - Rendimento no mês de referência", categoria: "Poupança", periodicidade: "Mensal" },
|
|
188
|
+
{ codigo: 195, nome: "Poupança - Saldo total", categoria: "Poupança", periodicidade: "Mensal" },
|
|
189
|
+
{ codigo: 7165, nome: "Poupança - Captação líquida", categoria: "Poupança", periodicidade: "Mensal" },
|
|
190
|
+
{ codigo: 7166, nome: "Poupança - Depósitos", categoria: "Poupança", periodicidade: "Mensal" },
|
|
191
|
+
{ codigo: 7167, nome: "Poupança - Retiradas", categoria: "Poupança", periodicidade: "Mensal" },
|
|
192
|
+
// ==================== ÍNDICES DE MERCADO ====================
|
|
193
|
+
{ codigo: 12466, nome: "IMA-B - Índice de Mercado ANBIMA (Base)", categoria: "Índices de Mercado", periodicidade: "Diária" },
|
|
194
|
+
{ codigo: 12467, nome: "IMA-B5 - Índice de Mercado ANBIMA (até 5 anos)", categoria: "Índices de Mercado", periodicidade: "Diária" },
|
|
195
|
+
{ codigo: 12468, nome: "IMA-B5+ - Índice de Mercado ANBIMA (acima 5 anos)", categoria: "Índices de Mercado", periodicidade: "Diária" },
|
|
196
|
+
{ codigo: 7832, nome: "Ibovespa - Índice mensal", categoria: "Índices de Mercado", periodicidade: "Mensal" },
|
|
197
|
+
// ==================== EXPECTATIVAS (Focus) ====================
|
|
198
|
+
{ codigo: 29033, nome: "Expectativa IPCA - Mediana - Ano corrente", categoria: "Expectativas", periodicidade: "Semanal" },
|
|
199
|
+
{ codigo: 29034, nome: "Expectativa IPCA - Mediana - Próximo ano", categoria: "Expectativas", periodicidade: "Semanal" },
|
|
200
|
+
{ codigo: 29035, nome: "Expectativa Selic - Mediana - Ano corrente", categoria: "Expectativas", periodicidade: "Semanal" },
|
|
201
|
+
{ codigo: 29036, nome: "Expectativa Selic - Mediana - Próximo ano", categoria: "Expectativas", periodicidade: "Semanal" },
|
|
202
|
+
{ codigo: 29037, nome: "Expectativa PIB - Mediana - Ano corrente", categoria: "Expectativas", periodicidade: "Semanal" },
|
|
203
|
+
{ codigo: 29038, nome: "Expectativa PIB - Mediana - Próximo ano", categoria: "Expectativas", periodicidade: "Semanal" },
|
|
204
|
+
{ codigo: 29039, nome: "Expectativa Câmbio - Mediana - Ano corrente", categoria: "Expectativas", periodicidade: "Semanal" },
|
|
205
|
+
{ codigo: 29040, nome: "Expectativa Câmbio - Mediana - Próximo ano", categoria: "Expectativas", periodicidade: "Semanal" }
|
|
206
|
+
];
|
|
207
|
+
// ==================== UTILITY FUNCTIONS ====================
|
|
208
|
+
export function normalizeString(str) {
|
|
209
|
+
return str
|
|
210
|
+
.toLowerCase()
|
|
211
|
+
.normalize("NFD")
|
|
212
|
+
.replace(/[\u0300-\u036f]/g, "");
|
|
213
|
+
}
|
|
214
|
+
export function formatDateForApi(dateStr) {
|
|
215
|
+
if (dateStr.includes("-")) {
|
|
216
|
+
const [year, month, day] = dateStr.split("-");
|
|
217
|
+
return `${day}/${month}/${year}`;
|
|
218
|
+
}
|
|
219
|
+
return dateStr;
|
|
220
|
+
}
|
|
221
|
+
export function sleep(ms) {
|
|
222
|
+
return new Promise(resolve => setTimeout(resolve, ms));
|
|
223
|
+
}
|
|
224
|
+
export async function fetchWithTimeout(url, timeoutMs) {
|
|
225
|
+
const controller = new AbortController();
|
|
226
|
+
const timeoutId = setTimeout(() => controller.abort(), timeoutMs);
|
|
227
|
+
try {
|
|
228
|
+
const response = await fetch(url, {
|
|
229
|
+
signal: controller.signal,
|
|
230
|
+
headers: {
|
|
231
|
+
"Accept": "application/json",
|
|
232
|
+
"User-Agent": CONFIG.USER_AGENT
|
|
233
|
+
}
|
|
234
|
+
});
|
|
235
|
+
return response;
|
|
236
|
+
}
|
|
237
|
+
finally {
|
|
238
|
+
clearTimeout(timeoutId);
|
|
239
|
+
}
|
|
240
|
+
}
|
|
241
|
+
export async function fetchBcbApi(url, timeoutMs = CONFIG.TIMEOUT_MS, maxRetries = CONFIG.MAX_RETRIES) {
|
|
242
|
+
let lastError = null;
|
|
243
|
+
for (let attempt = 1; attempt <= maxRetries; attempt++) {
|
|
244
|
+
try {
|
|
245
|
+
const response = await fetchWithTimeout(url, timeoutMs);
|
|
246
|
+
if (!response.ok) {
|
|
247
|
+
if (response.status === 404) {
|
|
248
|
+
throw new Error(`Série não encontrada ou sem dados para o período solicitado`);
|
|
249
|
+
}
|
|
250
|
+
throw new Error(`Erro na API do BCB: ${response.status} ${response.statusText}`);
|
|
251
|
+
}
|
|
252
|
+
return response.json();
|
|
253
|
+
}
|
|
254
|
+
catch (error) {
|
|
255
|
+
lastError = error instanceof Error ? error : new Error(String(error));
|
|
256
|
+
if (lastError.message.includes("não encontrada")) {
|
|
257
|
+
throw lastError;
|
|
258
|
+
}
|
|
259
|
+
const isTimeout = lastError.name === "AbortError" ||
|
|
260
|
+
lastError.message.includes("aborted") ||
|
|
261
|
+
lastError.message.includes("timeout");
|
|
262
|
+
if (attempt < maxRetries) {
|
|
263
|
+
const delayMs = CONFIG.RETRY_DELAY_MS * Math.pow(2, attempt - 1);
|
|
264
|
+
const reason = isTimeout ? "timeout" : "erro";
|
|
265
|
+
console.error(`Tentativa ${attempt}/${maxRetries} falhou (${reason}). Aguardando ${delayMs}ms...`);
|
|
266
|
+
await sleep(delayMs);
|
|
267
|
+
}
|
|
268
|
+
}
|
|
269
|
+
}
|
|
270
|
+
throw new Error(`Falha após ${maxRetries} tentativas: ${lastError?.message || "Erro desconhecido"}`);
|
|
271
|
+
}
|
|
272
|
+
export function calculateVariation(valorInicial, valorFinal) {
|
|
273
|
+
if (valorInicial === 0)
|
|
274
|
+
return 0;
|
|
275
|
+
return ((valorFinal - valorInicial) / Math.abs(valorInicial)) * 100;
|
|
276
|
+
}
|
|
277
|
+
// ==================== TOOL HANDLERS ====================
|
|
278
|
+
export async function handleSerieValores(args, timeoutMs, maxRetries) {
|
|
279
|
+
try {
|
|
280
|
+
let url = `${BCB_API_BASE}.${args.codigo}/dados?formato=json`;
|
|
281
|
+
if (args.dataInicial)
|
|
282
|
+
url += `&dataInicial=${formatDateForApi(args.dataInicial)}`;
|
|
283
|
+
if (args.dataFinal)
|
|
284
|
+
url += `&dataFinal=${formatDateForApi(args.dataFinal)}`;
|
|
285
|
+
const data = await fetchBcbApi(url, timeoutMs, maxRetries);
|
|
286
|
+
if (!Array.isArray(data) || data.length === 0) {
|
|
287
|
+
return {
|
|
288
|
+
content: [{ type: "text", text: `Nenhum dado encontrado para a série ${args.codigo} no período solicitado.` }]
|
|
289
|
+
};
|
|
290
|
+
}
|
|
291
|
+
const serieInfo = SERIES_POPULARES.find(s => s.codigo === args.codigo);
|
|
292
|
+
const result = {
|
|
293
|
+
serie: {
|
|
294
|
+
codigo: args.codigo,
|
|
295
|
+
nome: serieInfo?.nome || `Série ${args.codigo}`,
|
|
296
|
+
categoria: serieInfo?.categoria || "Desconhecida",
|
|
297
|
+
periodicidade: serieInfo?.periodicidade || "Desconhecida"
|
|
298
|
+
},
|
|
299
|
+
totalRegistros: data.length,
|
|
300
|
+
periodoInicial: data[0].data,
|
|
301
|
+
periodoFinal: data[data.length - 1].data,
|
|
302
|
+
dados: data.map(d => ({ data: d.data, valor: parseFloat(d.valor) }))
|
|
303
|
+
};
|
|
304
|
+
return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
|
|
305
|
+
}
|
|
306
|
+
catch (error) {
|
|
307
|
+
return {
|
|
308
|
+
content: [{ type: "text", text: `Erro ao consultar série ${args.codigo}: ${error instanceof Error ? error.message : String(error)}` }],
|
|
309
|
+
isError: true
|
|
310
|
+
};
|
|
311
|
+
}
|
|
312
|
+
}
|
|
313
|
+
export async function handleSerieUltimos(args, timeoutMs, maxRetries) {
|
|
314
|
+
try {
|
|
315
|
+
const url = `${BCB_API_BASE}.${args.codigo}/dados/ultimos/${args.quantidade}?formato=json`;
|
|
316
|
+
const data = await fetchBcbApi(url, timeoutMs, maxRetries);
|
|
317
|
+
if (!Array.isArray(data) || data.length === 0) {
|
|
318
|
+
return {
|
|
319
|
+
content: [{ type: "text", text: `Nenhum dado encontrado para a série ${args.codigo}.` }]
|
|
320
|
+
};
|
|
321
|
+
}
|
|
322
|
+
const serieInfo = SERIES_POPULARES.find(s => s.codigo === args.codigo);
|
|
323
|
+
const result = {
|
|
324
|
+
serie: {
|
|
325
|
+
codigo: args.codigo,
|
|
326
|
+
nome: serieInfo?.nome || `Série ${args.codigo}`,
|
|
327
|
+
categoria: serieInfo?.categoria || "Desconhecida",
|
|
328
|
+
periodicidade: serieInfo?.periodicidade || "Desconhecida"
|
|
329
|
+
},
|
|
330
|
+
totalRegistros: data.length,
|
|
331
|
+
dados: data.map(d => ({ data: d.data, valor: parseFloat(d.valor) }))
|
|
332
|
+
};
|
|
333
|
+
return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
|
|
334
|
+
}
|
|
335
|
+
catch (error) {
|
|
336
|
+
return {
|
|
337
|
+
content: [{ type: "text", text: `Erro ao consultar últimos valores da série ${args.codigo}: ${error instanceof Error ? error.message : String(error)}` }],
|
|
338
|
+
isError: true
|
|
339
|
+
};
|
|
340
|
+
}
|
|
341
|
+
}
|
|
342
|
+
export async function handleSerieMetadados(args, timeoutMs, maxRetries) {
|
|
343
|
+
try {
|
|
344
|
+
const metadataUrl = `https://api.bcb.gov.br/dados/serie/bcdata.sgs.${args.codigo}/metadados?formato=json`;
|
|
345
|
+
try {
|
|
346
|
+
const metadata = await fetchBcbApi(metadataUrl, timeoutMs, maxRetries);
|
|
347
|
+
const serieInfo = SERIES_POPULARES.find(s => s.codigo === args.codigo);
|
|
348
|
+
const result = {
|
|
349
|
+
codigo: metadata.codigo || args.codigo,
|
|
350
|
+
nome: metadata.nome || serieInfo?.nome || `Série ${args.codigo}`,
|
|
351
|
+
unidade: metadata.unidade || "Não informada",
|
|
352
|
+
periodicidade: metadata.periodicidade || serieInfo?.periodicidade || "Não informada",
|
|
353
|
+
fonte: metadata.fonte || "Banco Central do Brasil",
|
|
354
|
+
categoria: serieInfo?.categoria || "Não categorizada",
|
|
355
|
+
especial: metadata.especial || false,
|
|
356
|
+
urlConsulta: `${BCB_API_BASE}.${args.codigo}/dados?formato=json`,
|
|
357
|
+
urlUltimos10: `${BCB_API_BASE}.${args.codigo}/dados/ultimos/10?formato=json`
|
|
358
|
+
};
|
|
359
|
+
return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
|
|
360
|
+
}
|
|
361
|
+
catch {
|
|
362
|
+
const serieInfo = SERIES_POPULARES.find(s => s.codigo === args.codigo);
|
|
363
|
+
if (serieInfo) {
|
|
364
|
+
const result = {
|
|
365
|
+
codigo: args.codigo,
|
|
366
|
+
nome: serieInfo.nome,
|
|
367
|
+
periodicidade: serieInfo.periodicidade,
|
|
368
|
+
categoria: serieInfo.categoria,
|
|
369
|
+
fonte: "Banco Central do Brasil",
|
|
370
|
+
urlConsulta: `${BCB_API_BASE}.${args.codigo}/dados?formato=json`,
|
|
371
|
+
urlUltimos10: `${BCB_API_BASE}.${args.codigo}/dados/ultimos/10?formato=json`,
|
|
372
|
+
observacao: "Metadados obtidos do catálogo interno"
|
|
373
|
+
};
|
|
374
|
+
return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
|
|
375
|
+
}
|
|
376
|
+
const url = `${BCB_API_BASE}.${args.codigo}/dados/ultimos/1?formato=json`;
|
|
377
|
+
const data = await fetchBcbApi(url, timeoutMs, maxRetries);
|
|
378
|
+
if (Array.isArray(data) && data.length > 0) {
|
|
379
|
+
const result = {
|
|
380
|
+
codigo: args.codigo,
|
|
381
|
+
nome: `Série ${args.codigo}`,
|
|
382
|
+
ultimoValor: { data: data[0].data, valor: parseFloat(data[0].valor) },
|
|
383
|
+
fonte: "Banco Central do Brasil",
|
|
384
|
+
urlConsulta: `${BCB_API_BASE}.${args.codigo}/dados?formato=json`,
|
|
385
|
+
observacao: "Série encontrada, mas metadados detalhados não disponíveis"
|
|
386
|
+
};
|
|
387
|
+
return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
|
|
388
|
+
}
|
|
389
|
+
throw new Error("Série não encontrada");
|
|
390
|
+
}
|
|
391
|
+
}
|
|
392
|
+
catch (error) {
|
|
393
|
+
return {
|
|
394
|
+
content: [{ type: "text", text: `Erro ao consultar metadados da série ${args.codigo}: ${error instanceof Error ? error.message : String(error)}` }],
|
|
395
|
+
isError: true
|
|
396
|
+
};
|
|
397
|
+
}
|
|
398
|
+
}
|
|
399
|
+
export async function handleSeriesPopulares(args) {
|
|
400
|
+
try {
|
|
401
|
+
let series = SERIES_POPULARES;
|
|
402
|
+
if (args.categoria) {
|
|
403
|
+
const categoriaNorm = normalizeString(args.categoria);
|
|
404
|
+
series = series.filter(s => normalizeString(s.categoria).includes(categoriaNorm));
|
|
405
|
+
}
|
|
406
|
+
const porCategoria = {};
|
|
407
|
+
for (const serie of series) {
|
|
408
|
+
if (!porCategoria[serie.categoria])
|
|
409
|
+
porCategoria[serie.categoria] = [];
|
|
410
|
+
porCategoria[serie.categoria].push(serie);
|
|
411
|
+
}
|
|
412
|
+
const result = {
|
|
413
|
+
totalSeries: series.length,
|
|
414
|
+
categorias: Object.keys(porCategoria).length,
|
|
415
|
+
series: args.categoria ? series : porCategoria,
|
|
416
|
+
observacao: "Use bcb_serie_valores ou bcb_serie_ultimos com o código para consultar os dados"
|
|
417
|
+
};
|
|
418
|
+
return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
|
|
419
|
+
}
|
|
420
|
+
catch (error) {
|
|
421
|
+
return {
|
|
422
|
+
content: [{ type: "text", text: `Erro ao listar séries: ${error instanceof Error ? error.message : String(error)}` }],
|
|
423
|
+
isError: true
|
|
424
|
+
};
|
|
425
|
+
}
|
|
426
|
+
}
|
|
427
|
+
export async function handleBuscarSerie(args) {
|
|
428
|
+
try {
|
|
429
|
+
const termoNorm = normalizeString(args.termo);
|
|
430
|
+
const encontradas = SERIES_POPULARES.filter(s => normalizeString(s.nome).includes(termoNorm) ||
|
|
431
|
+
normalizeString(s.categoria).includes(termoNorm));
|
|
432
|
+
if (encontradas.length === 0) {
|
|
433
|
+
return {
|
|
434
|
+
content: [{
|
|
435
|
+
type: "text",
|
|
436
|
+
text: JSON.stringify({
|
|
437
|
+
termo: args.termo,
|
|
438
|
+
totalEncontradas: 0,
|
|
439
|
+
mensagem: "Nenhuma série encontrada no catálogo interno. Use o portal SGS do BCB para buscar outras séries: https://www3.bcb.gov.br/sgspub/",
|
|
440
|
+
sugestao: "Tente termos como: selic, ipca, dolar, cambio, pib, inflacao, credito, emprego"
|
|
441
|
+
}, null, 2)
|
|
442
|
+
}]
|
|
443
|
+
};
|
|
444
|
+
}
|
|
445
|
+
const result = { termo: args.termo, totalEncontradas: encontradas.length, series: encontradas };
|
|
446
|
+
return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
|
|
447
|
+
}
|
|
448
|
+
catch (error) {
|
|
449
|
+
return {
|
|
450
|
+
content: [{ type: "text", text: `Erro ao buscar séries: ${error instanceof Error ? error.message : String(error)}` }],
|
|
451
|
+
isError: true
|
|
452
|
+
};
|
|
453
|
+
}
|
|
454
|
+
}
|
|
455
|
+
export async function handleIndicadoresAtuais(_args, timeoutMs, maxRetries) {
|
|
456
|
+
try {
|
|
457
|
+
const indicadores = [
|
|
458
|
+
{ codigo: 432, nome: "Selic (a.a.)" },
|
|
459
|
+
{ codigo: 433, nome: "IPCA mensal (%)" },
|
|
460
|
+
{ codigo: 13522, nome: "IPCA 12 meses (%)" },
|
|
461
|
+
{ codigo: 3698, nome: "Dólar PTAX (venda)" },
|
|
462
|
+
{ codigo: 24364, nome: "IBC-Br" }
|
|
463
|
+
];
|
|
464
|
+
const resultados = await Promise.all(indicadores.map(async (ind) => {
|
|
465
|
+
try {
|
|
466
|
+
const url = `${BCB_API_BASE}.${ind.codigo}/dados/ultimos/1?formato=json`;
|
|
467
|
+
const data = await fetchBcbApi(url, timeoutMs, maxRetries);
|
|
468
|
+
if (Array.isArray(data) && data.length > 0) {
|
|
469
|
+
return { indicador: ind.nome, codigo: ind.codigo, data: data[0].data, valor: parseFloat(data[0].valor) };
|
|
470
|
+
}
|
|
471
|
+
return { indicador: ind.nome, codigo: ind.codigo, erro: "Sem dados disponíveis" };
|
|
472
|
+
}
|
|
473
|
+
catch (err) {
|
|
474
|
+
return { indicador: ind.nome, codigo: ind.codigo, erro: err instanceof Error ? err.message : "Erro desconhecido" };
|
|
475
|
+
}
|
|
476
|
+
}));
|
|
477
|
+
return {
|
|
478
|
+
content: [{
|
|
479
|
+
type: "text",
|
|
480
|
+
text: JSON.stringify({ consultadoEm: new Date().toISOString(), indicadores: resultados }, null, 2)
|
|
481
|
+
}]
|
|
482
|
+
};
|
|
483
|
+
}
|
|
484
|
+
catch (error) {
|
|
485
|
+
return {
|
|
486
|
+
content: [{ type: "text", text: `Erro ao consultar indicadores: ${error instanceof Error ? error.message : String(error)}` }],
|
|
487
|
+
isError: true
|
|
488
|
+
};
|
|
489
|
+
}
|
|
490
|
+
}
|
|
491
|
+
export async function handleVariacao(args, timeoutMs, maxRetries) {
|
|
492
|
+
try {
|
|
493
|
+
let data;
|
|
494
|
+
if (args.periodos && args.periodos > 1) {
|
|
495
|
+
const url = `${BCB_API_BASE}.${args.codigo}/dados/ultimos/${args.periodos}?formato=json`;
|
|
496
|
+
data = await fetchBcbApi(url, timeoutMs, maxRetries);
|
|
497
|
+
}
|
|
498
|
+
else {
|
|
499
|
+
let url = `${BCB_API_BASE}.${args.codigo}/dados?formato=json`;
|
|
500
|
+
if (args.dataInicial)
|
|
501
|
+
url += `&dataInicial=${formatDateForApi(args.dataInicial)}`;
|
|
502
|
+
if (args.dataFinal)
|
|
503
|
+
url += `&dataFinal=${formatDateForApi(args.dataFinal)}`;
|
|
504
|
+
data = await fetchBcbApi(url, timeoutMs, maxRetries);
|
|
505
|
+
}
|
|
506
|
+
if (!Array.isArray(data) || data.length < 2) {
|
|
507
|
+
return {
|
|
508
|
+
content: [{ type: "text", text: `Dados insuficientes para calcular variação. São necessários pelo menos 2 valores.` }]
|
|
509
|
+
};
|
|
510
|
+
}
|
|
511
|
+
const serieInfo = SERIES_POPULARES.find(s => s.codigo === args.codigo);
|
|
512
|
+
const valorInicial = parseFloat(data[0].valor);
|
|
513
|
+
const valorFinal = parseFloat(data[data.length - 1].valor);
|
|
514
|
+
const variacao = calculateVariation(valorInicial, valorFinal);
|
|
515
|
+
const diferencaAbsoluta = valorFinal - valorInicial;
|
|
516
|
+
const valores = data.map(d => parseFloat(d.valor));
|
|
517
|
+
const maximo = Math.max(...valores);
|
|
518
|
+
const minimo = Math.min(...valores);
|
|
519
|
+
const media = valores.reduce((a, b) => a + b, 0) / valores.length;
|
|
520
|
+
const result = {
|
|
521
|
+
serie: { codigo: args.codigo, nome: serieInfo?.nome || `Série ${args.codigo}`, categoria: serieInfo?.categoria || "Desconhecida" },
|
|
522
|
+
periodo: { dataInicial: data[0].data, dataFinal: data[data.length - 1].data, totalPeriodos: data.length },
|
|
523
|
+
analise: {
|
|
524
|
+
valorInicial, valorFinal,
|
|
525
|
+
diferencaAbsoluta: Number(diferencaAbsoluta.toFixed(4)),
|
|
526
|
+
variacaoPercentual: Number(variacao.toFixed(4)),
|
|
527
|
+
variacaoFormatada: `${variacao >= 0 ? "+" : ""}${variacao.toFixed(2)}%`
|
|
528
|
+
},
|
|
529
|
+
estatisticas: {
|
|
530
|
+
maximo: Number(maximo.toFixed(4)),
|
|
531
|
+
minimo: Number(minimo.toFixed(4)),
|
|
532
|
+
media: Number(media.toFixed(4)),
|
|
533
|
+
amplitude: Number((maximo - minimo).toFixed(4))
|
|
534
|
+
}
|
|
535
|
+
};
|
|
536
|
+
return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
|
|
537
|
+
}
|
|
538
|
+
catch (error) {
|
|
539
|
+
return {
|
|
540
|
+
content: [{ type: "text", text: `Erro ao calcular variação: ${error instanceof Error ? error.message : String(error)}` }],
|
|
541
|
+
isError: true
|
|
542
|
+
};
|
|
543
|
+
}
|
|
544
|
+
}
|
|
545
|
+
export async function handleComparar(args, timeoutMs, maxRetries) {
|
|
546
|
+
try {
|
|
547
|
+
const resultados = await Promise.all(args.codigos.map(async (codigo) => {
|
|
548
|
+
try {
|
|
549
|
+
let url = `${BCB_API_BASE}.${codigo}/dados?formato=json`;
|
|
550
|
+
url += `&dataInicial=${formatDateForApi(args.dataInicial)}`;
|
|
551
|
+
url += `&dataFinal=${formatDateForApi(args.dataFinal)}`;
|
|
552
|
+
const data = await fetchBcbApi(url, timeoutMs, maxRetries);
|
|
553
|
+
const serieInfo = SERIES_POPULARES.find(s => s.codigo === codigo);
|
|
554
|
+
if (!Array.isArray(data) || data.length === 0) {
|
|
555
|
+
return { codigo, nome: serieInfo?.nome || `Série ${codigo}`, erro: "Sem dados no período" };
|
|
556
|
+
}
|
|
557
|
+
const valores = data.map(d => parseFloat(d.valor));
|
|
558
|
+
const valorInicial = valores[0];
|
|
559
|
+
const valorFinal = valores[valores.length - 1];
|
|
560
|
+
const variacao = calculateVariation(valorInicial, valorFinal);
|
|
561
|
+
return {
|
|
562
|
+
codigo,
|
|
563
|
+
nome: serieInfo?.nome || `Série ${codigo}`,
|
|
564
|
+
categoria: serieInfo?.categoria || "Desconhecida",
|
|
565
|
+
periodicidade: serieInfo?.periodicidade || "Desconhecida",
|
|
566
|
+
totalRegistros: data.length,
|
|
567
|
+
valorInicial, valorFinal,
|
|
568
|
+
variacaoPercentual: Number(variacao.toFixed(4)),
|
|
569
|
+
variacaoFormatada: `${variacao >= 0 ? "+" : ""}${variacao.toFixed(2)}%`,
|
|
570
|
+
maximo: Math.max(...valores),
|
|
571
|
+
minimo: Math.min(...valores),
|
|
572
|
+
media: Number((valores.reduce((a, b) => a + b, 0) / valores.length).toFixed(4))
|
|
573
|
+
};
|
|
574
|
+
}
|
|
575
|
+
catch (err) {
|
|
576
|
+
const serieInfo = SERIES_POPULARES.find(s => s.codigo === codigo);
|
|
577
|
+
return { codigo, nome: serieInfo?.nome || `Série ${codigo}`, erro: err instanceof Error ? err.message : "Erro desconhecido" };
|
|
578
|
+
}
|
|
579
|
+
}));
|
|
580
|
+
const seriesComDados = resultados.filter(r => !("erro" in r));
|
|
581
|
+
const seriesComErro = resultados.filter(r => "erro" in r);
|
|
582
|
+
const seriesOrdenadas = [...seriesComDados].sort((a, b) => {
|
|
583
|
+
const varA = "variacaoPercentual" in a && typeof a.variacaoPercentual === "number" ? a.variacaoPercentual : 0;
|
|
584
|
+
const varB = "variacaoPercentual" in b && typeof b.variacaoPercentual === "number" ? b.variacaoPercentual : 0;
|
|
585
|
+
return varB - varA;
|
|
586
|
+
});
|
|
587
|
+
const result = {
|
|
588
|
+
periodo: { dataInicial: formatDateForApi(args.dataInicial), dataFinal: formatDateForApi(args.dataFinal) },
|
|
589
|
+
totalSeries: args.codigos.length,
|
|
590
|
+
seriesComDados: seriesComDados.length,
|
|
591
|
+
seriesComErro: seriesComErro.length,
|
|
592
|
+
ranking: seriesOrdenadas.map((s, i) => ({ posicao: i + 1, ...s })),
|
|
593
|
+
erros: seriesComErro.length > 0 ? seriesComErro : undefined
|
|
594
|
+
};
|
|
595
|
+
return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
|
|
596
|
+
}
|
|
597
|
+
catch (error) {
|
|
598
|
+
return {
|
|
599
|
+
content: [{ type: "text", text: `Erro ao comparar séries: ${error instanceof Error ? error.message : String(error)}` }],
|
|
600
|
+
isError: true
|
|
601
|
+
};
|
|
602
|
+
}
|
|
603
|
+
}
|
|
604
|
+
// ==================== TOOL DEFINITIONS (for worker JSON-RPC) ====================
|
|
605
|
+
export const TOOL_DEFINITIONS = [
|
|
606
|
+
{
|
|
607
|
+
name: "bcb_serie_valores",
|
|
608
|
+
description: "Consulta valores de uma série temporal do BCB por código. Retorna dados históricos com data e valor.",
|
|
609
|
+
inputSchema: {
|
|
610
|
+
type: "object",
|
|
611
|
+
properties: {
|
|
612
|
+
codigo: { type: "number", description: "Código da série no SGS/BCB (ex: 433 para IPCA mensal, 11 para Selic)" },
|
|
613
|
+
dataInicial: { type: "string", description: "Data inicial no formato yyyy-MM-dd ou dd/MM/yyyy (opcional)" },
|
|
614
|
+
dataFinal: { type: "string", description: "Data final no formato yyyy-MM-dd ou dd/MM/yyyy (opcional)" }
|
|
615
|
+
},
|
|
616
|
+
required: ["codigo"]
|
|
617
|
+
}
|
|
618
|
+
},
|
|
619
|
+
{
|
|
620
|
+
name: "bcb_serie_ultimos",
|
|
621
|
+
description: "Obtém os últimos N valores de uma série temporal do BCB. Útil para consultar dados mais recentes.",
|
|
622
|
+
inputSchema: {
|
|
623
|
+
type: "object",
|
|
624
|
+
properties: {
|
|
625
|
+
codigo: { type: "number", description: "Código da série no SGS/BCB" },
|
|
626
|
+
quantidade: { type: "number", description: "Quantidade de valores a retornar (1-1000, padrão: 10)" }
|
|
627
|
+
},
|
|
628
|
+
required: ["codigo"]
|
|
629
|
+
}
|
|
630
|
+
},
|
|
631
|
+
{
|
|
632
|
+
name: "bcb_serie_metadados",
|
|
633
|
+
description: "Obtém informações/metadados de uma série temporal do BCB. Retorna nome, periodicidade, categoria e outros detalhes.",
|
|
634
|
+
inputSchema: {
|
|
635
|
+
type: "object",
|
|
636
|
+
properties: {
|
|
637
|
+
codigo: { type: "number", description: "Código da série no SGS/BCB" }
|
|
638
|
+
},
|
|
639
|
+
required: ["codigo"]
|
|
640
|
+
}
|
|
641
|
+
},
|
|
642
|
+
{
|
|
643
|
+
name: "bcb_series_populares",
|
|
644
|
+
description: "Lista 150+ séries temporais do BCB com seus códigos. Inclui juros, inflação, câmbio, PIB, emprego, crédito e outros indicadores econômicos.",
|
|
645
|
+
inputSchema: {
|
|
646
|
+
type: "object",
|
|
647
|
+
properties: {
|
|
648
|
+
categoria: { type: "string", description: "Filtrar por categoria: Juros, Inflação, Câmbio, Atividade Econômica, Emprego, Fiscal, Setor Externo, Crédito, Agregados Monetários, Poupança, Índices de Mercado, Expectativas" }
|
|
649
|
+
}
|
|
650
|
+
}
|
|
651
|
+
},
|
|
652
|
+
{
|
|
653
|
+
name: "bcb_buscar_serie",
|
|
654
|
+
description: "Busca séries no catálogo interno por nome ou descrição. Aceita termos com ou sem acentos (ex: 'inflacao' encontra 'Inflação').",
|
|
655
|
+
inputSchema: {
|
|
656
|
+
type: "object",
|
|
657
|
+
properties: {
|
|
658
|
+
termo: { type: "string", description: "Termo de busca (mínimo 2 caracteres)" }
|
|
659
|
+
},
|
|
660
|
+
required: ["termo"]
|
|
661
|
+
}
|
|
662
|
+
},
|
|
663
|
+
{
|
|
664
|
+
name: "bcb_indicadores_atuais",
|
|
665
|
+
description: "Obtém os valores mais recentes dos principais indicadores econômicos: Selic, IPCA, Dólar PTAX e IBC-Br.",
|
|
666
|
+
inputSchema: {
|
|
667
|
+
type: "object",
|
|
668
|
+
properties: {}
|
|
669
|
+
}
|
|
670
|
+
},
|
|
671
|
+
{
|
|
672
|
+
name: "bcb_variacao",
|
|
673
|
+
description: "Calcula a variação percentual de uma série entre duas datas ou nos últimos N períodos. Útil para análise de tendências.",
|
|
674
|
+
inputSchema: {
|
|
675
|
+
type: "object",
|
|
676
|
+
properties: {
|
|
677
|
+
codigo: { type: "number", description: "Código da série no SGS/BCB" },
|
|
678
|
+
dataInicial: { type: "string", description: "Data inicial (yyyy-MM-dd ou dd/MM/yyyy)" },
|
|
679
|
+
dataFinal: { type: "string", description: "Data final (yyyy-MM-dd ou dd/MM/yyyy)" },
|
|
680
|
+
periodos: { type: "number", description: "Alternativa: calcular variação dos últimos N períodos (ignora datas se informado)" }
|
|
681
|
+
},
|
|
682
|
+
required: ["codigo"]
|
|
683
|
+
}
|
|
684
|
+
},
|
|
685
|
+
{
|
|
686
|
+
name: "bcb_comparar",
|
|
687
|
+
description: "Compara 2 a 5 séries temporais no mesmo período. Útil para análise de correlação entre indicadores.",
|
|
688
|
+
inputSchema: {
|
|
689
|
+
type: "object",
|
|
690
|
+
properties: {
|
|
691
|
+
codigos: { type: "array", items: { type: "number" }, description: "Array com 2 a 5 códigos de séries para comparar" },
|
|
692
|
+
dataInicial: { type: "string", description: "Data inicial (yyyy-MM-dd ou dd/MM/yyyy)" },
|
|
693
|
+
dataFinal: { type: "string", description: "Data final (yyyy-MM-dd ou dd/MM/yyyy)" }
|
|
694
|
+
},
|
|
695
|
+
required: ["codigos", "dataInicial", "dataFinal"]
|
|
696
|
+
}
|
|
697
|
+
}
|
|
698
|
+
];
|
|
699
|
+
// ==================== TOOL DISPATCHER (for worker) ====================
|
|
700
|
+
export async function dispatchTool(toolName, args, timeoutMs, maxRetries) {
|
|
701
|
+
switch (toolName) {
|
|
702
|
+
case "bcb_serie_valores":
|
|
703
|
+
return handleSerieValores(args, timeoutMs, maxRetries);
|
|
704
|
+
case "bcb_serie_ultimos":
|
|
705
|
+
return handleSerieUltimos({ codigo: args.codigo, quantidade: args.quantidade || 10 }, timeoutMs, maxRetries);
|
|
706
|
+
case "bcb_serie_metadados":
|
|
707
|
+
return handleSerieMetadados(args, timeoutMs, maxRetries);
|
|
708
|
+
case "bcb_series_populares":
|
|
709
|
+
return handleSeriesPopulares(args);
|
|
710
|
+
case "bcb_buscar_serie":
|
|
711
|
+
return handleBuscarSerie(args);
|
|
712
|
+
case "bcb_indicadores_atuais":
|
|
713
|
+
return handleIndicadoresAtuais({}, timeoutMs, maxRetries);
|
|
714
|
+
case "bcb_variacao":
|
|
715
|
+
return handleVariacao(args, timeoutMs, maxRetries);
|
|
716
|
+
case "bcb_comparar":
|
|
717
|
+
return handleComparar(args, timeoutMs, maxRetries);
|
|
718
|
+
default:
|
|
719
|
+
return {
|
|
720
|
+
content: [{ type: "text", text: `Tool não encontrada: ${toolName}` }],
|
|
721
|
+
isError: true
|
|
722
|
+
};
|
|
723
|
+
}
|
|
724
|
+
}
|
|
725
|
+
//# sourceMappingURL=tools.js.map
|