Skip to main content

bbscraper

Project description

Banco do Brasil Scraper

Scraper para baixar seus extratos do Banco do Brasil com um comando.

Como instalar

$ pip install bbscraper

Motivação

A ideia de fazer um scraper para o banco do brasil surgiu em um post do Henrique Bastos sobre como bancos ainda não oferecem uma forma fácil para seus clientes extraírem seus próprios dados. Algo tão simples quanto obter o seu extrato bancário é um sofrimento para sistematizar, como ele mesmo comenta no post.

Então ele resolveu fazer um scraper para o banco Itaú, o itauscraper, onde você encontrará as motivações do Henrique e a descrição do projeto do scraper do Itáu.

As minhas motivações foram colocar em prática o que eu estou aprendendo em python, contribuir com a comunidade e também por concordar com o Henrique nos pontos levantados.

Como funciona

O código usa Python 3.6 com a biblioteca request e o tabulate para formatar melhor a saída do extrato.

O Henrique comenta em seu post que durante sua pesquisa sobre a existia de algo pronto para o Itaú ele encontrou o bankscraper do Kamus que disponibiliza vários scripts interessantes. Então eu fui verificar e testar se o script do Banco do Brasil estava funcionado e não estava, mas era um problema simples na verificação do tamanho da conta e da agência. Eu criei esse projeto para organizar melhor o código do kamus baseado no itauscraper e tentar deixá-lo mais simples, não sei se consegui, mas fique a vontade para contribuir.

Para acessar os dados é usado a API mobile, então usando o requests.Session conseguimos simular que a requisição está sendo por uma aplicação mobile.

A classe BancodoBrasilScraper usa a session para realizar o login e consultar o extrato.

Como Usar

$ bbscraper --extrato --saldo  --agencia 12345 --conta 123456 
Digite sua senha do Banco do Brasil:

Ou:

$ bbscraper --extrato --saldo  --agencia 12345 --conta 123456 --senha SECRET

Para conhecer todas as opções:

$ bbscraper -h

Com Docker

$ docker build -t anderson89marques/bbscraper --no-cache .
$ docker container run -it anderson89marques/bbscraper:latest  bbscraper --extrato --saldo --agencia 12345 --conta 123456

Development

 git clone https://github.com/anderson89marques/bbscraper
 cd bbscraper

Sem docker
----------

python -m venv -p python3.6 .venv source .venv/bin/activate pip install -r requirements.txt


Com docker
-------
```console
$ docker build -t anderson89marques/bbscraper --no-cache .
$ docker run -it --rm --name my-running-script -v "$PWD":/usr/src/myapp -w /usr/src/myapp anderson89marques/bbscraper python -m bbscraper --extrato --agencia 12345 --conta 123456


Licença
-------

Copyright (C) 2018 Anderson Marques.

Este código é distribuído nos termos da "GNU LGPLv3". Veja o arquivo LICENSE para detalhes.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

bbscraper-1.2.tar.gz (8.3 kB view details)

Uploaded Source

Built Distribution

bbscraper-1.2-py3-none-any.whl (20.4 kB view details)

Uploaded Python 3

File details

Details for the file bbscraper-1.2.tar.gz.

File metadata

  • Download URL: bbscraper-1.2.tar.gz
  • Upload date:
  • Size: 8.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: python-requests/2.19.1

File hashes

Hashes for bbscraper-1.2.tar.gz
Algorithm Hash digest
SHA256 eafcb5286bd69a0653d3992ee0dd25b8675b22aa0eb10647721bbff0219e9afe
MD5 c684e19e965f9958b5d9f71e589ee307
BLAKE2b-256 8afbc5863a73b997c8047ec146c1ac4bb5068edd4d8c26189dc099e93dc7f94d

See more details on using hashes here.

File details

Details for the file bbscraper-1.2-py3-none-any.whl.

File metadata

  • Download URL: bbscraper-1.2-py3-none-any.whl
  • Upload date:
  • Size: 20.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: python-requests/2.19.1

File hashes

Hashes for bbscraper-1.2-py3-none-any.whl
Algorithm Hash digest
SHA256 b20a1af6ded5c3cf116c6a7ed652712168cd54558dbb09483de89752e8dc2071
MD5 b0df4b8543038ca69a75ec92564bc994
BLAKE2b-256 d3f466b27ed6561d99e4883f8b4ac30bfedc1e03fc059d7ce3f4adc95ef232f6

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page