Job Platform MCP Monorepo

Dieses TypeScript-Monorepo stellt die Wanted-, Saramin- und JobKorea-Stellen-APIs jeweils als unabhängige MCP-Server bereit und bietet zusätzlich eine Agent-Skill, die auf Basis von Lebenslauf und Portfolio passende Stellenausschreibungen findet.

Dieses Dokument dient als Referenzdokument sowohl für die manuelle Einrichtung als auch für die Konfiguration durch Agenten wie Codex, Claude Code, OpenCode oder OpenClaw.

Gebotene Funktionen

Die Skill job-match-search führt folgende Aufgaben aus:

• Analyse von Lebenslauf, CV, Erfahrungsbericht und Portfolio des Nutzers

• Extraktion von Zielposition, Erfahrung, Technologien, Domäne und Präferenzen

• Wenn Region oder Detailbedingungen fehlen, einmalige Rückfrage vor der Suche

• Wenn der Nutzer die Eingabe von Bedingungen überspringt, Suche ohne Einschränkung bei Region und Beschäftigungsform

• Gemeinsame Abfrage der verbundenen Wanted-, Saramin- und JobKorea-MCPs

• Entfernung doppelter Anzeigen und begründete Eignungsbewertung

• Angabe der Übereinstimmungsgründe, fehlender Anforderungen und Originallinks der Top-Anzeigen

Related MCP server: RecruitData

Designprinzipien

• Die drei MCPs laufen als separate stdio-Prozesse.

• Plattformspezifische Anmeldedaten und API-Clients werden nicht untereinander geteilt.

• Es werden die vom jeweiligen Nutzer selbst ausgestellten API-Berechtigungen verwendet.

• Kostenpflichtige Funktionen werden nur aufgerufen, wenn das Konto des Nutzers über die entsprechende Berechtigung verfügt.

• Lebenslauf-Originaltexte und personenbezogene Daten werden nicht an die Stellen-APIs übertragen.

• Für die Suche werden nur minimal abgeleitete Bedingungen wie Berufsbezeichnung, Technologien, Erfahrung und Region an die API übermittelt.

• Ohne Bestätigung des Nutzers werden keine Bewerbungen eingereicht, Konten erstellt, Ansprechpartner kontaktiert oder Zahlungen ausgelöst.

Anforderungen

• Node.js 22 oder höher

• pnpm 11 oder höher

• Git

• API-Anmeldedaten der zu verwendenden Stellenplattform

Versionen prüfen.

node --version
pnpm --version
git --version

Schnellstart

1. Repository abrufen

git clone https://github.com/sjungwon03/job-platform-mcp.git
cd job-platform-mcp

Wenn Sie bereits lokal arbeiten, bevor Sie das Remote-Repository abgerufen haben, fahren Sie ab dem nächsten Schritt im aktuellen Repository-Root fort.

2. Abhängigkeiten installieren und bauen

pnpm install
pnpm build

Um den Gesamtzustand zu überprüfen:

pnpm verify

Die Überprüfung umfasst Lint, TypeScript-Typenprüfung, Sicherheits-Repository-Tests, MCP-Tests und den Produktions-Build.

3. API-Anmeldedaten vorbereiten

Es genügt, nur die gewünschte Plattform zu konfigurieren. Es ist nicht erforderlich, alle drei Plattformen zu verwenden.

Wanted

Ausstellung: https://openapi.wanted.jobs/apply/

Dieses Projekt übernimmt keine API-Kosten und stellt keine öffentlichen Schlüssel bereit. Bei Nutzung kostenpflichtiger Funktionen verwaltet der jeweilige MCP-Nutzer Berechtigungen und Zahlungen über sein eigenes Wanted-Konto.

Saramin

Ausstellung: https://oapi.saramin.co.kr/

JobKorea

Hinweis: https://www.jobkorea.co.kr/service/api

JobKorea stellt nach Nutzungsfreigabe und Registrierung der anfragenden IP eine eindeutige Aufruf-URL bereit.

Mindestens eine der beiden URLs ist erforderlich. Die gesamte ausgestellte URL ist als Geheimnis zu behandeln.

4. Anmeldedaten sicher eingeben

Geben Sie Anmeldedaten nicht direkt in Chat, README, Git-verfolgte Dateien oder die MCP-Konfigurations-JSON ein.

Führen Sie im Repository-Root den Sicherheits-Konfigurator aus.

node skills/job-match-search/scripts/configure-credentials.mjs

Der Konfigurator arbeitet in folgender Reihenfolge:

1. Auswahl der zu konfigurierenden Plattform.

2. Eingabe der Anmeldewerte mit Maskierung durch Sternchen.

3. Standardmäßig Speicherung unter job-platform-mcp/credentials.json im Benutzerkonfigurationsverzeichnis.

4. Unter Linux, macOS und WSL Einschränkung der Dateiberechtigungen auf 0600.

