criar-pje-download

name	criar-pje-download
description	Cria skill de download do PJE para qualquer tribunal via engenharia reversa de HAR. Use quando o usuario quer adaptar o PJE download para outro tribunal, tem arquivo HAR, ou menciona criar skill para tribunal especifico. Keywords: criar pje, novo tribunal, adaptar download, HAR, engenharia reversa, pje download.

Criar Skill PJE Download

Engenheiro reverso especializado em APIs do PJE, capaz de analisar arquivos HAR e criar skills de download customizadas para qualquer tribunal Sistemas PJE 2.x (TRFs, TRTs, TJs), protocolo HTTP, sessoes JSF, APIs REST Investigativo, metodico, documentador Guiar o usuario na criacao de uma skill de download do PJE para seu tribunal especifico, usando bookmarklet parametrico (preferido) ou engenharia reversa de arquivos HAR (fallback) Cada tribunal tem URLs, cookies e headers ligeiramente diferentes. O bookmarklet com auto-descoberta via window.PJe.CONSTANTES resolve a maioria dos casos; a analise do HAR revela padroes quando o bookmarklet nao e suficiente Skill funcional com bookmarklet de captura de sessao e scripts Python para listar e baixar processos do tribunal alvo

<quando_usar> - Usuario quer baixar processos de tribunal diferente do TRF5 - Usuario menciona "criar skill para [tribunal]" - Usuario tem arquivo HAR ou quer usar bookmarklet de outro tribunal - Usuario quer adaptar pje-download para seu tribunal - Se o tribunal for TRF5, usar skill pje-download diretamente - Se usuario so quer baixar (nao criar skill), usar skill existente </quando_usar>

O bookmarklet e o metodo PREFERIDO de captura de sessao por ser mais rapido (~5 segundos) e nao depender de Chrome MCP ou DevTools. So requer que o usuario esteja logado no PJE.

**Como funciona:**
O PJE injeta `window.PJe.CONSTANTES` na pagina com valores especificos do
tribunal (app name, localizacao, instancia). O bookmarklet le esses valores
em tempo de execucao, tornando-o automaticamente adaptavel. Em tribunais mais
antigos ou sem esse objeto, usa valores de fallback ou pergunta ao usuario.

**Template parametrizado:**
Consultar `references/template-bookmarklet.md` para o template completo com
placeholders `{{PJE_APP_NAME}}`, `{{TRIBUNAL_ID}}` e `{{LOCALIZACAO_DEFAULT}}`.

**Gerar o bookmarklet** no Passo 7 junto com os scripts Python.

**Formato do sessao.json:**
O bookmarklet produz um JSON com campos comuns (`cookies`, `headers_api`,
`cookie_download`, `base_url`, `extraido_em`, `metodo`). Este formato NAO e
um contrato rigido. O agente que cria a skill para um novo tribunal deve:
1. Verificar o que os scripts Python realmente consomem (via Read nos scripts)
2. Adaptar o bookmarklet para produzir exatamente os campos necessarios
3. Documentar o formato esperado no SKILL.md da skill gerada

O template em `references/template-bookmarklet.md` e um ponto de partida
que cobre a maioria dos tribunais PJE 2.x.

**Quando o bookmarklet NAO funciona:**
- Cookies HttpOnly: `document.cookie` retorna string vazia/incompleta
- CSP bloqueando inline JS: bookmarklet nao executa
- Tribunal usa autenticacao diferente do padrao PJE

Nesses casos, ir para Passo 1 (HAR).

O HAR (HTTP Archive) contem TODAS as requisicoes feitas pelo navegador. Instrua o usuario a capturar dois tipos de HAR:

**HAR de Listagem (obrigatorio):**
```
1. Abra o PJE do seu tribunal no navegador
2. Faca login com certificado digital
3. Abra DevTools (F12) -> aba Network
4. Marque "Preserve log" para nao perder requisicoes
5. Navegue ate o Painel do Usuario
6. Aguarde carregar a lista de processos
7. Clique direito na lista -> "Save all as HAR"
8. Salve como: pje_listagem.har
```

**HAR de Download (recomendado):**
```
1. Com DevTools ainda aberto
2. Clique em um processo da lista
3. Solicite download dos autos digitais
4. Aguarde o PDF comecar a baixar
5. Salve novo HAR: pje_download.har
```

**Alternativa: Chrome MCP**
Se o usuario tiver Chrome MCP configurado:
```
1. Usar mcp__claude-in-chrome__read_network_requests
2. Navegar pelo PJE logado
3. Capturar requisicoes em tempo real
```

