PlaybookAbrasio
Abrasiogov.br自动化反机器人中级

如何自动化 gov.br 登录(以及为什么所有爬虫都在你之前失败)

gov.br 使用 hCaptcha、浏览器指纹识别和 IP 封锁。Playwright、Selenium 和 Puppeteer 会静默失败。本教程展示如何使用 Abrasio 解决所有这些问题,并获得一个已认证的会话——可用于车辆查询、文件提取和表单填写。

2026年4月8日12 分钟阅读作者:Scrape Technology

没人公开谈论的问题

每周,都有开发者或数据分析师尝试在 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 的新会话——这些模式中的任何一个都会触发警报。

Fingerprint

为什么 Playwright、Selenium 和 Puppeteer 失败

看看使用传统自动化会发生什么:

playwright_falha.py
# 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 已经分析了指纹并做出了决定。没有视觉反馈,没有错误消息——表单就是不会继续。

Bloqueio

封锁不是永久的

gov.br 不会无限期封禁用于传统自动化的 IP。它只是不推进登录流程。循环是无声的:你尝试,什么都没发生,你再试,什么都没发生。

解决方案:Abrasio

Abrasio 是专门为这类场景构建的浏览器服务。它结合三种技术来绕过这些防御:

指纹修补的 Chromium

一个修改过的 Chromium,其中 navigator.webdriver 被移除,WebGL 和 Canvas 字符串接收真实的噪声,HTTP headers 被规范化,默认插件存在。数字签名与真实 Chrome 相同。

巴西住宅 IP

默认情况下,每个会话使用 BR 地区的住宅 IP。gov.br 看到的是来自巴西公民的正常连接,而不是服务器。

人类行为模拟

human_type()、human_wait()、human_scroll() 和 simulate_reading() 函数复制真实用户模式:按键延迟变化、贝塞尔曲线鼠标移动、操作间随机暂停。

Fingerprint

Fingerprint

Login bem-sucedido

教程

你需要一个 Abrasio API key。在文章末尾免费创建你的。

1

安装

通过 pip 安装 Abrasio SDK:

terminal
pip install abrasio

将你的 API key 配置为环境变量。你可以在你的 Abrasio 控制台:

terminal
export ABRASIO_API_KEY=abr_live_sua_chave_aqui

永远不要把 API key 写在代码里

始终使用环境变量或密钥管理器。该密钥可以访问你的账户和请求余额。
2

gov.br 登录

gov.br 登录流程有三个步骤:CPF → 密码 → MFA 代码(认证器或短信)。以下代码将此流程封装在一个函数中,返回已认证的会话 cookies:

govbr_login.py
"""
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 上的已认证会话 cookie 列表。有了这些 cookies,你可以浏览任何使用 gov.br SSO 的服务——DETRAN、联邦税务局、INSS、州门户——而无需再次登录。
3

真实示例:车辆状态查询

有了已认证的会话,看看如何在米纳斯吉拉斯州公民门户上查询车辆状态。相同的模式适用于任何其他使用'使用 gov.br 登录的服务:

consulta_veiculo.py
"""
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 在每个新会话都需要双因素认证。在生产自动化中,你有两个选择:集成 TOTP 认证器(使用账户的密钥)以编程方式生成代码,或使用持久配置文件配置 Abrasio——这样会话被复用,MFA 只在会话过期后才会再次请求。

用这个可以构建什么

gov.br 的已认证会话是一系列之前不可能或需要持续人工干预的自动化的关键:

批量车辆查询

传入车牌和底盘号列表,自动获取每辆车的状态。非常适合调度员和运输公司。

驾照查询

通过在线 DETRAN 查询驾驶员的积分、有效期和类别。适用于物流和车队公司。

GRU/DARF 开具

为多个客户自动生成联邦缴款单,与会计系统集成。

证书提取

自动下载无债务证明、INSS 收据和其他文件,无需人工干预。

案件跟踪

监控使用 gov.br 作为认证的法院和州法律系统中的程序进展。

ERP 集成

用实时政府数据供给内部系统,消除手动查询和数据录入工作。

立即开始使用 Abrasio

免费创建你的 API key,在不到 5 分钟内运行本教程的代码。