convez.ai
MCP ServerIntegração & APIsIntermediário
juanterraf

PJN MCP — Consulta de Expedientes

juanterraf/pjn-mcp

Acompanhe expedientes do PJN sem captcha, direto do Claude

Ver no GitHub
InicialPluginScore · de 0 a 100

Servidor MCP que permite acompanhar expedientes do Poder Judicial da Nação (Argentina) sem captcha, usando sessão autenticada do usuário. Oferece duas implementações equivalentes: Node (empacotada como .mcpb para um clique no Claude Desktop) e Python (referência local). Projeto aberto que demonstra automação jurídica com IA generativa.

Instalação

$npx convez-ai juanterraf/pjn-mcp

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 5 meses
Versão
v0.1.1
Issues abertas
0
Contribuidores
1

Casos de uso

  • Rastrear andamento de processos judiciais sem lidar com captchas
  • Automatizar consultas em lote de múltiplos expedientes
  • Integrar dados processuais em workflows de pesquisa jurídica

Veredito

MCP bem executado, com implementações produção-ready (Node/TypeScript com .mcpb e Python). Solução real para contornar fricção (captcha) em acesso a dados públicos judiciais argentinos. Código verificado end-to-end e publicado como educação aberta sobre orquestração de agentes Claude.

README

A tradução para o português deste README ainda está na fila.

PJN MCP — Consulta de Expedientes (Poder Judicial de la Nación)

MCP para seguir expedientes del PJN sin pelear con el captcha, apoyándose en la sesión autenticada del usuario (SSO Keycloak).

🌐 Proyecto abierto de derechointeligente.com.ar. Toda la investigación, el reconocimiento y el código se publican de forma pública y gratuita para difundir las posibilidades que nos da la IA generativa. Este repositorio se construyó de punta a punta con IA —reconocimiento → investigación actualizada → implementación → revisión adversarial → port a Node → empaquetado .mcpb— orquestando agentes de Claude. Usalo, estudialo y compartilo.

Estado: servidor MCP funcionando, verificado end-to-end contra el sitio real. Hay dos implementaciones equivalentes (mismas 6 tools, misma lógica):

  • node/ — Node/TypeScript → recomendada para distribuir. Se empaqueta como MCP Bundle (.mcpb) de un clic en Claude Desktop (Win/Mac): el usuario no instala Python ni Node (Claude Desktop trae Node). Usa el Chrome del sistema (channel:'chrome', sin descargar Chromium) y node:sqlite (0 módulos nativos). 29 tests verdes + E2E ACTIVE verificado en vivo (login → lista → detalle). 📦 Descargá el .mcpb listo en Releases y arrastralo a Claude Desktop.
  • src/pjn_mcp/ — Python (referencia). 29 tests; E2E verificado en vivo. Útil para correr local con pip o como referencia.

El reconocimiento original se ejecutó el 2026-06-11; sus artefactos están en recon/.


Instalar y usar en Claude Desktop (un clic)

  1. Descargá el archivo .mcpb (pjn-mcp-X.Y.Z.mcpb) desde Releases (sección Assets).
  2. Abrí Claude Desktop → Settings → Extensions y arrastrá el .mcpb ahí (o hacé doble clic en el archivo).
  3. Claude Desktop avisará que es de un editor no verificado (es una build abierta, sin firma de CA): confirmá la instalación.

No hace falta instalar Python ni Node: Claude Desktop ya trae Node embebido.

Requisitos: Windows o macOS · Google Chrome instalado (se usa tu Chrome) · ser usuario habilitado del SCW con tus credenciales.

Cómo iniciar sesión (paso a paso)

El login no se hace dentro de Claude: se hace en una ventana de Chrome que abre la extensión. Claude nunca ve tu usuario ni tu contraseña — solo conserva la sesión.

  1. En el chat de Claude Desktop, pedí iniciar sesión. Por ejemplo:

    "Iniciá sesión en el PJN" — o — "usá la herramienta login del PJN"

    Claude ejecuta la tool login.

  2. Se abre una ventana de Google Chrome en la pantalla de login del PJN (SSO Keycloak).

  3. Escribís tu usuario y contraseña en esa ventana del PJN (la real, no en Claude). Si tu organismo pide segundo factor, también lo completás ahí.

  4. Apenas entrás, la extensión detecta el login, guarda la sesión y cierra la ventana visible (sigue trabajando en segundo plano). Claude responde "Sesión iniciada".

  5. Listo: ya podés pedir "listá mis expedientes", "seguí el expediente …", "revisá novedades", "abrí el detalle del expediente …".

Después del primer login no hace falta repetirlo: la sesión queda guardada en tu equipo. Cuando el PJN la expira (a las pocas horas), las tools avisan necesita_login; ahí volvés a pedir "iniciá sesión" y repetís el paso del navegador.

