- Python 84.4%
- HTML 10.6%
- Typst 4.8%
- Shell 0.2%
- _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 |
||
|---|---|---|
| Anschreiben-duisport | ||
| auto_cv | ||
| Basic-CV | ||
| templates | ||
| tests | ||
| .gitignore | ||
| Basic-CV-1.pdf | ||
| dashboard.html | ||
| fix_cleanlaser.py | ||
| generate_applications.sh | ||
| README.md | ||
| requirements.txt | ||
| run_initiative.py | ||
| show_env.py | ||
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.csvmit 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-aibenutzen, wenn du das Anschreiben selbst schreiben willst- Oder den generierten Text in
data/output/<Firma>_<Stelle>/job_data_raw.ymllesen und ggf. nachbearbeiten
Setup
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
KI-Backend konfigurieren (per .env)
⚠️ Agent-Regel:
.envniemals mit demread-Tool direkt auslesen — Secrets landen im Chat-Verlauf. Stattdessenpython show_env.pyverwenden (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
.envwird automatisch beim Start geladen — kein manuellesexportnö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-StackBasic-CV/image-autoedit-crop.png: Dein Bewerbungsfoto (wird ins CV eingebunden)templates/cv.typ: Lebenslauf-Templatetemplates/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 |