Buscar série no catálogo
bcb_buscar_serieSearch BCB time series by keyword or code in a curated catalog and the Open Data index to find series codes before querying their values.
Instructions
Busca séries do BCB por palavra-chave (ou pelo código) em DUAS camadas: o catálogo curado local de 135 séries verificadas contra a origem, que vem primeiro e com fonteNome dizendo se o nome é transcrito do portal do BCB ou herdado, e o índice do Portal de Dados Abertos do BCB, com milhares de séries identificadas por código. Ignora acentos e maiúsculas ('inflacao' encontra 'Inflação'); vários termos são combinados com E ('ipca servicos'). Quando usar: para descobrir o código de uma série antes de consultar valores. Quando NÃO usar: para navegar tudo por categoria use bcb_series_populares; para valores use bcb_serie_valores. Retorna: termo, totalEncontradas, series (cada item com codigo, nome, origem — 'curado' ou 'indice' — e, no índice, dataset com a página do portal), catalogo (origem, obtidoEm, seriesIndexadas, cobertura) e, quando aplicável, observacao, avisos, mensagem e sugestao. Cobertura: o índice NÃO é o SGS inteiro, portanto não encontrar aqui não prova que a série não exista — o campo catalogo.cobertura diz isso explicitamente em toda resposta. Comportamento de rede: o índice é servido de cache com validade de 24 h e a renovação é feita pela primeira busca após o vencimento (uma requisição ao portal, ~1 s); as demais buscas não tocam a rede. Se o portal estiver fora, a busca degrada para o catálogo curado (ou para o último índice obtido) e sinaliza em avisos, sempre com a data de obtenção visível.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| termo | Yes | Termo de busca (mínimo 2 caracteres) ou o código da série. Vários termos são combinados com E, sem distinção de acento; a palavra de todo dia é traduzida para a do BCB (déficit→resultado primário, calote→inadimplência, desemprego→desocupação) e a resposta diz quando isso aconteceu (notasVocabulario). | |
| limite | No | Máximo de séries a devolver (1-100, padrão: 20). `totalEncontradas` traz o total antes do corte. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| termo | Yes | Termo pesquisado | |
| avisos | No | Avisos de degradação (índice vencido ou indisponível) | |
| series | Yes | Séries que correspondem ao termo — as do catálogo curado primeiro | |
| catalogo | Yes | Proveniência do índice usado na busca | |
| mensagem | No | Mensagem exibida quando nada é encontrado | |
| sugestao | No | Sugestões de termos alternativos | |
| observacao | No | Aviso de corte quando há mais resultados que `limite` | |
| provenance | Yes | Um bloco por procedência que contribuiu com esta resposta (contrato v1.1; licenças nunca se fundem) | |
| attribution | Yes | URLs canônicas das fontes desta resposta (lista de atribuição) | |
| notasVocabulario | No | Quando um termo foi ampliado para a palavra que o BCB usa (déficit→resultado primário), diz qual | |
| totalEncontradas | Yes | Quantidade de séries encontradas, antes do corte por `limite` |