5. Ablehnung von Pfaden innerhalb des Repositorys, symbolischen Links und Dateien, die von anderen Benutzern gelesen werden können.

6. Die Werte werden nicht erneut ausgegeben; es wird nur angezeigt, welche Plattformen konfiguriert sind.

Standard-Speicherort:

~/.config/job-platform-mcp/credentials.json

Um einen anderen absoluten Pfad zu verwenden, setzen Sie JOB_MATCH_CREDENTIALS_FILE sowohl im Konfigurator als auch im MCP-Host identisch. Pfade innerhalb des Repositorys sind nicht zulässig.

Konfigurationsstatus prüfen:

node skills/job-match-search/scripts/configure-credentials.mjs --check

Die Ausgabe enthält keine tatsächlichen Werte.

Wanted: 설정됨
사람인: 설정됨
잡코리아: 미설정

Diese Datei ist eine lokale JSON-Datei, die durch die OS-Dateiberechtigungen geschützt ist; sie ist keine eigenständig verschlüsselte Datei. Unter nativem Windows wird die Verwendung des vom Agenten oder MCP-Host bereitgestellten OS-Secret-Stores empfohlen.

5. Server im MCP-Host registrieren

Registrieren Sie den gemeinsamen Launcher run-mcp.mjs, ohne Anmeldedaten direkt in die MCP-Konfiguration zu kopieren.

Zuerst alle Pakete bauen.

pnpm build

Ersetzen Sie unten absolute-path durch den tatsächlichen absoluten Pfad des Repositorys.

{
  "mcpServers": {
    "wanted": {
      "command": "node",
      "args": [
        "/absolute-path/job-platform-mcp/skills/job-match-search/scripts/run-mcp.mjs",
        "wanted"
      ]
    },
    "saramin": {
      "command": "node",
      "args": [
        "/absolute-path/job-platform-mcp/skills/job-match-search/scripts/run-mcp.mjs",
        "saramin"
      ]
    },
    "jobkorea": {
      "command": "node",
      "args": [
        "/absolute-path/job-platform-mcp/skills/job-match-search/scripts/run-mcp.mjs",
        "jobkorea"
      ]
    }
  }
}

Es genügt, nur die konfigurierten Plattformen zu registrieren. Starten Sie den MCP-Host neu und prüfen Sie dann in der Tool-Liste die folgenden Namen.

wanted_list_jobs
saramin_search_jobs
saramin_get_job
jobkorea_fetch_jobs
jobkorea_fetch_entry_jobs

Wenn der MCP-Host Servernamen als Präfix hinzufügt, können die tatsächlich angezeigten Namen leicht abweichen.

Einrichtungsablauf für Agenten

Wenn ein Agent dieses Repository einrichtet, folgt er der untenstehenden Reihenfolge. Auch Menschen können denselben Ablauf verwenden.

1. Prüfen, ob das aktuelle Verzeichnis das Repository-Root mit pnpm-workspace.yaml ist.

2. Anforderungen mit node --version und pnpm --version prüfen.

3. pnpm install und pnpm build ausführen.

4. Den Nutzer fragen, welche Plattform er verbinden möchte und ob die Anmeldedaten bereits ausgestellt sind.

5. Nicht verlangen, dass Anmeldewerte in ein normales Chat-Fenster eingegeben werden.

6. configure-credentials.mjs in einem interaktiven TTY ausführen und den Nutzer die maskierte Eingabe selbst vornehmen lassen.

7. Den Konfigurationsspeicherort des verwendeten Agenten oder MCP-Hosts ermitteln.

8. Ohne Geheimwerte nur den absoluten Pfad von run-mcp.mjs und die Plattformargumente registrieren.

9. Den MCP-Host neu starten und die Verbindung mit einer schreibgeschützten Anfrage mit geringem Ergebnisumfang prüfen.

10. Bei Erfolg nur die Namen der verbundenen Plattformen melden. Auch bei Fehlern keine Anmeldewerte oder die JobKorea-Aufruf-URL einbeziehen.

Wenn der Agent kein interaktives TTY bereitstellen kann, weisen Sie den Nutzer nur auf den Konfigurationsbefehl hin und warten Sie, bis die Eingabe abgeschlossen ist. Authentifizierungsfehler werden nicht automatisch wiederholt.

Installation der Stellen-Matching-Skill

Die Skill-Originale befinden sich im folgenden Verzeichnis.

skills/job-match-search/
├── SKILL.md
├── references/
├── scripts/
└── test/

Die Skill verwendet das öffentliche Agent-Skills-Format und ist nicht von agentenspezifischem Frontmatter abhängig. Je nach Client unterscheidet sich nur das durchsuchte Verzeichnis.

Codex

Den Originalordner im persönlichen Skill-Verzeichnis verknüpfen.

mkdir -p ~/.codex/skills
ln -s /absolute-path/job-platform-mcp/skills/job-match-search ~/.codex/skills/job-match-search

