Back to homepage

Guide

Getting Started

  1. Launch the InvoiceCrawler.exe application.
  2. Enter your Serial Key and your CapSolver API Key.
  3. After successful activation, the main interface will load.
 You need a CapSolver API Key to solve CAPTCHAs automatically. Register at capsolver.com and add credit.

Add Portal

  1. Go to the Portals page in the sidebar.
  2. Click on + Add Portal.
  3. Select the desired portal from the dropdown list.
  4. Enter your Email / Username and your Password.
  5. Save with Save.

OTP / Two-Factor Authentication

Some portals (e.g. Amazon, Cardmarket) require two-factor authentication (2FA) via TOTP.

  1. Find OTP Secret: When setting up 2FA for a portal, a Secret Key is displayed (often as QR code or text like JBSWY3DPEHPK3PXP). You need this key.
  2. Enter in Crawler: When adding the portal, fill in the TOTP Secret field with this key.
  3. Automatic: The crawler automatically generates the current 6-digit code at each login – no manual entry required.
 Tip: You can also add the OTP secret later by editing the portal. The secret is stored locally only and never transmitted.
 Important: If you have already set up 2FA with an authenticator app, you may need to disable and re-enable 2FA to get the secret. Also save the secret in your authenticator app as a backup.

IMAP Email Retrieval

For portals like MediaMarkt / Saturn, invoices are sent via email. The crawler retrieves them via IMAP.

  1. Select the portal (e.g. MediaMarkt) and enter your email credentials.
  2. Enter the IMAP server of your email provider (e.g. imap.gmail.com, imap.web.de).
  3. The crawler automatically searches for emails with invoice attachments.
 Gmail: Enable "Less secure app access" or create an App Password under myaccount.google.com → Security → App Passwords.

Custom Mail Crawler

For services that send invoices via email and don't have a dedicated scraper.

  1. Select Custom Invoice from Mail as portal.
  2. Enter your IMAP server, email and password.
  3. Subject Keyword: A keyword found in the subject of invoice emails (e.g. "invoice").
  4. Sender Email: The sender address of invoice emails (e.g. billing@example.com).
  5. PDF Keyword: A keyword in the PDF attachment filename (e.g. "invoice").
  6. Optional: Enable Move fetched to move retrieved emails to the SK_Fetched folder.

Scan & Download

  1. Go to Start Scraping in the sidebar.
  2. Select the time filter (e.g. "Last 6 months" or a specific year).
  3. Click Start for a single portal or use Scan All.
  4. Found documents appear under Documents.
  5. Select the desired documents and click Download Selected.
 Already downloaded documents are automatically detected and not downloaded again.