如何自动化 gov.br 登录(以及为什么所有爬虫都在你之前失败)
gov.br 使用 hCaptcha、浏览器指纹识别和 IP 封锁。Playwright、Selenium 和 Puppeteer 会静默失败。本教程展示如何使用 Abrasio 解决所有这些问题,并获得一个已认证的会话——可用于车辆查询、文件提取和表单填写。
没人公开谈论的问题
每周,都有开发者或数据分析师尝试在 gov.br 上自动化某些操作,然后撞上同一堵隐形的墙。没有清晰的警告。没有说明性的错误消息。Selenium 就卡在登录界面上。Playwright 打开页面、输入 CPF,然后……什么都没发生。整个流程在 hCaptcha 出现之前就停止了。
问题不在于你的代码。而在于机器人检测器。
gov.br 是保护超过 1800 个联邦和州级公共服务的 SSO(单点登录)。访问 DETRAN-MG、联邦税务局、INSS、Meu INSS、驾照门户、SINARM 或任何使用'使用 gov.br 登录'的系统——你首先需要通过这个登录。
想要自动化这个访问的理由完全合理:
- 每天需要查询数十辆车辆状态的调度员和运输公司
- 需要验证驾驶员执照和积分的物流公司
- 为多个客户开具 GRU 和 DARF 的会计事务所
- 在 PROJUDI 和州法院跟踪案件的律师事务所
- 在 eSocial 验证信息的人力资源公司
- 需要在多市 NFS-e 系统开具发票的服务提供商
- 构建内部工具以加速官僚流程的开发者
在所有这些情况下,瓶颈都是相同的:登录。一旦认证,你就可以浏览任何与 gov.br 相关的服务。但用传统自动化达到这一步几乎是不可能的——而这正是我们要解决的。
真正保护 gov.br 的是什么
在展示解决方案之前,了解对方有什么防御是值得的。gov.br 不仅仅使用一种保护机制——它同时使用至少四层防护:
hCaptcha
hCaptcha 是一个类似 reCAPTCHA 的验证系统,但具有更先进的机器人检测方法。它分析用户行为,可能需要视觉交互来确认你是人类。
浏览器指纹识别
Playwright、Selenium 或 Puppeteer 启动的 Chrome 与真实 Chrome 有不同的数字签名。navigator.webdriver 被标记为 true,WebGL 字符串显示没有真实 GPU,canvas 在每次运行之间返回相同的值(没有噪声),用户的默认插件也不存在。
IP 分析和地理位置
数据中心 IP(AWS、GCP、Azure、DigitalOcean)会自动被封锁。gov.br 期望巴西住宅 IP。如果你从服务器或巴西境外尝试,系统在你输入任何内容之前就已经知道了。
行为分析
恒定的打字速度(delay=0 或固定延迟)、鼠标直接移动到字段而没有事先移动、没有滚动、没有之前 cookies 的新会话——这些模式中的任何一个都会触发警报。

为什么 Playwright、Selenium 和 Puppeteer 失败
看看使用传统自动化会发生什么:
# O que acontece com Playwright puro no gov.br:
from playwright.async_api import async_playwright
async with async_playwright() as p:
browser = await p.chromium.launch(headless=True)
page = await browser.new_page()
await page.goto("https://sso.acesso.gov.br/login")
# Resultado: bloqueio imediato
# O gov.br detecta:
# navigator.webdriver = true → identifica automação
# Headless Chrome fingerprint → sem plugins, sem GPU real
# IP de datacenter → não é IP residencial brasileiro
# Ausência de histórico → novo perfil sem cookies anteriores
# Velocidade de digitação → 0ms entre teclas (robótico)浏览器打开,页面加载,但 hCaptcha 已经分析了指纹并做出了决定。没有视觉反馈,没有错误消息——表单就是不会继续。

封锁不是永久的
解决方案:Abrasio
Abrasio 是专门为这类场景构建的浏览器服务。它结合三种技术来绕过这些防御:
指纹修补的 Chromium
一个修改过的 Chromium,其中 navigator.webdriver 被移除,WebGL 和 Canvas 字符串接收真实的噪声,HTTP headers 被规范化,默认插件存在。数字签名与真实 Chrome 相同。
巴西住宅 IP
默认情况下,每个会话使用 BR 地区的住宅 IP。gov.br 看到的是来自巴西公民的正常连接,而不是服务器。
人类行为模拟
human_type()、human_wait()、human_scroll() 和 simulate_reading() 函数复制真实用户模式:按键延迟变化、贝塞尔曲线鼠标移动、操作间随机暂停。



