Ajuda do HubLink Estratégia · IC&M

Ajuda do Hub · Coleta — WebParser

Modos documento, API e planilha

Quando usar cada modo de captura avançado do WebParser e como configurá-los.

Além do monitoramento de páginas, o WebParser captura de três outras naturezas de fonte. A escolha do modo depende de onde o dado mora.

Documento (document_extract)

Para PDFs e documentos publicados com regularidade: releases de resultados, relatórios regulatórios, atas.

  1. Informe a URL do documento (ou o padrão de endereço, quando ele muda de nome por período).
  2. Descreva os campos que interessam — o extrator localiza os valores no texto do documento.
  3. Teste com o documento mais recente e confira cada valor lido.

Documentos com layout instável exigem revisão a cada ciclo. Se a leitura falhar duas vezes seguidas, prefira registrar o dado manualmente.

API externa (api_source)

Para fontes que já publicam dados estruturados: órgãos oficiais, bancos centrais, institutos de estatística.

  1. Escolha a API no catálogo, quando ela já estiver mapeada, ou informe o endereço do endpoint.
  2. Configure parâmetros (período, região, indicador) e o caminho dos campos na resposta.
  3. Teste. Um resultado de teste com valores plausíveis é o critério de aprovação.

[CAPTURA DE TELA] Painel de configuração de API externa, com parâmetros e campos mapeados.

Planilha (sheet_extract)

Para bases em Excel/CSV publicadas periodicamente. Este modo é inteiramente mecânico: você mapeia coluna → métrica, sem interpretação automática. Escolha a aba, a linha de cabeçalho e diga qual coluna corresponde a qual métrica e qual dimensão.

Frequência e captura única

Qualquer um dos modos aceita frequência diária, semanal, mensal ou captura única. Fontes como censos e estudos anuais devem usar captura única: rodam uma vez e não voltam a ser agendadas.

Perguntas frequentes

Preciso de credenciais para a API. Fontes que exigem chave privada precisam de configuração pela Link Estratégia.

A planilha mudou de colunas. Reabra o mapeamento e ajuste; o histórico anterior é mantido.

O documento é digitalizado (imagem). Extração de PDF escaneado é pouco confiável; trate como coleta manual.

  • webparser
  • documento
  • API
  • planilha
  • PDF

Atualizado em 2026-08-21

Hub Help · Collection — WebParser

Document, API and spreadsheet modes

When to use each advanced WebParser capture mode and how to configure them.

Beyond page monitoring, WebParser captures from three other kinds of source. Choosing the mode depends on where the data lives.

Document (document_extract)

For PDFs and documents published regularly: earnings releases, regulatory reports, minutes.

  1. Enter the document URL (or the address pattern, when the file name changes by period).
  2. Describe the fields you care about — the extractor locates the values in the document text.
  3. Test with the most recent document and check every value read.

Documents with unstable layouts require review each cycle. If reading fails twice in a row, prefer recording the data manually.

External API (api_source)

For sources that already publish structured data: official agencies, central banks, statistics institutes.

  1. Pick the API from the catalogue, when it is already mapped, or enter the endpoint address.
  2. Configure parameters (period, region, indicator) and the field paths in the response.
  3. Test. A test result with plausible values is the approval criterion.

[SCREENSHOT] External API configuration panel, with parameters and mapped fields.

Spreadsheet (sheet_extract)

For Excel/CSV bases published periodically. This mode is entirely mechanical: you map column → metric, with no automatic interpretation. Pick the sheet, the header row and state which column matches which metric and dimension.

Frequency and single capture

Any mode accepts daily, weekly, monthly frequency or single capture. Sources such as censuses and annual studies should use single capture: they run once and are not rescheduled.

Frequently asked questions

I need credentials for the API. Sources requiring a private key must be configured by Link Estratégia.

The spreadsheet changed columns. Reopen the mapping and adjust; earlier history is kept.

The document is scanned (an image). Scanned PDF extraction is unreliable; treat it as manual collection.

  • webparser
  • document
  • API
  • spreadsheet
  • PDF

Updated on 2026-08-21

Ayuda del Hub · Recolección — WebParser

Modos documento, API y planilla

Cuándo usar cada modo de captura avanzado del WebParser y cómo configurarlos.

Además del monitoreo de páginas, el WebParser captura de otras tres naturalezas de fuente. La elección del modo depende de dónde vive el dato.

Documento (document_extract)

Para PDFs y documentos publicados con regularidad: reportes de resultados, informes regulatorios, actas.

  1. Informe la URL del documento (o el patrón de dirección, cuando cambia de nombre por período).
  2. Describa los campos que interesan — el extractor localiza los valores en el texto del documento.
  3. Pruebe con el documento más reciente y verifique cada valor leído.

Los documentos con diseño inestable exigen revisión en cada ciclo. Si la lectura falla dos veces seguidas, prefiera registrar el dato manualmente.

API externa (api_source)

Para fuentes que ya publican datos estructurados: organismos oficiales, bancos centrales, institutos de estadística.

  1. Elija la API en el catálogo, cuando ya esté mapeada, o informe la dirección del endpoint.
  2. Configure parámetros (período, región, indicador) y la ruta de los campos en la respuesta.
  3. Pruebe. Un resultado de prueba con valores plausibles es el criterio de aprobación.

[CAPTURA DE PANTALLA] Panel de configuración de API externa, con parámetros y campos mapeados.

Planilla (sheet_extract)

Para bases en Excel/CSV publicadas periódicamente. Este modo es enteramente mecánico: usted mapea columna → métrica, sin interpretación automática. Elija la hoja, la fila de encabezado y diga qué columna corresponde a qué métrica y a qué dimensión.

Frecuencia y captura única

Cualquiera de los modos acepta frecuencia diaria, semanal, mensual o captura única. Fuentes como censos y estudios anuales deben usar captura única: corren una vez y no se reprograman.

Preguntas frecuentes

Necesito credenciales para la API. Las fuentes que exigen clave privada requieren configuración por Link Estratégia.

La planilla cambió de columnas. Reabra el mapeo y ajústelo; el historial anterior se mantiene.

El documento es digitalizado (imagen). La extracción de PDF escaneado es poco confiable; trátelo como recolección manual.

  • webparser
  • documento
  • API
  • planilla
  • PDF

Actualizado el 2026-08-21