使用说明
🐍 BB Extratos Skill (MCP) - BPO Financeiro de Elite
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.
✨ Diferenciais da Skill (BPO Financeiro)
- 🧠 Paginação Inteligente: Busca centenas de lançamentos automaticamente em loops otimizados.
- 🔐 mTLS de Elite: Conexão segura utilizando certificados
.peme.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.
💼 Por que esta Skill para BPO?
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.
🚀 Como Começar (Quick Start)
1. Prepare o Ambiente
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
2. Extraia seu Certificado (mTLS)
Siga o guia em docs/EXTRACAO_CERTIFICADO.md para preparar seu .pem e .key.
3. Configure o .env
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_ENV=homologation
4. Execução de Teste
Valide a Skill com a massa de dados de homologação do BB:
python test_extrato.py
🛠️ Roadmap
- [x] Skill de Extratos (Leitura e Consumo para BPO Financeiro)
- [ ] Exportação Nativa para Pandas DataFrames (Análise de Cohort e Fluxo)
- [ ] Validação de Checksum de Lançamentos (Auditoria de BPO)
- [ ] Dashboard de Conciliação Automática via Streamlit
- [ ] Suporte a Múltiplas Contas com Gerenciador de Vault
5.Segurança & Privacidade
Nota de Compliance: Os certificados e chaves privadas são lidos exclusivamente em memória local. Este MCP não transmite credenciais para servidores externos. O fluxo de dados ocorre diretamente entre sua aplicação e os endpoints do Banco do Brasil via TLS 1.2+.
🤝 Créditos & Autoria
Desenvolvido com foco em alta performance e excelência em BPO Financeiro por Jhones Sena.
Professor e Desenvolvedor com vasta experiência em arquitetura de sistemas bancários e automação inteligente.
📄 Licença
Distribuído sob a licença MIT. Veja LICENSE para mais informações.