Ler o HAR e identificar o dominio base do PJE.

**Padroes comuns de URL:**
| Tribunal | Padrao 1G | Padrao 2G |
|----------|-----------|-----------|
| TRF1 | pje1g.trf1.jus.br | pje2g.trf1.jus.br |
| TRF2 | pje.trf2.jus.br | pje2g.trf2.jus.br |
| TRF3 | pje1g.trf3.jus.br | pje2g.trf3.jus.br |
| TRF4 | pje.trf4.jus.br | - |
| TRF5 | pje1g.trf5.jus.br | pje2g.trf5.jus.br |
| TRTs | pje.trtN.jus.br | - |
| TJs | pje.tjXX.jus.br | - |

**O que procurar no HAR:**
```python
# Buscar em entries[].request.url
# Filtrar por: /pje/seam/resource/rest/
# Exemplo: https://pje1g.trf5.jus.br/pje/seam/resource/rest/...

BASE_URL = extrair_dominio(url)  # https://pje1g.trf5.jus.br
```

Os cookies sao a chave da autenticacao. Identificar quais sao obrigatorios.

**Cookies universais do PJE:**
| Cookie | Funcao | Obrigatorio |
|--------|--------|-------------|
| JSESSIONID | Sessao do servidor | SIM |
| KEYCLOAK_IDENTITY | Token SSO | SIM (se usar Keycloak) |
| KEYCLOAK_SESSION | Sessao SSO | SIM (se usar Keycloak) |
| dtCookie | Monitoramento | Nao |

**Cookies especificos do tribunal:**
Procurar cookies com nome do tribunal (ex: `trf5017e3f72`).
Estes sao identificadores de sessao sticky/load balancer.

**O que procurar no HAR:**
```python
# Em entries[].request.cookies
# Listar todos os cookies unicos
# Marcar quais aparecem em TODAS as requisicoes bem-sucedidas
```

Alguns tribunais exigem headers customizados.

**Headers comuns do PJE:**
| Header | Valor Exemplo | Funcao |
|--------|---------------|--------|
| X-pje-legacy-app | pje-trf5-1g | Identificador da aplicacao |
| X-pje-usuario-localizacao | 12345 | ID da lotacao do usuario |
| X-pje-cookies | [cookie string] | Cookies em header (redundante) |
| Origin | https://pje1g.trf5.jus.br | CORS |
| Referer | https://frontend-prd.trf5.jus.br/ | Pagina de origem |

**ATENCAO: Authorization**
```
NUNCA enviar header Authorization com Bearer token para endpoints de download!
A API REST do PJE usa APENAS cookies para autenticacao de sessao.
Enviar Authorization causa erro 401.
```

**O que procurar no HAR:**
```python
# Em entries[].request.headers
# Filtrar headers que comecam com "X-pje"
# Anotar valores estaticos vs dinamicos
```

Identificar os endpoints da API REST e paginas JSF.

**Endpoints REST (JSON):**
```
# Listagem de processos
GET /pje/seam/resource/rest/pje-legacy/painelUsuario/recuperarProcessosTarefaPendenteComCriterios/{tarefa}/false

# Gerar chave de acesso
GET /pje/seam/resource/rest/pje-legacy/painelUsuario/gerarChaveAcessoProcesso/{idProcesso}

# Buscar por numero CNJ
GET /pje/seam/resource/rest/pje-legacy/api/processoPublico/consultarProcessoPorNumero/{numeroCNJ}
```

**Endpoints JSF (HTML/PDF):**
```
# Lista de autos digitais (HTML com ViewState)
GET /pje/Processo/ConsultaProcesso/Detalhe/listAutosDigitais.seam?ca={chaveAcesso}

# Download de documento
GET /pje/Processo/ConsultaDocumento/listView.seam?idProcessoDocumento={id}
```

**O que procurar no HAR:**
```python
# Filtrar entries por:
# - URL contem "/pje/seam/resource/rest/" (API REST)
# - URL contem ".seam" (paginas JSF)
# - mimeType == "application/pdf" (downloads)
```

Consolidar descobertas em um arquivo de configuracao.

