CNA OAB API (Python + Flask + Playwright + PHP + MySQL)

Sistema de consulta automatizada da OAB/CNA utilizando:

• Python
• Flask
• Playwright
• PHP
• MySQL

O sistema consulta automaticamente o site do CNA da OAB, captura o JSON retornado pela API interna e salva os dados no banco MySQL.

---

FUNCIONAMENTO

Fluxo da aplicação:

PHP
↓
Flask API
↓
Playwright abre o CNA
↓
Preenche formulário
↓
Clica em pesquisar
↓
Captura JSON da API interna
↓
Salva no MySQL
↓
Retorna resultado

---

DIFERENCIAL

O sistema possui:

• Cache local no MySQL

• Evita consultas repetidas

• Evita bloqueio por excesso de requests

• Não duplica advogados

• Captura automática do reCAPTCHA válido

• Busca híbrida:

  • primeiro no banco
  • depois no CNA

---

TECNOLOGIAS

Backend

• Python 3
• Flask
• Playwright
• MySQL Connector

Frontend

• PHP
• HTML
• CSS

Banco

• MySQL

---

INSTALAÇÃO

1. Instalar Python

Baixe:

https://www.python.org/downloads/

---

2. Instalar dependências

Abra o terminal:

pip install -r requirements.txt

---

3. Instalar navegador do Playwright

playwright install chrome

---

4. Criar banco MySQL

Importe o arquivo:

database.sql

ou execute:

CREATE DATABASE IF NOT EXISTS oab_system;

USE oab_system;

CREATE TABLE IF NOT EXISTS advogados (

    id INT AUTO_INCREMENT PRIMARY KEY,

    nome VARCHAR(255),

    status VARCHAR(50),

    uf VARCHAR(10),

    oab VARCHAR(50),

    parametro TEXT,

    criado_em TIMESTAMP DEFAULT CURRENT_TIMESTAMP,

    UNIQUE (oab, uf)
);

---

5. Configurar MySQL

No arquivo:

api.py

altere:

MYSQL_CONFIG = {
    "host": "localhost",
    "user": "root",
    "password": "",
    "database": "oab_system"
}

---

6. Rodar API Python

python api.py

API:

http://127.0.0.1:5000

---

7. Rodar PHP

Coloque:

index.php

na pasta:

htdocs

do XAMPP/WAMP.

---

8. Abrir sistema

http://localhost/index.php

---

ESTRUTURA

/
├── api.py
├── index.php
├── database.sql
├── requirements.txt
└── README.md

---

ENDPOINTS

POST /buscar

Busca advogado.

Body JSON

{
    "nome": "JHEMILA PAULA REY",
    "inscricao": "58898"
}

---

RESPOSTA

Quando vem do MySQL

{
    "origem": "mysql",
    "items": [
        {
            "nome": "JHEMILA PAULA REY",
            "oab": "58898",
            "uf": "SC"
        }
    ]
}

---

Quando vem do CNA

{
    "origem": "oab",
    "dados": {
        "items": [
            {
                "nome": "JHEMILA PAULA REY",
                "inscricao": "58898",
                "uf": "SC"
            }
        ]
    }
}

---

COMO O SISTEMA FUNCIONA

PRIMEIRA CONSULTA

MYSQL
↓ não encontrou
CNA OAB
↓
SALVA
↓
RETORNA

---

SEGUNDA CONSULTA

MYSQL
↓ encontrou
RETORNA IMEDIATAMENTE

---

SOBRE O CAPTCHA

O CNA utiliza:

• Google reCAPTCHA Enterprise
• Score reCAPTCHA v3
• Headers protegidos
• Tokens temporários

Por isso requests diretos geralmente retornam:

{
  "message": "Recaptcha validation failed"
}

O Playwright resolve isso simulando navegador real.

---

SOBRE O CAMPO "parametro"

Exemplo:

34634931586B51695648632B396447526B61643975773D3D

Esse campo é um identificador interno criptografado utilizado pelo CNA para consultas detalhadas do advogado.

---

IMPORTANTE

NÃO abuse das consultas

O CNA possui:

• rate limit
• anti-bot
• captcha
• fingerprint
• detecção de automação

Recomendado:

• usar cache MySQL
• evitar spam
• não abrir múltiplas sessões simultâneas

---

DEPENDÊNCIAS

requirements.txt:

flask
playwright
mysql-connector-python

---

AUTOR

Projeto desenvolvido para estudos e automação de consultas CNA/OAB.