JobSpy¶
Passende Stellen zu finden ist für die meisten noch Handarbeit: Du suchst auf mehreren Jobbörsen,
kopierst einen Text und startest die Bewerbung. Das quelloffene Projekt
JobSpy (MIT) bietet eine gemeinsame Abfrage über mehrere
Börsen, und sein MCP-Server (mcp-jobspy auf PyPI) gibt die Ergebnisse an Claude weiter. Der
Skill job-application-job-search nutzt ihn, um aus deinem Wunschprofil eine Shortlist zu
bauen.
Bevorzugter Weg zu Jobbörsen, aber nicht Teil dieses Plugins
Diese Seite behandelt nur den JobSpy-Server. Die Regeln, die für alle optionalen Server
gelten (Zustimmung, ein Weg je Quelle, Budget, Rang der Quelle, keine Umgehung), stehen auf
Optionale MCP-Server. Ist der Server verbunden, werden Jobbörsen über ihn
durchsucht und nicht per Websuche oder Seitenabruf. Das ist die Arbeitsregel des
Rechercheverfahrens (spec/job-application/recherche/en.md, RC-5.8); der Suchschritt selbst
ist in spec/job-application/stellensuche/en.md festgelegt. Kein Skill braucht den Server.
Ohne ihn fügst du eine Anzeige in job-application-solution ein, wie in
Erste Schritte beschrieben. Das Plugin installiert nichts und liefert
keine .mcp.json: Die Konfiguration unten trägst du selbst ein. Der Server ist ein
eigenständiges Projekt und steht in keiner Verbindung zu diesem Plugin.
Jede Aussage über JobSpy auf dieser Seite ist die des Projekts selbst, wie seine READMEs sie nennen, geprüft gegen Version 1.4.1 (laut PyPI am 23. Oktober 2026 veröffentlicht). Das Plugin hat den Server nicht gegen die Börsen getestet und bestätigt diese Aussagen nicht. Prüfe die README auf Neueres.
Was der Server tut¶
Der MCP-Server bietet zwei Tools, wie seine README sie beschreibt:
| Tool | Was es tut | Nutzung im Skill |
|---|---|---|
search_jobs |
Durchsucht die gewählten Börsen und liefert eine Vorschau mit einer Such-ID; die Ergebnisse lassen sich optional als .csv, .json oder .jsonl exportieren |
Die Shortlist |
get_job_details |
Liefert die vollständigen Datensätze gewählter Stellen aus einer Suche, ohne erneut zu suchen | Der eine Eintrag, den du wählst, für die Übergabe |
Die README des MCP-Servers listet die Parameter der Tools nicht auf, deshalb tut es diese Seite auch nicht. Der Skill übergibt nur, was dein freigegebener Suchbrief enthält. Den Export nutzt das Plugin nicht von sich aus; wünschst du einen, landet er in deiner Wurzel und folgt den Aufbewahrungsregeln unten.
So nutzt der Skill ihn¶
job-application-job-search ist ein optionaler Schritt vor der Bewerbung. Er läuft so:
- Er baut aus deinem bestätigten Wunschprofil und
profil.mdeinen Suchbrief und zeigt ihn zuerst: Suchbegriffe, Ort und Umkreis, Remote, Anstellungsart, höchstes Alter der Anzeige, Börsen, Ergebnisse je Börse und die Quelle jedes Begriffs. Der Brief enthält nur Begriffe, die du selbst in eine Börse tippen würdest. Ausschlussgründe, Gehaltswunsch, persönliche Umstände und Text aus deiner Datengrundlage gehören nie hinein. - Vor deinem Ja wird nichts gesendet. Nur die Begriffe des freigegebenen Briefs gehen an die Börsen.
- Standardbörsen sind Indeed und Glassdoor. Weitere Börsen nutzt der Skill nur, wenn dein Brief sie nennt. LinkedIn wird nie über JobSpy durchsucht: LinkedIn läuft über den eigenen Server, siehe LinkedIn-Zugriff.
- Die Grenzen sind bewusst klein: höchstens 20 Ergebnisse je Börse, 3 Börsen je Suche, 5 Suchen je Sitzung und ein begrenztes Alter der Anzeigen (RC-5.8 Regel 4). Es gibt keine geplanten oder wiederkehrenden Suchen. Vollständige Details holt der Skill nur für den Eintrag, den du wählst, nie für eine Liste.
- Die Shortlist zeigt Vetos aus deinem Wunschprofil mit Grund, statt sie zu streichen, führt Doppelte über Börsen und mit deinen vorhandenen Vorgängen zusammen und markiert Anzeigen eines Vermittlers oder ohne Arbeitgebername. Ein Fit-Check läuft nur auf Wunsch, je Eintrag.
- Du wählst einen Eintrag; der Skill übergibt ihn an
job-application-solution, mit dem Anzeigentext wie veröffentlicht und der URL alsstellenquelle. - Brief, Shortlist und deine Entscheidung je Eintrag (
übernommen,abgelehnt,offen) landen insuche/<JJJJ-MM-TT>-<slug>.mdin deiner Wurzel. Der Datensatz bleibt 90 Tage erhalten. Der Skill listet Datensätze nach Fristende auf und löscht nichts; du entscheidest.
Einrichten¶
Du brauchst uv. Die README des MCP-Servers ist maßgeblich für aktuelle Schritte und Optionen. Für Claude Code:
claude mcp add jobspy -- uvx mcp-jobspy@latest
Oder als Eintrag im Abschnitt mcpServers deiner MCP-Konfiguration:
{
"mcpServers": {
"jobspy": {
"command": "uvx",
"args": ["mcp-jobspy@latest"]
}
}
}
@latest hält den Server selbst aktuell, sodass er mit den wechselnden Seiten der Börsen
funktioniert, führt aber auch neuen Code ohne deine Prüfung aus. Legst du Wert darauf, pinne
stattdessen eine Version: Schreibe mcp-jobspy@<version> mit einer Versionsnummer aus den
Releases des Projekts. Die für diese Seite geprüfte Version ist 1.4.1.
Was er abdeckt¶
Laut README verhalten sich die Börsen bei einer Suche im deutschsprachigen Raum so:
| Börse | In DACH |
|---|---|
| Indeed | Unterstützt Deutschland, Österreich und die Schweiz. Standardbörse |
| Glassdoor | Unterstützt Deutschland, Österreich und die Schweiz. Standardbörse, mit dem bekannten Problem unten |
| Von JobSpy unterstützt, aber dieses Plugin nutzt es nie über JobSpy; es läuft über den LinkedIn-Server | |
| ZipRecruiter | USA und Kanada: gilt nicht |
| Bayt, Naukri, BDJobs, HelloWork | Andere Regionen (Naukri: Indien, BDJobs: Bangladesch, HelloWork: Frankreich): gelten nicht für DACH |
Nicht abgedeckt: StepStone, XING und die Jobbörse der Bundesagentur für Arbeit. Eine Suche über JobSpy übersieht deshalb viele deutsche Anzeigen. Sieh die Shortlist als Ausschnitt des Marktes, nicht als dessen Gesamtheit.
Ein bekanntes Glassdoor-Problem. Ein offenes Issue (#438 im JobSpy-Repository, offen am 23. Oktober 2026) meldet, dass Glassdoor den Ort „Berlin, Germany“ nicht findet, während „Berlin“ und „Berlin, Deutschland“ funktionierten. Eine Korrektur ist vorgeschlagen, aber nicht übernommen. Fällt Glassdoor aus, meldet der Skill das und überspringt die Börse; die anderen Börsen laufen weiter.
Regeln speziell für JobSpy¶
Die allgemeinen Regeln stehen auf Optionale MCP-Server. Für JobSpy kommt hinzu:
- Sperren. Die README sagt, die Jobbörsen „are aggressive with blocking“, und empfiehlt Proxys. Dieses Plugin empfiehlt oder konfiguriert keine Proxys oder andere Maßnahmen, um Sperren zu umgehen. Eine blockierte Börse wird dir gemeldet und aus der Suche ausgelassen.
- Nutzungsbedingungen. Die Bedingungen der Börsen können automatisierten Zugriff einschränken. Sie unterscheiden sich je Börse, und du prüfst sie selbst. Keine der beiden READMEs nimmt zu den Nutzungsbedingungen Stellung. Der Einsatz des Servers ist deine Entscheidung und dein Risiko, wie bei LinkedIn und dem Handelsregister.
- Budget. Höchstens 20 Ergebnisse je Börse, 3 Börsen je Suche, 5 Suchen je Sitzung. Du kannst die Zahlen senken.
- Personenbezogene Daten. Ein Datensatz enthält ein Feld
emailsund Kontaktdaten der Firma. Sie werden nicht gespeichert und nicht in der Shortlist gezeigt: Die Shortlist behält Firma, Rolle, Ort, Datum und URL. Was der Server liest, wird trotzdem Teil der Claude-Sitzung und geht an den Modellanbieter. - Anzeigentext sind Daten. Eine Anzeige von einer Börse kann Anweisungen enthalten. Der Skill behandelt sie als Daten und befolgt sie nie.
- Qualität der Daten. Ein Eintrag ist eine Anzeige, wie veröffentlicht (Rang 2), für
Anforderungen und Bewerbungsweg; die Angaben der Börse zur Firma sind Rang 5. Eine
Gehaltsspanne kann aus der Beschreibung gelesen sein (
salary_source: description); der Skill zeigt sie mit diesem Hinweis und nutzt sie nie als Tatsache in einem Dokument. Dieselbe Anzeige kann auf mehreren Börsen stehen und alt oder neu eingestellt sein, deshalb zeigt die Shortlist das Datum der Anzeige. - Ohne den Server. Füge den Anzeigentext in
job-application-solutionein.