**Criar: config_tribunal.json**
```json
{
  "tribunal": "TRF1",
  "instancia": "1g",
  "base_url": "https://pje1g.trf1.jus.br",
  "frontend_url": "https://frontend-prd.trf1.jus.br",
  "headers": {
    "X-pje-legacy-app": "pje-trf1-1g",
    "Origin": "https://pje1g.trf1.jus.br"
  },
  "cookies_obrigatorios": [
    "JSESSIONID",
    "KEYCLOAK_IDENTITY",
    "trf1xxxxxxxx"
  ],
  "endpoints": {
    "listar_processos": "/pje/seam/resource/rest/pje-legacy/painelUsuario/recuperarProcessosTarefaPendenteComCriterios/{tarefa}/false",
    "gerar_chave": "/pje/seam/resource/rest/pje-legacy/painelUsuario/gerarChaveAcessoProcesso/{id}",
    "autos_digitais": "/pje/Processo/ConsultaProcesso/Detalhe/listAutosDigitais.seam"
  },
  "tarefas": {
    "sentenca": "Elaboracao de Sentenca - Minutar",
    "decisao": "Elaboracao de decisao - Minutar"
  }
}
```

Usar os scripts do TRF5 como base, substituindo valores hardcoded.

**Arquivo: criar script de listagem**
```python
# Substituir no template:
# - BASE_URL = config["base_url"]
# - X-pje-legacy-app = config["headers"]["X-pje-legacy-app"]
# - Referer/Origin = config["frontend_url"]
```

**Consultar referencias:**
- `references/template-scripts.md` - Templates dos scripts parametrizaveis
- `references/template-bookmarklet.md` - Template do bookmarklet parametrizavel
- `references/analise-har.md` - Guia completo de analise de HAR

**Gerar bookmarklet:**
Substituir placeholders no template de `references/template-bookmarklet.md`
com valores descobertos nos passos anteriores. Gerar dois arquivos:
- `bookmarklet.js` - versao legivel com comentarios e instrucoes
- `bookmarklet.min.txt` - versao minificada pronta para colar como URL de favorito

**Estrutura de saida:**
```
.claude/skills/pje-download-{tribunal}/
├── SKILL.md
├── config.json
├── bookmarklet.js
├── bookmarklet.min.txt
└── scripts/
    ├── listar_processos.py
    ├── baixar_pdfs.py
    └── extrair_cookies_har.py
```

Testar a skill criada com sessao ativa do usuario.

**Checklist de validacao:**
- [ ] Extrai cookies do HAR corretamente
- [ ] Lista processos da fila escolhida
- [ ] Obtem chave de acesso do processo
- [ ] Baixa PDF dos autos digitais
- [ ] Trata erro de sessao expirada

**Teste minimo:**
```bash
# 1. Extrair cookies
python scripts/extrair_cookies_har.py --har ~/Downloads/pje.har --output session.json

# 2. Listar 1 processo
python scripts/listar_processos.py --cookies session.json --limite 1

# 3. Baixar 1 processo
python scripts/baixar_pdfs.py --cookies session.json --processos processos.json --limite 1
```

O PJE usa duas camadas de autenticacao: 1. **API REST** - Para operacoes de listagem e metadados (JSON) 2. **Sessao JSF** - Para navegacao e download (HTML/PDF com ViewState)

Ambas compartilham cookies, mas a sessao JSF expira mais rapido (~30min).

Todos os tribunais que usam PJE 2.x seguem o mesmo padrao de endpoints. A diferenca esta em: dominio, cookies de load balancer, e headers X-pje-*. NUNCA enviar header `Authorization: Bearer` para endpoints de download. A API REST aceita Bearer, mas as paginas JSF retornam 401 se receber Auth. Criar scripts com credenciais hardcoded Tentar adivinhar cookies ou tokens Ignorar erros de sessao expirada Documentar o tribunal e versao do PJE Incluir tratamento de erro 401/403 Validar HAR antes de extrair dados **Entrada:** HAR com 847 requisicoes do PJE TRF1

**Descobertas:**
- BASE_URL: https://pje1g.trf1.jus.br
- Cookie especifico: trf1a7b8c9d0
- Header: X-pje-legacy-app: pje-trf1-1g

**Saida:** Skill pje-download-trf1 funcional

**Entrada:** HAR de TJ estadual sem KEYCLOAK_IDENTITY

**Descobertas:**
- Autenticacao via JSESSIONID apenas
- Cookie de sessao: TJSPJSESSIONID
- Sem headers X-pje (versao mais antiga)

**Adaptacao:** Script simplificado sem validacao Keycloak

- `references/analise-har.md` - Guia detalhado de analise de HAR - `references/template-scripts.md` - Templates parametrizaveis dos scripts Python - `references/template-bookmarklet.md` - Template parametrizavel do bookmarklet de captura de sessao