Downloads transactions and balances from online banking websites using Zombie.js.
This is a command-line script that downloads transactions and balances from financial institutions using Zombie.js. Currently supported banks:
Avadian Credit Union (formerly Alabama Telco Credit Union)
Credit unions handled by the new Fiserv software (if your online banking URL
Credit unions handled by the old Fiserv software (if your online banking URL
Please help add your bank! See below for details.
Install Node.js, then:
sudo npm install -g bankerbanker --help
banker --config config.json --output data/results.json
banker --help shows documentation for other command-line options:
Usage: banker optionsOptions:-b, --banks Just list the banks that this program can downloadinformation from.-l, --list Just list the banks and accounts in the given configfile.--describe-output Just list the banks and accounts in the given outputfile.-c, --config The JSON config file(s) describing the banks andaccounts to process.-o, --output The JSON output file with transaction details.-s, --skip Skip the specified bank(s) or account(s).--only Only process the specified bank(s) or account(s) - see--list for valid specifiers.-d, --debug-browser Save pages fetched by the browser (to the same directoryas the output file).-v, --verbose Increase verbosity (up to -vvv).Config filename is required unless '--banks' is specified.
Note that if you are using the
--debug-browser option, you should put the
--output file in its own directory, since the program will dump a bunch of
HTML pages in the same directory. (The directory will be created if it doesn't
Create a JSON configuration file (
config.json above) that contains a bank
configuration or an array of bank configurations. Bank configurations usually
need to contain the following items, see the output of
banker --banks for
exact settings required for a given bank.
bankName - the name of the bank. This should be the name of the
lib/banks without the
username - your online banking username.
password - your online banking password.
securityQuestions - a hash of security questions and answers, like this:
"securityQuestions" :"What is your favorite color?" : "Black"
accounts - a list of account configurations. The required items vary by
bank - use the output of
banker --banks to determine which fields are
If you are using the
--debug-browser option, specify a
filename field for
each account, and this value will appear in the filenames of the HTML pages
the program saves.
Also, any additional data that you include in the account configurations will appear in the output file, so you can use this to pass identifier fields etc.
See the output of
banker --banks or the files in the
configs directory for
more details about the configuration file.
The program will write a JSON file to the path specified after
the following structure:
// object for first bank data"bank" : // bank name"status" : // may contain a message like "skipped""error" : // the error message for this bank, if any"data" : // list of data objects, one for each account// account information (copied from config file)"account" :// ...// transactions downloaded from this bank"transactions" :"date" : // self-explanatory"amount" : // self-explanatory"description" : // self-explanatory"memo" : // like a "sub-description" (if any)"images" : /* any images downloaded for thistransaction (encoded as a data: url) */"sourceId" : /* transaction ID, from bank orgenerated from other fields */// (transaction objects may also contain other fields)// ... (more transactions)// balances downloaded from this bank"balances" :"actual" : // latest posted balance"available" : // available balance"fromList" : /* balance from transaction list (hint: it'sworth checking if this matches the otherbalances since some bank software is buggy) */// ... (data objects for more banks)
To add a new bank, write a driver for it and put it in the
directory. The filename of the driver will be the string used to specify that
bank in a config file.
Drivers should inherit from
lib/banks/base.js) and should
define the following methods:
// For documentation, return an object like this:returndescription : // Bank descriptionconfigItems : // Bank configuration itemsaccountItems : // Configuration items needed for each account;;// Try to log in to the bank website, then call:// - cb(err) on failure// - cb(null) on success;// Try to get transactions from the given account, and call cb(err) on// failure or cb(data) on success, where data is an object like this:var data =transactions : // List of transactions downloaded from this bank, in// the same format as the output file described abovebalances : // Balances downloaded from this bank;;// Try to log out of the bank website, then call:// - cb(err) on failure// - cb(null) on success;
Finally, drivers should export themselves as
moduleexports = MyBankSession;