No description
  • Python 84.4%
  • HTML 10.6%
  • Typst 4.8%
  • Shell 0.2%
Find a file
silverscaleclockwork 6bd42c807f fix(contact_finder): verhindere Phantom-Bounces durch MX-Validierung
- _guess_emails(): prüft jetzt DNS-MX-Record bevor jobs@domain geraten wird
- _guess_emails(): gibt maximal 1 geratene Adresse zurück (statt 13)
- _domain_exists(): prüft zusätzlich MX als Fallback auf A-Record
- find_public_hr_contacts(): keine E-Mail-Raterei mehr bei unerreichbaren Websites
- verhindert ~150 Bounces durch erfundene jobs@...-Adressen
2026-10-18 23:02:21 +02:00
Anschreiben-duisport first full auto 2026-09-20 17:35:56 +02:00
auto_cv fix(contact_finder): verhindere Phantom-Bounces durch MX-Validierung 2026-10-18 23:02:21 +02:00
Basic-CV first full auto 2026-09-20 17:35:56 +02:00
templates first full auto 2026-09-20 17:35:56 +02:00
tests Remove __pycache__ from tracking and add dnspython to requirements 2026-10-07 12:51:01 +02:00
.gitignore adjustments in job and mail search 2026-09-27 03:35:29 +02:00
Basic-CV-1.pdf first full auto 2026-09-20 17:35:56 +02:00
dashboard.html first full auto 2026-09-20 17:35:56 +02:00
fix_cleanlaser.py adjustments in job and mail search 2026-09-27 03:35:29 +02:00
generate_applications.sh first full auto 2026-09-20 17:35:56 +02:00
README.md adjustments in job and mail search 2026-09-27 03:35:29 +02:00
requirements.txt Remove __pycache__ from tracking and add dnspython to requirements 2026-10-07 12:51:01 +02:00
run_initiative.py first full auto 2026-09-20 17:35:56 +02:00
show_env.py adjustments in job and mail search 2026-09-27 03:35:29 +02:00

Auto-CV Pipeline

Automatisierte Bewerbungsgenerierung für deutsche Stellenanzeigen.

Features

  • Job-Quellen: BA Jobsuche API (Bundesagentur für Arbeit — größte Stellendatenbank Deutschlands), Arbeitsagentur, Indeed, generische Websites (HTML/JSON-LD), Arbeitnow API (DACH), RemoteOK API (global remote)
  • Kontakt-Finder: Findet öffentliche HR-Kontakte (Impressum, Jobs-Seiten) und E-Mails
  • OpenStreetMap-Suche: Indexiert Unternehmen im Umkreis (z. B. 25 km) – ideal für Initiativbewerbungen
  • KI-Anschreiben: OpenAI-compatible APIs (OpenRouter, OpenAI) oder Ollama (lokales LLM)
  • Typst-PDFs: Erzeugt einseitige A4-PDFs (Lebenslauf + Anschreiben) aus deinen Templates
  • CSV-Export: Zentrale applications.csv mit allen relevanten Kontaktdaten
  • Full Automation: Cron-fähiger auto-Befehl mit SQLite-State, Rate-Limiting, Stealth-Delays

⚠️ Wichtig: KI-Text immer prüfen!

Die Generierung funktioniert technisch, aber jeder AI-generierte Text muss vor dem Absenden auf sinnvollen Bezug zur Firma geprüft werden.

Beispiel eines Fehlers: Bei EGOSOFT (Entwickler der X-Series/Spiele) hat das LLM den Begriff "X-Universe-Spiele" erkannt, aber trotzdem über Elasticsearch-Optimierung und Data-Mining geschrieben — Fähigkeiten, die für eine Game-Dev-Bewerbung absurd klingen. Die KI "press-fit-tet" immer deinen Tech-Stack in den Text, unabhängig davon, ob er zur Branche passt.

Empfehlung:

  • --skip-ai benutzen, wenn du das Anschreiben selbst schreiben willst
  • Oder den generierten Text in data/output/<Firma>_<Stelle>/job_data_raw.yml lesen und ggf. nachbearbeiten

Setup

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

KI-Backend konfigurieren (per .env)

⚠️ Agent-Regel: .env niemals mit dem read-Tool direkt auslesen — Secrets landen im Chat-Verlauf. Stattdessen python show_env.py verwenden (Werte werden maskiert).

