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.comcast scraper downloads Comcast (Xfinity) monthly bills as PDF files using selenium and chromedriver. Each bill is saved with a filename derived from its bill date for easy sorting and archiving. Like other utility bill scrapers in finance-dl, the downloaded PDFs are text-based and can be processed with pdftotext to extract data for automated accounting pipelines.

​
Configuration Parameters

​
credentials
dict
required
A dictionary containing your Comcast (Xfinity) 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.
Comcast 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_comcast():
    return dict(
        module='finance_dl.comcast',
        credentials={
            'username': 'XXXXXX',
            'password': 'XXXXXX',
        },
        output_directory=os.path.join(data_dir, 'comcast'),
    )

​
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