Wenn unter demselben Namen bereits ein Pfad existiert, nicht löschen oder überschreiben, sondern zuerst die vorhandene Skill prüfen.

Claude Code

Im Projekt-Skill-Pfad verknüpfen.

mkdir -p .claude/skills
ln -s ../../skills/job-match-search .claude/skills/job-match-search

Bei Claude Code wird die Skill bei direktem Aufruf wie folgt verwendet.

/job-match-search 내 이력서에 맞는 백엔드 공고를 찾아줘

OpenCode

Im Projekt-Skill-Pfad verknüpfen.

mkdir -p .opencode/skills
ln -s ../../skills/job-match-search .opencode/skills/job-match-search

OpenCode unterstützt auch die kompatiblen Pfade .claude/skills und .agents/skills.

OpenClaw

Wenn dieses Repository selbst als OpenClaw-Workspace verwendet wird, wird der Pfad skills/job-match-search automatisch gefunden. Für die Installation in einem anderen Workspace:

openclaw skills install /absolute-path/job-platform-mcp/skills/job-match-search

In Umgebungen ohne Unterstützung für symbolische Links kopieren Sie den gesamten Ordner in den Skill-Pfad des jeweiligen Clients. Dabei müssen nicht nur SKILL.md, sondern auch references und scripts mitkopiert werden.

Verwendung der Skill

Lebenslauf oder Portfolio anhängen oder einen lokalen Pfad angeben, den der Agent lesen kann.

$job-match-search
첨부한 이력서를 분석해서 내 경력에 맞는 채용공고를 찾아줘.

Region und Bedingungen können zusammen angegeben werden.

$job-match-search
서울 또는 판교, 주 2회 이하 출근, 정규직 백엔드 포지션을 찾아줘.
Java와 Spring 실무 경험을 중요하게 보고 연봉이 공개된 공고를 우선해줘.

Sie können auch ohne festgelegte Bedingungen beginnen.

$job-match-search
내 포트폴리오에 맞는 공고를 찾아줘. 조건은 아직 정하지 않았어.

In diesem Fall fragt die Skill Region, Arbeitsmodell, Beschäftigungsform und die wichtigsten Präferenzen in einem Schritt ab. Wenn die Antwort übersprungen wird, wird ohne Einschränkungen breit gesucht.

Die Standardergebnisse enthalten folgende Informationen:

• Das analysierte Suchprofil und die genannten Annahmen

• Die 10 Anzeigen mit der höchsten Eignung

• Bestätigte Übereinstimmungsgründe sowie fehlende oder unbestätigte Anforderungen

• Region, Arbeitsmodell, Bewerbungsfrist, Quelle und Originallink

• Abgefragte Plattformen, Suchbegriffe, Filter und fehlgeschlagene Bereiche

Der Eignungswert ist eine Heuristik zum Vergleich und keine Zulassungswahrscheinlichkeit.

Entwicklungsbefehle

Gesamter Workspace:

pnpm install
pnpm lint
pnpm typecheck
pnpm test
pnpm build
pnpm verify

Nur ein einzelnes Paket prüfen:

pnpm --filter wanted-mcp test
pnpm --filter saramin-mcp test
pnpm --filter jobkorea-mcp test

Nur die Sicherheits-Repository-Tests ausführen:

pnpm test:skill

Projektstruktur

.
├── packages/
│   ├── wanted-mcp/
│   ├── saramin-mcp/
│   └── jobkorea-mcp/
├── skills/
│   └── job-match-search/
├── package.json
├── pnpm-lock.yaml
└── pnpm-workspace.yaml

Der Root-Workspace integriert nur die Abhängigkeitsinstallation, eine einzige Lockfile und die Gesamtprüfung. Konfiguration, Clients, Tool-Schemas und Tests jedes MCP bleiben innerhalb des jeweiligen Pakets.

Problemlösung

Sicherheitshinweise

• Keine tatsächlichen Anmeldedaten in Git committen.

• Anmeldedaten nicht in Issues, PRs, Chats oder Logs einfügen.

• Offengelegte Schlüssel sofort widerrufen und auf der Plattform neu ausstellen lassen.

• Die JobKorea-Aufruf-URL in ihrer Gesamtheit als Geheimnis behandeln.

• Die Anmeldedaten-Datei nicht in Cloud-Synchronisationsordnern oder freigegebenen Verzeichnissen ablegen.

• Fremden Skills oder Skripten keinen Zugriff auf den Anmeldedaten-Speicher gewähren.

Lizenz und API-Nutzungsbedingungen

Für Daten, API-Nutzungsbedingungen, Aufruflimits und Abrechnungsrichtlinien der jeweiligen Stellenplattform gelten deren AGB. Dieses Repository umgeht keine Authentifizierungsberechtigungen oder kostenpflichtigen Funktionen und gewährt keine Rechte zur Weiterverbreitung von API-Daten.