Lege im Projekt-Root eine .env an:

# Option A: OpenRouter (empfohlen, günstig, viele Modelle)
OPENROUTER_API_KEY=sk-or-v1-...
OPENAI_BASE_URL=https://openrouter.ai/api/v1
OPENAI_MODEL=openai/gpt-3.5-turbo

# Option B: Ollama (lokal, kostenlos, benötigt starke Hardware)
# OLLAMA_MODEL=phi4
# OLLAMA_HOST=http://localhost:11434

.env wird automatisch beim Start geladen — kein manuelles export nötig.

SMTP für automatisches Versenden (optional)

Nur nötig, wenn du --enable-email beim auto-Befehl nutzen willst:

SMTP_HOST=smtp.gmail.com
SMTP_PORT=587
SMTP_USER=deine.email@gmail.com
SMTP_PASSWORD=dein-app-passwort
SMTP_FROM=deine.email@gmail.com
SMTP_FROM_NAME="Tobias Köpke"

Verwendung

Bewerbung aus einer Stellenanzeige

python -m auto_cv apply "https://www.arbeitsagentur.de/jobsuche/jobdetail/..."

Optionen:

  • --skip-ai: Keine KI-Generierung, Template wird nur mit Platzhalter gefüllt
  • --model <name>: Modell überschreiben (z. B. meta-llama/llama-3.1-8b-instruct)
  • --base-url <url>: API-Base-URL überschreiben
  • --api-key <key>: API-Key direkt als Parameter
  • --greeting "Sehr geehrte Damen und Herren": Anrede anpassen

Beispiel mit OpenRouter:

python -m auto_cv apply "https://..." \
  --model "openai/gpt-3.5-turbo" \
  --base-url "https://openrouter.ai/api/v1" \
  --api-key "$OPENROUTER_API_KEY"

Jobs über APIs suchen (schnell, kein Scraping)

BA Jobsuche (offizielle Arbeitsagentur API — höchste Priorität)

# Nur CSV-Log
python -m auto_cv jobsuche --was "softwareentwickler" --wo "Berlin" --max-pages 2

# Mit PDF-Generierung pro Treffer
python -m auto_cv jobsuche --was "php entwickler" --wo "Aachen" --generate --max-pages 2
  • --was: Suchbegriff (Stellentitel / Keywords)
  • --wo: Standortfilter (Stadt, Region, PLZ)
  • --berufsfeld: Berufsfeld-Filter
  • --max-pages: Wie viele API-Seiten geholt werden
  • --size: Treffer pro Seite, max. 100 (Standard: 25)
  • --include-detail: Vollständige Stellenbeschreibungen abrufen (Standard: true)

Arbeitnow (DACH-Markt, 250 Jobs/Seite)

# Nur CSV-Log (empfohlen für große Mengen)
python -m auto_cv arbeitnow --search "software developer" --tags "berlin" --max-pages 1

# Mit PDF-Generierung pro Treffer (kostet LLM-Tokens!)
python -m auto_cv arbeitnow --search "php entwickler" --tags "remote" --generate --max-pages 1
  • --search: Freitext-Suchbegriff
  • --tags: Komma-getrennte Tags (z. B. berlin,developer)
  • --max-pages: Wie viele API-Seiten geholt werden (×250 Jobs)
  • --generate: Für jeden Job PDFs erzeugen (ohne dies nur CSV-Log)

RemoteOK (weltweite Remote-Jobs, 100 Jobs/Abfrage)

# Nur CSV-Log
python -m auto_cv remoteok --tag "dev"

# Mit PDF-Generierung
python -m auto_cv remoteok --tag "php" --generate
  • --tag: Einzelnes Tag-Filter (z. B. dev, php, javascript)

Hinweis: RemoteOK liefert primär internationale Jobs. Die KI schreibt trotzdem auf Deutsch, aber der Empfänger sollte ggf. angepasst werden.

Initiativbewerbungen – Unternehmen in der Nähe finden

python -m auto_cv search --zip 52134 --radius 25 --deep
  • --radius: Umkreis in km (Standard: 25)
  • --deep: Besucht gefundene Webseiten und extrahiert Impressum/Job-Seiten

Mit --deep entstehen viele Web-Requests — du siehst einen Fortschrittszähler pro Firma.

Beispiel-Ausgabe:

