Jobportale scannen

Diese Anleitung zeigt dir, wie du portals.yml einrichtest und den Portal-Scanner startest, um automatisch neue Stellen zu finden.

portals.yml einrichten

portals.yml ist die Datei, die festlegt, wonach der Scanner sucht und wo. Du erstellst sie einmal aus der mitgelieferten Vorlage und passt sie dann an deine Zielrollen an.

Führe diesen Befehl im Projektordner aus:

cp templates/portals.example.yml portals.yml

Öffne portals.yml in einem beliebigen Texteditor. Die Datei hat drei Abschnitte. Die folgenden Schritte gehen sie einzeln durch.

Titelfilter konfigurieren

Über den Titelfilter entscheidet der Scanner, ob eine Stelle es wert ist, dir angezeigt zu werden. Er gleicht den Stellentitel mit zwei Keyword-Listen ab.

Such den Abschnitt title_filter weit oben in der Datei:

title_filter:
  positive:
    - "AI"
    - "ML"
    - "Product Manager"
  negative:
    - "Junior"
    - "Intern"
  seniority_boost:
    - "Senior"
    - "Staff"
    - "Lead"

Ersetze die positive-Liste durch Keywords, die zu deinen Zielrollen passen. Eine Stelle muss mindestens ein Keyword aus dieser Liste treffen, um durchzukommen. Groß- und Kleinschreibung spielen keine Rolle, "AI" erfasst also auch "ai engineer".

Ersetze die negative-Liste durch Keywords, die eine Stelle ausschließen. Taucht eines davon im Titel auf, wird die Stelle übersprungen – auch wenn sie ein positives Keyword getroffen hat.

Lass seniority_boost unverändert, es sei denn, du willst Senioritätsstufen hinzufügen oder entfernen. Diese Keywords filtern nichts heraus – sie schieben passende Stellen in den Ergebnissen nur weiter nach oben.

Beispiel: Wenn du nach Rails-Engineering-Rollen suchst, könnte dein Filter so aussehen:

title_filter:
  positive:
    - "Rails"
    - "Ruby"
    - "Full Stack"
    - "Backend"
  negative:
    - "Junior"
    - "Intern"
    - "PHP"
    - "Java"
  seniority_boost:
    - "Senior"
    - "Staff"
    - "Lead"

Unternehmen zum Beobachten hinzufügen

Der Abschnitt tracked_companies ist eine Liste bestimmter Unternehmen, die der Scanner bei jedem Lauf prüfen soll. Der Scanner geht direkt auf die Karriereseite jedes Unternehmens und liest die offenen Stellen aus.

Such den Abschnitt tracked_companies weiter unten in der Datei. Jeder Eintrag sieht so aus:

tracked_companies:
  - name: Anthropic
    careers_url: https://job-boards.greenhouse.io/anthropic
    api: https://boards-api.greenhouse.io/v1/boards/anthropic/jobs
    enabled: true

  - name: OpenAI
    careers_url: https://openai.com/careers
    enabled: true

Um ein Unternehmen hinzuzufügen, kopierst du einen vorhandenen Eintrag und änderst die Werte:

Um die careers_url eines Unternehmens zu finden, geh auf die Website des Unternehmens, klick auf „Careers“, „Karriere“ oder „Jobs“ und kopier die URL der Seite, auf der die offenen Stellen aufgelistet sind. Das ist die URL, die du brauchst.

Um ein Unternehmen zu deaktivieren, ohne es zu löschen, setz enabled: false:

  - name: Stripe
    careers_url: https://stripe.com/jobs/search
    enabled: false

Suchanfragen prüfen

Der Abschnitt search_queries führt breitere Websuchen aus, um Stellen bei Unternehmen zu finden, die nicht auf deiner Beobachtungsliste stehen. Die Vorlage enthält bereits viele fertige Suchanfragen.

Für den Einstieg musst du an diesem Abschnitt nichts ändern. Die fertigen Suchanfragen decken große Jobbörsen ab, darunter Greenhouse und Ashby.

Wenn du sie anpassen willst: Jede Suchanfrage sieht so aus:

search_queries:
  - name: Greenhouse — Rails Engineer
    query: 'site:job-boards.greenhouse.io "Rails Engineer" OR "Ruby on Rails" remote'
    enabled: true

Um eine Suchanfrage abzuschalten, die du nicht brauchst, setz enabled: false. Um eine neue hinzuzufügen, kopier einen vorhandenen Eintrag, gib ihm einen neuen name und pass den query-Text an.

Einen Scan starten

Es gibt zwei Wege, einen Scan zu starten. Nimm den, der zu dem passt, was du brauchst.

Option A – Das Script direkt ausführen

npm run scan

Führe das im Projektordner aus. Das Script liest portals.yml, fragt die API jedes Unternehmens direkt ab und schreibt neue Stellen in data/pipeline.md. Es verbraucht keine KI-Tokens und ist in etwa 30 Sekunden durch.

Diese Option funktioniert bei jedem Unternehmen, dessen Karriereseite auf einer Plattform läuft, für die der Scanner einen eingebauten Provider hat: Greenhouse, Ashby und Lever sowie Dutzende weitere Bewerbermanagementsysteme (ATS) und Jobbörsen wie Workable, Workday und SmartRecruiters. Die vollständige Liste steht in SUPPORTED_JOB_BOARDS.md. Unternehmen ohne passenden Provider werden übersprungen, und der Scan meldet, wie viele es sind.

