Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/jbms/finance-dl/llms.txt

Use this file to discover all available pages before exploring further.

The finance_dl.ebmud scraper downloads East Bay Municipal Utility District (EBMUD) water bills as PDF files using selenium and chromedriver. Each bill is saved with a filename derived from its bill date, keeping your utility archives neatly sorted. The PDFs are text-based and can be processed with pdftotext to extract billing details for use in automated accounting workflows.

​
Configuration Parameters

​
credentials
dict
required
A dictionary containing your EBMUD online account login credentials.
​
output_directory
string
required
Path on the local filesystem where PDF bill files will be saved. The directory is created automatically if it does not already exist.
​
profile_dir
string
Path to a persistent Chrome browser profile directory used exclusively for this scraper. Do not point this at your regular browser profile. When omitted, a fresh temporary profile is used on every run.

​
Output Format

Each bill is saved to output_directory as a PDF file named by its bill date: 
YYYY-MM-DD.bill.pdf
For example, a bill with a bill date of November 28, 2017 is saved as 2017-11-28.bill.pdf.
EBMUD bills are text-based PDFs. Run pdftotext 2017-11-28.bill.pdf to extract plain-text content for parsing with beancount-import or similar tools.

​
Config Example

def CONFIG_ebmud():
    return dict(
        module='finance_dl.ebmud',
        credentials={
            'username': 'XXXXXX',
            'password': 'XXXXXX',
        },
        output_directory=os.path.join(data_dir, 'ebmud'),
    )

​
Interactive Shell

From the finance-dl interactive shell, start the scraper with: 
self.run()

Build docs developers (and LLMs) love

Get started for freeTalk to us