[OSM] Searching 25.0km around 50.86392, 6.09836
[OSM] Found 147 potential employers in 3.2s
  [1/147] Musterfirma GmbH
        Probing https://musterfirma.de ...
        ✓ Website OK — 2 email(s), has_jobs_page=True
  [2/147] Firma ohne Website — skipped (no website)
  ...
==================================================
Search complete
  Total companies found:   147
  Successfully probed:     89
  Probes failed:           12
  Skipped (no website):    46
  Data written to:         data/output/applications.csv
==================================================

Full Automation (cron-fähig)

Der auto-Befehl orchestriert alle Quellen in Prioritätsreihenfolge: BA Jobsuche → Arbeitnow → RemoteOK → OSM. Er respektiert ein tägliches Rate-Limit (Standard: 50), schreibt alles in eine SQLite-DB (data/state.db) und fügt zufällige Delays ein.

# Nur BA Jobsuche (empfohlen für deutsche Stellen)
python -m auto_cv auto \
  --quota 5 \
  --jobsuche-was "softwareentwickler" \
  --jobsuche-wo "Berlin" \
  --jobsuche-pages 2

# Kombination mehrerer Quellen
python -m auto_cv auto \
  --quota 5 \
  --jobsuche-was "php" \
  --arbeitnow-search "php" \
  --arbeitnow-pages 1

# Trockenlauf ohne E-Mails (Standard)
python -m auto_cv auto \
  --quota 5 \
  --jobsuche-was "software developer" \
  --jobsuche-pages 2 \
  --arbeitnow-search "software" \
  --arbeitnow-pages 1 \
  --remoteok-tag "dev"

# Mit E-Mail-Versand (NUR mit expliziter Bestätigung!)
python -m auto_cv auto \
  --quota 5 \
  --enable-email \
  --jobsuche-was "software entwickler" \
  --jobsuche-pages 2

# Inklusive OSM-Initiativbewerbungen
python -m auto_cv auto \
  --quota 10 \
  --enable-osm \
  --zip 52134 --radius 25 \
  --jobsuche-was "software" \
  --jobsuche-pages 1

Parameter (BA Jobsuche — höchste Priorität):

  • --jobsuche-was: Suchbegriff (Stellentitel / Keywords)
  • --jobsuche-wo: Standortfilter (Stadt, PLZ, Region)
  • --jobsuche-berufsfeld: Berufsfeld-Filter
  • --jobsuche-pages: Wie viele Seiten scannen (0=auto, Standard: 0)
  • --jobsuche-size: Ergebnisse pro Seite (Standard: 25, max. 100)

Parameter (Arbeitnow):

  • --arbeitnow-search, --arbeitnow-tags, --arbeitnow-pages: Arbeitnow-Filter

Parameter (RemoteOK):

  • --remoteok-tag: RemoteOK-Tag-Filter

Cron-Beispiel (täglich um 9 Uhr):

0 9 * * * cd /home/codedemon/Documents/bewerbung/auto-cv && /home/codedemon/Documents/bewerbung/auto-cv/.venv/bin/python -m auto_cv auto --quota 10 --jobsuche-was "software entwickler" --jobsuche-pages 2 >> /tmp/auto_cv.log 2>&1

State-Datenbank

data/state.db (SQLite) trackt:

Tabelle Zweck
jobs Alle entdeckten Jobs/Firmen mit Status (new, applied, failed, skipped)
applications Generierte PDFs pro Job
emails_sent Versendete E-Mails mit Zeitstempel
daily_quota Tägliches Rate-Limit
api_scans Bereits gescannte API-Seiten (Dedup, <2h Cache)

Deduplizierung: Jobs werden anhand einer eindeutigen slug (z. B. arbeitnow_slug-123) identifiziert. Bereits verarbeitete Jobs werden übersprungen.

Wo die Daten landen

Sowohl apply, arbeitnow, remoteok, search als auch auto schreiben in die gleiche CSV-Datei:

data/output/applications.csv

Diese Datei wächst mit jedem Aufruf (append-only). Sie enthält alle deine Leads:

