bb-extratos-mcp

> A inteligência definitiva para automação de BPO Financeiro com extratos do Banco do Brasil via IA.

Este projeto é um MCP (Model Context Protocol) de classe empresarial, especializado em extração e análise de dados bancários do BB. Projetado para operações robustas de BPO Financeiro, ele permite que IAs (Claude, ChatGPT) ou sistemas automatizados gerenciem conciliações com precisão cirúrgica.

• 🧠 Paginação Inteligente: Busca centenas de lançamentos automaticamente em loops otimizados.
• 🔐 mTLS de Elite: Conexão segura utilizando certificados .pem e .key.
• 📊 Análise de Fluxo: Dados normalizados prontos para conciliação bancária de alto nível.
• 🛠 Python Nativo: Código limpo, tipado e fácil de integrar em fluxos de automação financeira.

Empresas de BPO Financeiro perdem horas em exportações manuais de arquivos OFX/CSV. Esta Skill elimina o trabalho manual:

• Conciliação em Tempo Real: Conecte o extrato direto ao seu motor de decisão.
• Redução de Erro Humano: Dados extraídos via API oficial, sem intervenção manual.
• Escalabilidade: Gerencie múltiplas contas e empresas com a mesma estrutura de código.

Recomendamos o uso de um ambiente virtual:

python -m venv .venv
source .venv/bin/activate  # Linux/Mac
# ou
.venv\Scripts\activate     # Windows

pip install -r requirements.txt

Siga o guia em docs/EXTRACAO_CERTIFICADO.md para preparar seu .pem e .key.

BB_CLIENT_ID=seu_id
BB_CLIENT_SECRET=seu_secret
BB_DEVELOPER_KEY=sua_chave
BB_CERT_PATH=./certs/bb_certificate.pem
BB_KEY_PATH=./certs/bb_private_key.pem
BB