ℹ️ Si Claude dice que la herramienta "tardó/expiró" pero vos sí completaste el login en la ventana, no pasa nada: la sesión igual quedó guardada. Solo dale la siguiente orden (p. ej. "listá mis expedientes") y va a funcionar. (El login manual puede tardar más que el tiempo de espera de una sola llamada.)

Las 6 tools

login · listar_mis_expedientes · ver_expediente · seguir_expediente · dejar_de_seguir · revisar_movimientos (compara la columna "Últ. Act." de la lista privada para avisarte novedades sin abrir cada expediente ni resolver captcha).


Hallazgos del reconocimiento (lo importante)

El ecosistema PJN está detrás de SSO Keycloak (sso.pjn.gov.ar) y una API de catálogo (api.pjn.gov.ar). El catálogo real de apps (de GET https://api.pjn.gov.ar/usuario/apps):

client_idAppRootNotas
pjn-portalPortalhttps://portalpjn.pjn.gov.arReact, con protección anti-inspección (congela la página). Evitar.
pjn-scwSistema de Consultas Webhttps://scw.pjn.gov.ar/scwJSF/Seam viejo, SIN anti-debug. Home privado: /homePrivado.seam. ← el camino bueno
pjn-sneNotificaciones Electrónicashttps://notif.pjn.gov.ar
pjn-escritosEscritos Webhttps://escritos.pjn.gov.ar
pjn-deoxDiligenciamiento de Oficioshttps://deox.pjn.gov.ar/deox
csjn-iwecRecursos Directos CSJNhttps://iwecs.csjn.gov.ar
pjn-autorizadosAutorizadoshttps://autorizados.pjn.gov.ar

Las 5 conclusiones clave

  1. Login sin captcha. Se entra una vez con usuario/clave vía Keycloak SSO. No hay captcha en el login. La sesión queda persistida en el perfil del navegador.
  2. "Mis Expedientes" = SCW autenticado, SIN captcha. Logueado, homePrivado.seam lleva a la lista de expedientes relacionados. Por cada causa la tabla trae: Expediente (cámara + nro/año), Dependencia, Carátula, Situación (EN DESPACHO, EN LETRA…) y Última actuación (fecha) ← la columna clave.
  3. El seguimiento es casi gratis. La columna "Últ. Act." permite detectar novedades mirando solo la lista: si cambia la fecha, hay movimiento; recién ahí se abre el expediente. revisar_movimientos() no necesita resolver captcha ni abrir N expedientes — compara fechas de una sola pantalla.
  4. Consulta pública (causas ajenas). Sigue en scw.pjn.gov.ar/scw/home.seam, con captcha de imagen (captcha.pjn.gov.ar, sitekey=SCW). Queda como modo secundario opcional (captcha puntual resuelto por el usuario).
  5. Anti-inspección resuelto. El portal React congela la página ante DevTools. Se esquiva trabajando sobre el SCW (parte vieja) y capturando vía el dominio Network de CDP, NO el dominio Debugger (que es lo que dispara el freeze).

Arquitectura (como está construida)

Motor: Playwright + perfil de Chrome persistente. El usuario se loguea una vez (headed, sin captcha); la sesión persiste; cuando expira, se pide re-login.

Persistencia de sesión (verificada en vivo): Chromium NO retiene por sí solo las cookies de sesión de Keycloak en el perfil entre cierres del contexto, así que browser.py las guarda y restaura explícitamente (<perfil>/session_cookies.json). Probado end-to-end: login headed → switch a headless → sigue active, y un proceso nuevo headless sin login reutiliza la sesión (lista + detalle reales).

Diseño clave: la lógica pura está separada de Playwright, así se testea sin navegador.

src/pjn_mcp/
  models.py    # dataclasses de dominio (Expediente, Movimiento, Novedad, …)
  parsers.py   # HTML (str) -> modelos. Detección de sesión, lista, detalle. PURO.
  forms.py     # deriva postbacks JSF/Mojarra (source-id por fila, ViewState). PURO.
  tracking.py  # SQLite local: seguir/no-seguir + detectar novedades por "Últ. Act.".
  browser.py   # ÚNICA capa con red: BrowserContext persistente (async, asyncio.Lock).
  server.py    # FastMCP: expone las 6 tools (stdio).
tests/         # 28 tests de parsers/forms/tracking contra fixtures sanitizados.
ToolQué hace
login()Abre el navegador (headed) para que el usuario entre por SSO (una vez).
listar_mis_expedientes()Lista de relacionados: nº/clave, carátula, dependencia, situación, última actuación.
ver_expediente(row_index)Detalle + movimientos de una causa de tu lista (cabecera + tabla de actuaciones, con enlaces a los documentos).
seguir_expediente(clave) / dejar_de_seguir(clave)Marca/desmarca la causa para seguimiento (SQLite local).
revisar_movimientos()Compara "Últ. Act." y devuelve solo las causas seguidas con novedad.

Privacidad: todo local. El MCP guarda solo lo mínimo para el seguimiento (clave + carátula + última actuación de las causas elegidas) y nunca la contraseña (solo la sesión, en el perfil del navegador).

Estado por tool: todas las tools tienen su lógica pura testeada contra HTML real (capturado en vivo y sanitizado). La ficha de detalle vive en expediente.seam?cid=... (Seam): ver_expediente parsea la cabecera (nº, jurisdicción, dependencia, situación, carátula) y la tabla expediente:action-table (oficina, fecha, tipo, detalle, foja + enlace al documento viewer.seam). El parser es defensivo y degrada a vacío ante estructuras desconocidas.


Instalación y uso

Requisitos: Python 3.13.x recomendado (3.11+ funciona; 3.14 corre OK pero no está en los classifiers oficiales de Playwright 1.60).

py -3 -m venv .venv
.\.venv\Scripts\python -m pip install -e .
.\.venv\Scripts\python -m playwright install chromium   # descarga el navegador

Tests (no requieren navegador ni sesión):

.\.venv\Scripts\python -m pip install -e ".[dev]"
.\.venv\Scripts\python -m pytest -q

Registrar el servidor en Claude (stdio). Ejemplo de claude_desktop_config.json:

{
  "mcpServers": {
    "pjn": {
      "command": "C:\\dev\\pjn-mcp\\.venv\\Scripts\\python.exe",
      "args": ["-m", "pjn_mcp.server"]
    }
  }
}

O con Claude Code: claude mcp add pjn -- C:\dev\pjn-mcp\.venv\Scripts\python.exe -m pjn_mcp.server.

Flujo: login() una vez → listar_mis_expedientes() → seguir_expediente(clave) → revisar_movimientos() cada tanto (esto último no abre expedientes ni resuelve captcha: solo compara la columna "Últ. Act." de la lista privada).


recon/ — artefactos del reconocimiento

  • recon.py … recon9.py, diag.py, diag2.py — sondas CDP incrementales.
  • recon8_contract.json — catálogo de apps PJN (la tabla de arriba sale de acá).
  • recon.json — captura del flujo de captcha de la consulta pública (sitekey=SCW).
  • recon9.py — verificación de homePrivado.seam (SSO, sin captcha) vía dominio Network.
  • scw_privado.html, widget_rendered.html — HTML capturado (SCW privado / widget captcha).
  • 0*_*.png, 10_portal_login.png — capturas de pantalla del recon.

Nota: el recon original usaba un Chrome con --remote-debugging-port=9222 y un perfil persistente (chromeprofile/) que no se copió acá (ruido + datos de sesión). El venv/ tampoco; recrear con Playwright al construir el server.


Próximos pasos

  1. ✅ login() end-to-end + ficha de detalle: probado con sesión real; el parser de parse_detalle quedó anclado a la estructura real (expediente:action-table), con fixture sanitizado y tests.
  2. Paginación de la lista: el usuario de prueba tiene 1 sola página (paginador divPagesAct presente pero con una sola). Cuando haya >1, capturar el postback del paginador y completar el salto de página en parsers/browser.
  3. Otras solapas del detalle: hoy se parsea sólo "Actuaciones"; faltan "Intervinientes", "Vinculados" y "Recursos" (cada una es otro tab JSF).
  4. consultar_publico(...) (opcional): causas ajenas vía consulta pública, con el captcha resuelto puntualmente por el usuario.

Cómo se construyó: investigación y la implementación inicial se orquestaron con múltiples agentes (Fable orquestando ejecutores Opus), seguidas de una revisión adversarial que encontró y corrigió 2 bugs reales (source-id JSF con escape, y matching por prefijo en el detalle). Ver el historial de commits.


Privacidad y uso responsable

  • Todo local. Cada persona corre el MCP en su propia máquina con su sesión y sus credenciales; el servidor nunca ve ni guarda la contraseña (solo cookies de sesión, en el perfil del navegador). Los datos de expedientes no salen de tu equipo.
  • Sin datos reales en el repo. Los fixtures de test están sanitizados (datos ficticios); las capturas con datos reales quedan fuera del control de versiones.
  • No es asesoramiento legal ni un producto oficial del Poder Judicial. Es una herramienta de automatización personal para usuarios ya habilitados del SCW.

Créditos y difusión

Hecho por derechointeligente.com.ar.

Publicamos toda la investigación y el código de forma abierta para mostrar, con un caso real y útil, lo que hoy es posible con IA generativa: relevar un sistema complejo, investigar el estado del arte, escribir software probado y empaquetarlo para distribuirlo —todo asistido por agentes—. Si te sirve, difundilo.

Licencia: MIT (ver LICENSE). Contribuciones y forks, bienvenidos.

Ver o original no GitHub

Bom para

Relacionados