Spalte Bedeutung
company Firmenname
job_title Stellenbezeichnung oder "Initiativbewerbung"
source URL der Stellenanzeige, API-Name oder "OpenStreetMap"
address Adresse (aus Impressum oder OSM)
website Firmenwebsite
email Gefundene E-Mail (priorisiert: jobs@ > info@ > andere)
hr_name Gefundener Ansprechpartner im Impressum (optional)
has_jobs_page true wenn eine Karriere-/Jobs-Seite existiert
job_page_url Direktlink zur Jobs-Seite (falls gefunden)
generated_cv Pfad zur generierten Lebenslauf-PDF
generated_cover_letter Pfad zur generierten Anschreiben-PDF

Für Stellenanzeigen (apply, und die API-Commands mit --generate) werden zusätzlich PDFs erzeugt:

data/output/<Firma>_<Stellenbezeichnung>/
├── <Firma>_<Stellenbezeichnung>_CV.pdf
└── <Firma>_<Stellenbezeichnung>_Anschreiben.pdf

search generiert keine PDFs — es schreibt nur die CSV-Zeilen.

Stealth & Anti-Bot-Schutz

  • Zufällige Delays zwischen Requests (1,5–6 Sekunden, mit Jitter)
  • Rotierende User-Agents (Chrome, Firefox, verschiedene OS)
  • Honeypot-Detection: Erkennt versteckte Formularfelder (Score-basiert)
  • API-Scan-Caching: API-Seiten werden nur alle 2 Stunden neu abgefragt
  • Rate-Limiting: Maximal N Anwendungen pro Tag (konfigurierbar)

Daten und Templates anpassen

  • data/cv_data.yml: Deine persönlichen Daten, Ausbildung, Tech-Stack
  • Basic-CV/image-autoedit-crop.png: Dein Bewerbungsfoto (wird ins CV eingebunden)
  • templates/cv.typ: Lebenslauf-Template
  • templates/cover_letter.typ: Anschreiben-Template (DIN-5008-ähnliches Geschäftsbrief-Layout)

Wichtig: Fonts

Die Templates nutzen FreeSans und FreeMono. Falls du Barlow/DejaVu installiert hast, kannst du die Font-Namen in templates/*.typ tauschen.

Tests

source .venv/bin/activate
pytest tests/ -v

Architektur (kurz)

auto-cv/
├── auto_cv/
│   ├── cli.py              # Einstiegspunkt (apply / search / jobsuche / arbeitnow / remoteok / auto)
│   ├── scraper.py          # Job-Scraper (Generic, Arbeitsagentur, Indeed)
│   ├── ba_jobsuche_scraper.py  # BA Jobsuche API Client (offizielle Arbeitsagentur)
│   ├── arbeitnow_scraper.py # Arbeitnow API Client
│   ├── remoteok_scraper.py  # RemoteOK API Client
│   ├── osm_search.py       # Overpass API (OpenStreetMap)
│   ├── contact_finder.py   # Web-Crawler für HR-Kontakte
│   ├── ai_writer.py        # OpenAI / Ollama Integration
│   ├── typst_generator.py  # YAML → Typst → PDF
│   ├── csv_exporter.py     # CSV-Log
│   ├── state.py            # SQLite State DB (Dedup, Quota, History)
│   ├── stealth.py          # Delays, UA-Rotation, Honeypot-Detektion
│   ├── sender.py           # SMTP-Versand
│   └── auto_runner.py      # Orchestration für `auto`-Befehl
├── templates/
│   ├── cv.typ              # Lebenslauf-Template (zweiseitig A4)
│   └── cover_letter.typ    # Anschreiben-Template (einseitig A4)
├── data/
│   ├── cv_data.yml         # Deine Stammdaten
│   └── output/             # Generierte PDFs + applications.csv
├── .env                    # API-Keys (nicht ins Repo committen! Niemals raw auslesen — show_env.py verwenden)
└── tests/                  # pytest-Suite

Common Issues

Problem Lösung
No endpoints found for anthropic/claude-3.5-sonnet Modell auf OpenRouter nicht verfügbar → --model openai/gpt-3.5-turbo
Anschreiben läuft auf 2 Seiten KI-Text zu lang → Template wurde optimiert, aber bei >250 Wörtern manuell kürzen
KI-Text passt nicht zur Firma --skip-ai nutzen, Text selbst schreiben
Failed to connect to Ollama Kein Fallback von OpenAI → .env prüfen oder Ollama starten
API-Quelle liefert keine Ergebnisse Tags/Suchbegriff anpassen, oder --max-pages erhöhen
SMTP sendet nicht SMTP_HOST, SMTP_USER, SMTP_PASSWORD in .env prüfen