job-search-mcp

Ein MCP-Server für die Jobsuche unter einer Visa-Beschränkung.

Wenn du Sponsoring brauchst, beantwortet die meiste Job-Such-Software die falsche Frage. Sie sagt dir, dass eine Stelle existiert. Sie sagt dir nicht, ob der Arbeitgeber dich legal einstellen kann, ob der Titel „mid-level“ eigentlich eine Senior-Rolle verbirgt oder ob das Unternehmen, das die Stelle ausschreibt, eine Personalvermittlung ist, die überhaupt keine Lizenz besitzt.

Dieser Server beantwortet diese Fragen. Er stellt vier Tools über das Model Context Protocol bereit, damit ein KI-Assistent sie selbst prüfen kann, statt zu raten.

Tools

Related MCP server: recruiting-jobs-mcp

Warum es Vertrauensstufen gibt

Der naheliegende Weg, eine Sponsoring-Lizenz zu prüfen, ist, im Register nach dem Unternehmensnamen zu suchen. So hat es angefangen, und es ist falsch, oft genug falsch, um gefährlich zu sein.

Unternehmensnamen kollidieren. Um Pimberly mit dem eingetragenen Namen Pimberly Software Development Limited abzugleichen, entfernt man Wörter wie „Software“ und „Limited“. Dieselbe Normalisierung macht aus Minerva Defence ein minerva, das dreizehn nicht zusammenhängende Unternehmen trifft: einen Einrichtungsbetrieb, eine Kreditagentur, einen Anbieter für betreutes Wohnen.

Deshalb gibt check_sponsor einen Vertrauensgrad zurück, keinen booleschen Wert:

• high – der markanteste Teil des Namens wurde exakt, einmal.

• verify – etwas wurde gefunden, aber es könnte Zufall sein. Bestätige die eingetragene Rechtsform des Unternehmens und schlage diesen Namen nach.

• none – nichts wurde nicht. Das ist kein Beweis, dass sie nicht sponsern können. Viele zugelassene Arbeitgeber treten unter einem Namen auf, der nicht dem eingetragenen entspricht.

Reale cases, die das geprägt haben:

Warum screen_posting den Text liest statt des Titels

Eine Anzeige mit dem Titel „Software Engineer“ begann mit „As a Senior Software Engineer you will“ und bat jemand zu „the finding team“ zu stoßene. Eine andere mit dem Titel „Software Engineer (Java Mid)“ verwies drei Absätze weiter unten auf eine Senior-Stufe. Wer fon Titel filternen, übersieht beide.

screen_posting erkennt darüber hinaus harte Ausschlusskriterien, die kein Bewerbungscoaching aushebeln kann:

You must be a UK citizen and have lived in the UK for the past 10 years.
You must already hold high-level UK security clearance.

und denjenigen, der mit einem Sponsoring am wichtigsten ist – von einem Unternehmen, das eine Lizenz mit A-Rating besitzt:

We are unable to offer visa sponsorship for this role. Candidates who need visa
sponsorship now or will need it in the future will not be considered.

Eine Lizenz bedeutet, dass ein Unternehmen sponsern kann. Es ist nicht gesagt, dass es sponsern wird.

Warum search_roles einen Funnel zurückgibt

Britische Jobplatze werden von Personalvermittlungsagenturen dominiert, und diese Agenturen sind nicht Inhaber der Sponsor-Lizenz für die ausgeschriebene Stelle. Das Herausfiltern der Absender ist essenziell und zu brutal: Eine typische Suche schrumpf von sieben Suchergebnissen auf eines.

Ein einziges Ergebnis ohne Erklärung das fühlt sich wie Fehler an. Deshalb gibt lies dashboard alle, alle für each Stellung entfernt wurden:

{
  "totalFromSource": 7,
  "funnel": { "fromSource": 7, "afterAgencyFilter": 2, "afterSalaryAndAge": 1 },
  "notes": ["5 of 7 results were recruitment agencies or job boards. ..."]
}

Nicht oder inhalt nicht veröffentlichtee Gehälter werden behalten, never herausgefiltert. Rückhalt um Gehälter ist kein Beweis für niedrige Bezahlung.

Install

npm install && npm run build

Lade das aktuelle Register herunter (regelmäßig aktualisiert, ca. 11 MB):

https://www.gov.uk/government/publications/register-of-licensed-sponsors-workers

Speichere es als data/register.csv oder verweise SPONSOR_REGISTER_PATH darauf.

Claude Desktop / Claude Code

{
  "mcpServers": {
    "job-search": {
      "command": "node",
      "args": ["/absolute/path/to/job-search-mcp/dist/index.js"],
      "env": {
        "SPONSOR_REGISTER_PATH": "/absolute/path/to/data/register.csv",
        "REED_API_KEY_FILE": "/absolute/path/to/.reed-api-key"
      }
    }
  }
}

In normaler Betrieb werden keine Zugangs daten aus repo-internen Datei gelesen, und die Registersdaten liegen in .gitignore.

Oder mit der Claude-Code-CLI:

claude mcp add job-search --scope user \
  --env SPONSOR_REGISTER_PATH=/path/to/data/register.csv \
  --env REED_API_KEY_FILE=/path/to/.reed-api-key \
  -- node /path/to/job-search-mcp/dist/index.js

Tests

npm test

54 Tests. Jedes Fixture ist eine echte Herstellung oder ein echt Registereintrag, der einen frühere Version dieses Codes geschlagen hat. Die Reed-Tests mocken fetch, sodass die Suite offline läuft und kein API-Kontingent verbraucht.

Zwei Fehler, welche die Suite finden konnte, als sie geschrieben wurde:

• £40,000-85,000 wurde als Pauschalbetrag £40,000 eingespreist da Prob, weil der zweite Betrag keine Währungssymbol enthält. An einer Gehaltsschwelle entspricht das dem Unterschied zwischen „erreicht“ und „nicht erreicht“.

• Ein Agenturfilter, entlang \brecruit\b geschrieben, traf funktional weder Recruitment noch Consultancy. Und ca. fünfzig Agenten sind einfach durchgerüchert.

Design – Vermerk

core() egal – macht gezielt Beschreibung Sprung: By removal-Trages Remove descriptors deswegen Abgleich Markenkern und Firmierung funktional it. But genau das führt zu false positives. Der Vertrauensgrad weist den Preis diesen Trade-off aus, statt ihn zu verstecken.

Absenz ist kein Gegenbeweis. none bringt das Einspre aside Hinweis mit. The teuerste Error in this domain is die Folgerung unwilliger Arbeitgeber ist der sebstständiger operator – „die Search“ Fehler: none.

In anderen Worten: Wer einen nicht gelisteten Arbeitgeber nicht sponserungsfähig erklärt, macht den größten Fehler nei.

Read-only. Der Server liest das Bewerbungen-New-Legion, schreibt aber nicht. A Buchführungsergebnis ist eine Entscheidung, die ein Mensch muss.

Lizenz

MIT