aggregators.jusbr.client.JusbrScraper

aggregators.jusbr.client.JusbrScraper(
    verbose=0,
    download_path=None,
    sleep_time=0.5,
    token=None,
)

Raspador para o JusBR (consulta unificada da PDPJ-CNJ).

Este scraper interage com a API da Plataforma Digital do Poder Judiciario (PDPJ).

Methods

Name Description
auth Define o token JWT para autenticacao e o decodifica para verificacao.
auth_firefox Authentication via Firefox.
cpopg Consulta processos pelo numero CNJ (ou lista de numeros CNJ) via API nacional.
download_documents Baixa e limpa os documentos dos processos de um DataFrame.

auth

aggregators.jusbr.client.JusbrScraper.auth(token, **kwargs)

Define o token JWT para autenticacao e o decodifica para verificacao.

Raises

Name Type Description
TypeError Quando um kwarg desconhecido e passado (schema :class:InputAuthJusBR, extra="forbid").
ValueError Quando o token e invalido ou esta expirado.

auth_firefox

aggregators.jusbr.client.JusbrScraper.auth_firefox()

Authentication via Firefox.

cpopg

aggregators.jusbr.client.JusbrScraper.cpopg(id_cnj, **kwargs)

Consulta processos pelo numero CNJ (ou lista de numeros CNJ) via API nacional.

Raises

Name Type Description
TypeError Quando um kwarg desconhecido e passado (schema :class:InputCPOPGJusBR, extra="forbid").
RuntimeError Quando auth(token) nao foi chamado antes.

download_documents

aggregators.jusbr.client.JusbrScraper.download_documents(
    base_df,
    max_docs_per_process=None,
    **kwargs,
)

Baixa e limpa os documentos dos processos de um DataFrame.

O limite é aplicado ao numeroProcesso em todo o DataFrame, inclusive quando o mesmo processo aparece em mais de uma linha.

Parameters

Name Type Description Default
base_df pd.DataFrame Processos com as colunas numeroProcesso e detalhes, como retornados por :meth:cpopg. required
max_docs_per_process int | None Limite de documentos por processo. None baixa todos; 0 não faz downloads. Default None. None
**kwargs Any Nenhum parâmetro adicional é aceito. {}

Raises

Name Type Description
TypeError Quando um kwarg desconhecido e passado (schema :class:InputDownloadDocumentsJusBR, extra="forbid").
ValidationError Quando base_df não é um DataFrame ou max_docs_per_process é negativo.
RuntimeError Quando auth(token) não foi chamado antes.

Returns

Name Type Description
pd.DataFrame pd.DataFrame: Uma linha por documento, com metadados, texto limpo e
pd.DataFrame respostas brutas disponíveis.

See also

— schema pydantic e fonte da verdade dos parâmetros aceitos.