教程
你需要一个 Abrasio API key。在文章末尾免费创建你的。
安装
通过 pip 安装 Abrasio SDK:
pip install abrasio将你的 API key 配置为环境变量。你可以在你的 Abrasio 控制台:
export ABRASIO_API_KEY=abr_live_sua_chave_aqui永远不要把 API key 写在代码里
gov.br 登录
gov.br 登录流程有三个步骤:CPF → 密码 → MFA 代码(认证器或短信)。以下代码将此流程封装在一个函数中,返回已认证的会话 cookies:
"""
Tutorial: Login automatizado no gov.br com Abrasio
Instalação:
pip install abrasio
Configuração:
export ABRASIO_API_KEY=abr_live_sua_chave_aqui
"""
import asyncio
import os
from abrasio import Abrasio
from abrasio.utils import human_type, human_wait
async def login_govbr(cpf: str, senha: str, otp_callback=None) -> list:
"""
Faz login no gov.br e retorna os cookies da sessão autenticada.
Args:
cpf: CPF do cidadão (apenas números)
senha: Senha do acesso gov.br
otp_callback: Função chamada para obter o código OTP.
Se None, solicita via input().
Returns:
Lista de cookies da sessão autenticada.
"""
api_key = os.getenv("ABRASIO_API_KEY")
if not api_key:
raise ValueError("Configure a variável de ambiente ABRASIO_API_KEY")
async with Abrasio(
api_key=api_key,
region="br", # IP brasileiro — obrigatório para o gov.br
device="desktop",
headless=False, # Use True em produção
humanize=True, # Simula comportamento humano (mouse, teclado)
) as browser:
page = await browser.new_page()
# 1. Navegar para o SSO do gov.br
await page.goto(
"https://sso.acesso.gov.br/login",
wait_until="domcontentloaded"
)
await page.wait_for_selector("#accountId")
# 2. Digitar CPF com timing humano (evita detecção por velocidade de digitação)
await human_type(page, cpf, "#accountId")
await page.locator("#enter-account-id").click()
# 3. Aguardar o campo de senha aparecer e digitar
await human_wait(2, 4)
await page.locator("#password").wait_for(state="visible")
await page.keyboard.type(senha, delay=100)
await page.locator("#submit-button").click()
# 4. Fechar o popup de aviso e inserir código OTP/MFA
await page.wait_for_selector(".gdd-close-btn")
await page.locator(".gdd-close-btn").click()
await page.locator("#otpInput").wait_for(state="visible")
# Obter código OTP (via callback ou input interativo)
if otp_callback:
codigo = await otp_callback()
else:
codigo = input("Digite o código MFA do gov.br: ")
await page.keyboard.type(codigo, delay=100)
await page.locator("#enter-offline-2fa-code").click()
# 5. Sessão autenticada — capturar e retornar cookies
cookies = await page.context.cookies()
print(f"✓ Login realizado com sucesso. {len(cookies)} cookies capturados.")
await page.screenshot(path="govbr_sessao.png", full_page=True)
return cookies
if __name__ == "__main__":
import asyncio
async def main():
cookies = await login_govbr(
cpf=input("CPF (apenas números): "),
senha=input("Senha: "),
)
print(f"\nCookies da sessão: {len(cookies)}")
for c in cookies:
print(f" {c['name']}: {c['value'][:30]}...")
asyncio.run(main())你现在拥有的
真实示例:车辆状态查询
有了已认证的会话,看看如何在米纳斯吉拉斯州公民门户上查询车辆状态。相同的模式适用于任何其他使用'使用 gov.br 登录的服务:
"""
Exemplo: Consulta de situação de veículo no Detran-MG
usando a sessão gov.br já autenticada.
"""
import asyncio
import os
from abrasio import Abrasio
from abrasio.utils import human_wait, human_scroll, human_click, simulate_reading
async def consultar_veiculo(placa: str, chassi: str) -> dict:
"""
Consulta a situação de um veículo no portal cidadão do MG.
Requer autenticação via gov.br (SSO).
Returns:
Dicionário com os dados do veículo retornados pela API do Detran.
"""
api_key = os.getenv("ABRASIO_API_KEY")
async with Abrasio(
api_key=api_key,
region="br",
device="desktop",
headless=False,
humanize=True,
) as browser:
page = await browser.new_page()
# Navegar para o portal cidadão — o gov.br SSO já está em sessão
await page.goto(
"https://cidadao.mg.gov.br/#/login",
wait_until="domcontentloaded"
)
await human_wait(5, 7)
# Aceitar cookies do portal
await page.locator(
"p-button:nth-child(2) > button"
).click()
# Clicar em "Entrar com gov.br"
await page.locator(".govBrBtn").wait_for(state="visible")
await page.locator(".govBrBtn").click()
# Navegar até "Veículos e Condutores (Trânsito)"
await page.wait_for_selector(
"//*[contains(text(), 'Veículos e Condutores (Trânsito)')]"
)
await page.locator(
"//*[contains(text(), 'Veículos e Condutores (Trânsito)')]"
).click()
await human_wait(2, 3)
await simulate_reading(page, 5, 10)
await human_scroll(page, 0, 2000)
# Clicar em "Situação do Veículo"
await human_click(page, "//*[contains(text(), 'Situação do Veículo')]")
await simulate_reading(page, 2, 4)
# Preencher placa e chassi com comportamento humano
await human_click(page, "#placa")
await human_wait(1, 2)
from abrasio.utils import human_type
await human_type(page, placa, "#placa")
await human_type(page, chassi, "#chassi")
# Interceptar a resposta da API antes de clicar em consultar
async with page.expect_response(
lambda r: "veiculos/situacao" in r.url,
timeout=90000
) as response_info:
await simulate_reading(page, 7, 15)
await page.locator("button[type='submit']").click()
response = await response_info.value
dados = await response.json()
if dados.get("mensagem") == "Acesso Negado":
raise PermissionError("Sessão expirada ou acesso negado pelo portal.")
return dados
if __name__ == "__main__":
async def main():
resultado = await consultar_veiculo(
placa="ABC1234",
chassi="9BWXX00X0XX000000",
)
import json
print(json.dumps(resultado, indent=2, ensure_ascii=False))
asyncio.run(main())关于 MFA
用这个可以构建什么
gov.br 的已认证会话是一系列之前不可能或需要持续人工干预的自动化的关键:
批量车辆查询
传入车牌和底盘号列表,自动获取每辆车的状态。非常适合调度员和运输公司。
驾照查询
通过在线 DETRAN 查询驾驶员的积分、有效期和类别。适用于物流和车队公司。
GRU/DARF 开具
为多个客户自动生成联邦缴款单,与会计系统集成。
证书提取
自动下载无债务证明、INSS 收据和其他文件,无需人工干预。
案件跟踪
监控使用 gov.br 作为认证的法院和州法律系统中的程序进展。
ERP 集成
用实时政府数据供给内部系统,消除手动查询和数据录入工作。