Ergebnisse vor dem Speichern ansehen:

npm run scan -- --dry-run

Damit läuft der komplette Scan, ohne dass etwas auf die Festplatte geschrieben wird. So kannst du deine Filtereinstellungen prüfen, bevor du Ergebnisse übernimmst.

Ein einzelnes Unternehmen scannen:

npm run scan -- --company Anthropic

Ersetze Anthropic durch einen beliebigen Unternehmensnamen aus deiner tracked_companies-Liste. Groß- und Kleinschreibung spielen dabei keine Rolle.

Option B – Den KI-gestützten Scan in Claude Code starten

Öffne Claude Code im Projektordner und gib ein:

/career-ops scan

Diese Variante ruft die Karriereseite jedes Unternehmens direkt mit einem Browser auf und funktioniert daher auch bei Unternehmen ohne öffentliche API. Außerdem führt sie die search_queries aus deiner portals.yml aus, um Stellen bei Unternehmen zu finden, die nicht auf deiner Beobachtungsliste stehen.

Nimm diese Option, wenn:

• ein Unternehmen auf deiner Liste eine Plattform nutzt, für die das Script keinen Provider hat, sodass der Script-Scan es überspringt
• du neue Unternehmen entdecken und nicht nur bekannte prüfen willst
• der Script-Scan etwas übersehen hat, das du erwartet hättest

Die Scan-Ausgabe lesen

Wenn der Scan fertig ist, siehst du eine Zusammenfassung wie diese:

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Portal Scan — 2026-04-13
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Companies scanned:     42
Total jobs found:      318
Filtered by title:     291 removed
Duplicates:            4 skipped
New offers added:      23

New offers:
  + Anthropic | AI Engineer | San Francisco, CA
  + ElevenLabs | Solutions Architect | Remote
  ...

→ Run /career-ops pipeline to evaluate new offers.

Das bedeuten die einzelnen Zeilen:

Steht bei New offers added eine 0, ist dein Titelfilter vielleicht zu streng. Füg deiner positive-Liste ein Keyword hinzu und starte den Scan erneut.

Wo neue Stellen landen: Jede neue Stelle wird als Zeile in data/pipeline.md eingetragen. Das ist die Liste der Stellen, die auf ihre Bewertung warten.

Wofür data/scan-history.tsv da ist: Jede URL, die der Scanner sieht – ob hinzugefügt, gefiltert oder übersprungen –, wird hier protokolliert. So verhindert der Scanner, dass er dir dieselbe Stelle bei künftigen Scans zweimal zeigt. Diese Datei musst du nicht bearbeiten.

Neue Stellen aus einem Scan bewerten

Nachdem ein Scan neue Stellen in data/pipeline.md – deine Liste der noch ausstehenden Stellenangebote – eingetragen hat, führst du den pipeline-Befehl aus, um jede davon mit deinem Profil abzugleichen. In diesem Schritt liest Claude die Stellenbeschreibung, vergleicht sie mit deiner cv.md und modes/_profile.md und erstellt für jede Rolle eine bewertete Zusammenfassung.

Öffne Claude Code im Projektordner und gib ein:

/career-ops pipeline

Claude liest jede ausstehende URL in data/pipeline.md, ruft jede Stellenanzeige auf und bewertet sie. Die Ergebnisse kommen in Batches zurück. Jeder Batch zeigt eine Tabelle wie diese:

Batch 1 fertig (Anthropic, ElevenLabs, Mistral):

Das bedeuten die einzelnen Spalten:

Um die vollständige Bewertung einer Rolle zu lesen, hast du zwei Möglichkeiten:

• Öffne die Berichtsdatei direkt – du findest sie im Ordner reports/ anhand der Nummer aus der Tabelle.
• Nutze das Dashboard – führe ./dashboard/career-dashboard im Projektordner aus, um alle deine Berichte in einer Terminal-Oberfläche durchzusehen. Du kannst nach Score und Status filtern und jeden Bericht öffnen, ohne das Terminal zu verlassen.

Wie es weitergeht

Wenn /career-ops pipeline fertig ist, hat jede Stelle einen Score von 1.0 bis 5.0. Den vollständigen Bericht zu jeder Rolle findest du im Ordner reports/. Der Score zeigt, wie gut die Rolle zu deinem Profil passt.

Nimm den Score als Ausgangspunkt:

Das machen die einzelnen Befehle:

• /career-ops apply – Öffnet das Bewerbungsformular und schreibt Antworten, die auf dein Profil zugeschnitten sind. Es stoppt vor dem Absenden, damit du vorher alles prüfen kannst.
• /career-ops contacto – Findet auf LinkedIn einen Hiring Manager oder ein Teammitglied und entwirft eine kurze Kontaktnachricht, die du dann selbst verschickst.
• /career-ops deep – Recherchiert das Unternehmen und die Rolle im Detail. Nutze das, wenn du unschlüssig bist und vor der Entscheidung mehr Informationen willst.
• /career-ops tracker – Zeigt den Status jeder Rolle in deiner Pipeline. Führe es jederzeit aus, wenn du sehen willst, wo du gerade stehst.