Indeed MCP Server

Ein gehosteter MCP-Server (Model Context Protocol), der Claude, Cursor, Windsurf und jedem anderen MCP-Client zwei schreibgeschützte Indeed-Tools bereitstellt. Suchen Sie Stellenanzeigen nach Stichwort und Ort und lesen Sie eine einzelne Anzeige vollständig – alles als strukturiertes JSON, ohne Indeed-Entwicklerkonto und ohne Partnerfreigabe.

Er liest öffentliche Stellenanzeigen, die ein nicht angemeldeter Besucher sehen kann.

https://mcp.hasdata.com/api/mcp?apis=indeed

Inhalt

• Was Sie brauchen

• Schnellstart

• Beispiel-Prompts

• Tools

• Fehler und Fehlerpfade

• Preise, kostenlose Stufe und Limits

• Tool-Auswahl

• Vergleich

• FAQ

• HasData-Links

• Entwicklung

• Mitwirken

• Lizenz

Related MCP server: JobDataLake MCP Server

Was Sie brauchen

Ein MCP-Client und ein HasData-API-Schlüssel vom Dashboard, kostenlos und ohne Karte erstellbar; die Testversion deckt etwa 200 Aufrufe zum 5-Credit-Tarif ab. Dies ist ein Remote-Server, daher ist der einfachste Weg eine URL und ein x-api-key-Header – ohne Container, den Sie ausführen müssen, und ohne Indeed-Entwicklerkonto im gesamten Ablauf. Ein Client, der nur stdio spricht, erreicht ihn über einen schlanken Launcher, der als @hasdata/indeed-mcp auf npm und hasdata-indeed-mcp auf PyPI veröffentlicht ist, wie unten gezeigt.

Schnellstart

Die Server-URL ist für jeden Client dieselbe. Wir haben sie in Claude Code und Claude Desktop praktisch ausprobiert. Die anderen Blöcke folgen dem jeweils dokumentierten Format der Clients für einen Remote-Server.

Clients mit OAuth-Unterstützung können dieselbe URL als Connector hinzufügen und sich anmelden, ohne einen Schlüssel in eine Konfigurationsdatei einzutragen.

claude mcp add --transport http indeed "https://mcp.hasdata.com/api/mcp?apis=indeed" \
  --header "x-api-key: HASDATA_API_KEY"

Einstellungen, dann Connectors, dann Add custom connector, dann https://mcp.hasdata.com/api/mcp?apis=indeed einfügen und anmelden.

Für den Weg über die Konfigurationsdatei lädt Claude Desktop nur lokale (stdio) Server, daher erreicht es einen Remote-Server über einen stdio-Launcher. Das Paket @hasdata/indeed-mcp ist dieser Launcher und liest den Schlüssel aus der Umgebung. Fügen Sie dies zu claude_desktop_config.json hinzu:

{
  "mcpServers": {
    "indeed": {
      "command": "npx",
      "args": ["-y", "@hasdata/indeed-mcp"],
      "env": { "HASDATA_API_KEY": "YOUR_KEY" }
    }
  }
}

Für Python statt Node tauschen Sie den Launcher gegen das PyPI-Paket, das uvx ohne manuelle Installation ausführt:

{
  "mcpServers": {
    "indeed": {
      "command": "uvx",
      "args": ["hasdata-indeed-mcp"],
      "env": { "HASDATA_API_KEY": "YOUR_KEY" }
    }
  }
}

~/.cursor/mcp.json für jedes Projekt oder .cursor/mcp.json für ein einzelnes Projekt:

{
  "mcpServers": {
    "indeed": {
      "url": "https://mcp.hasdata.com/api/mcp?apis=indeed",
      "headers": { "x-api-key": "HASDATA_API_KEY" }
    }
  }
}

~/.codeium/windsurf/mcp_config.json. Windsurf nennt das Feld serverUrl, nicht url:

{
  "mcpServers": {
    "indeed": {
      "serverUrl": "https://mcp.hasdata.com/api/mcp?apis=indeed",
      "headers": { "x-api-key": "HASDATA_API_KEY" }
    }
  }
}

.vscode/mcp.json im Workspace:

{
  "servers": {
    "indeed": {
      "type": "http",
      "url": "https://mcp.hasdata.com/api/mcp?apis=indeed",
      "headers": { "x-api-key": "HASDATA_API_KEY" }
    }
  }
}

Beispiel-Prompts

Prompts, kein Code. Fügen Sie einen ein, und der Agent wählt das Tool selbst aus. Jeder Prompt ist mit den Aufrufen annotiert, die er benötigt, denn jeder erfolgreiche Aufruf kostet 5 Credits.

Suchen Sie auf Indeed nach „python developer"-Jobs in New York, sortiert nach Datum, und nennen Sie mir die zehn neuesten mit Unternehmen und Gehalt.

Ein Aufruf, 5 Credits. Eine Listenseite enthält bereits Unternehmen, Gehalt und Veröffentlichungsdatum.

Nehmen Sie die oberste Anzeige aus dieser Suche und rufen Sie ihre vollständige Beschreibung und Anforderungen ab.

Ein Aufruf, 5 Credits. Die Auflistung enthält eine Job-URL, die das Details-Tool direkt übernimmt.

Finden Sie Jobs als „data analyst" in Austin und rufen Sie dann vollständige Details zu den drei ab, die ein Gehalt angeben.

Vier Aufrufe, 20 Credits. Eine Auflistung, dann ein Details-Aufruf für jeden der drei.

Vergleichen Sie die veröffentlichten Gehälter für „registered nurse" in Chicago mit denen in Houston.

Zwei Aufrufe, 10 Credits, eine Auflistung pro Stadt.

Ein Gehalt steht in einer Auflistung nur dann, wenn die Anzeige eines angibt. Ein Prompt wie „jobs with salary" filtert also nach dem Feld, statt es vorauszusetzen. Das Blättern kostet jedes Mal einen Aufruf über den start-Offset.

Tools

Zwei Tools, schreibgeschützt. Die Beispiele unten sind aus echten Aufrufen gekürzt, und die Zahlen ändern sich, wenn Indeed aktualisiert. Betrachten Sie sie als Strukturbeispiele. Jeder Tool-Name verlinkt auf seine Endpunkt-Referenz, die die vollständige Feldliste enthält.

Die Beispiele sind die Payload, nicht die gesamte Antwort. Ein tools/call-Ergebnis enthält einen Textblock, und dieser Text ist selbst JSON und enthält url, status, text und json, wobei die gescrapten Daten unter json liegen. Bei einer rohen JSON-RPC-Antwort ist der Pfad result.content[0].text, geparst, dann .json. Ein Chat-Client packt das für Sie aus; Code, der direkt mit dem Endpunkt spricht, tut das nicht.

Indeed-Jobangebote abrufen

hasdata_indeed_listing_getJobListings

Eine Seite mit Suchergebnissen nach Stichwort und Ort.

Gibt searchInformation, ein jobs-Array, peopleAlsoSearchFor und pagination zurück, dessen nextPage die URL der folgenden Seite ist. Jeder Job enthält title, company, location, url, eine kurze description, sponsored, das relative date und das absolute isoDate, ein details-Array mit Bezeichnungen wie Full-time und Hybrid work, ein benefits-Array sowie ein salary-Objekt, wenn die Anzeige eines angibt.

Eine Auflistung enthält details als Array aus einfachen Zeichenketten. Das Job-Details-Tool unten gibt details als Objekt mit jobType- und workSetting-Arrays zurück. Gleicher Name, andere Form – lesen Sie also jedes gemäß seinem eigenen Tool.

{
  "title": "Hedge Fund Application Developer",
  "company": "TBA",
  "location": "Stamford, CT 06901",
  "url": "https://www.indeed.com/pagead/clk?...",
  "sponsored": true,
  "date": "30+ days ago",
  "isoDate": "2025-06-03T17:22:54.869Z",
  "details": ["Full-time", "Hybrid work"],
  "benefits": ["Health insurance", "401(k)", "401(k) matching"],
  "salary": { "min": 80000, "max": 150000, "type": "YEARLY" }
}

Indeed-Jobdetails abrufen

hasdata_indeed_job_getJobDetails

Eine einzelne Anzeige vollständig anhand ihrer Job-URL.

Gibt title, company, location, sponsored, ein details-Objekt mit jobType- und workSetting-Arrays, ein salary-Objekt, falls vorhanden, sowie den Anzeigentext sowohl als description (Klartext) als auch als descriptionHtml (derselbe Inhalt mit beibehaltenem Listen- und Absatz-Markup) zurück. Verwenden Sie descriptionHtml, wenn Sie die Struktur möchten, und description, wenn Sie einem Modell sauberen Text zuführen möchten.

{
  "title": "Python Developer",
  "company": "Think IT Technologies",
  "location": "New York, NY 10114",
  "sponsored": false,
  "details": { "jobType": ["Contract"], "workSetting": ["In-person"] },
  "salary": { "min": 60.5, "max": 65, "type": "HOURLY" },
  "description": "Overview\nWe are seeking a Python Developer...",
  "descriptionHtml": "<p><b>Overview</b></p><p>We are seeking a Python Developer...</p>"
}

Fehler und Fehlerpfade

Ihr Client sieht bei einem Tool-Aufruf fast nie einen HTTP-Fehlercode. Die MCP-Schicht antwortet mit 200 und legt den Fehler in das Ergebnis, mit isError auf true und dem Grund als Text. Der Agent liest eine Nachricht, wo Sie eine Statuszeile erwarten würden.

Ein falscher Schlüssel erscheint als Tool-Ausgabe, nicht als fehlgeschlagene Verbindung. tools/list akzeptiert jeden nicht-leeren Schlüssel und gibt beide Tools zurück, sodass der Client seinen Handshake abschließt und Grün anzeigt. Der erste Tool-Aufruf kommt dann mit isError: true und dem Text HasData API error: 401 Unauthorized zurück. Achten Sie auf diese Zeichenkette, denn nichts früher im Ablauf meldet das Problem.

Ein fehlender Schlüssel ist der einzige echte HTTP-Fehler. Die Autorisierung erfolgt vor jedem Tool, und die Verbindung selbst schlägt mit 401 fehl. CORS-Header sind vorhanden, und ein Browser-Client liest den Status statt eines undurchsichtigen Netzwerkfehlers.

Ein Argument, das das Schema eines Tools verletzt, wird abgelehnt, bevor es zu einem Scrape kommt. Der Server antwortet mit isError: true und dem Text MCP error -32602: Input validation error und nennt das fehlerhafte Feld. Es wird nichts abgerufen und nichts berechnet.

Eine Suche ohne Treffer liefert ein erfolgreiches Ergebnis mit einem leeren jobs-Array, keinen Fehler. Eine Kombination aus Stichwort und Ort ohne offene Stellen kommt weiterhin mit requestMetadata.status auf ok zurück. Prüfen Sie die Länge des Arrays, bevor Sie iterieren.

Eine Anzeige, die entfernt wurde, gibt 400 mit requestMetadata.status auf error zurück. Indeed lässt Anzeigen schnell verfallen, daher kann eine URL aus einer alten Suche nicht mehr verfügbar sein.

Ergebnisse mit Daten enthalten außerdem eine requestMetadata.id, die es wert ist, im Support angegeben zu werden.

Preise, kostenlose Stufe und Limits

Jedes Indeed-Tool kostet 5 Credits pro erfolgreichem Aufruf. Die Antwortgröße ändert den Preis nicht. Eine Listenseite mit fünfzig Jobs kostet dasselbe wie eine mit zwei.

Die kostenlose Testversion umfasst 1.000 Credits über 30 Tage ohne Karte, also 200 Indeed-Aufrufe. Danach erhält ein aktives Konto weiterhin jeden Tag 100 Credits aufgeladen, sobald sein Guthaben unter 100 fällt. Ein Agent mit geringem Volumen läuft so dauerhaft auf der kostenlosen Stufe.

Bezahlte Pläne beginnen bei 49 $ pro Monat für 200.000 Credits, also 40.000 Aufrufe. Der Stückpreis sinkt mit dem Volumen: von 1,23 $ pro 1.000 Aufrufen im Einstiegsplan über 0,50 $ bei Business und 0,42 $ bei Growth bis 0,37 $ bei den größten High-Volume-Plänen.

Ihr Plan legt auch die Parallelität fest. Die kostenlose Testversion erlaubt 1 Anfrage gleichzeitig, Startup 15, Business 30, Growth 50, und die High-Volume-Pläne reichen von 200 bis 1.500. Behandeln Sie den Überlauf-Fall bei allem, was unbeaufsichtigt läuft, defensiv.

Eine Anfrage, die nicht mit 200 zurückkommt, wird nicht berechnet. Ein erfolgreicher Aufruf ohne Treffer ist trotzdem ein Aufruf.

Tool-Auswahl

Der apis-Query-Parameter entscheidet, welche Tools Ihr Agent sieht. Weniger Tools bedeutet weniger Kontext für Tool-Definitionen und weniger Gelegenheiten für das Modell, zum falschen zu greifen.

?apis=indeed                     the two tools in this repo
?apis=indeed,glassdoor           add Glassdoor jobs
?apis=indeed,google_serp         add Google search

Der Parameter akzeptiert Providernamen wie indeed und einzelne API-Namen wie indeed_listing. Falsch geschriebene Namen werden ignoriert. Wenn jeder Name falsch ist, schlägt die Anfrage mit 400 fehl, und der Body listet sowohl das, was er nicht erkannt hat, als auch jeden gültigen Wert auf. Wenn Sie den Parameter weglassen, legt derselbe Endpunkt alle 57 HasData-Tools offen.

Vergleich

Indeed hat seine öffentlichen Publisher- und Job-Search-APIs eingestellt, und der programmatische Zugriff läuft jetzt über genehmigte Partnerschaften und ATS-Integrationen statt über einen Self-Service-Schlüssel. Für das Lesen öffentlicher Einträge und Anzeigen bei beliebigen Suchanfragen gibt es keinen offenen offiziellen Weg.

Was dieser Server nicht tut. Keine Bewerbungseinreichung, kein Arbeitgeber-Dashboard, keine Kandidatendaten, keine privaten Stellenausschreibungen. Er liest, was ein nicht angemeldeter Besucher sehen kann.

FAQ

Gibt es einen offiziellen Indeed-MCP-Server?

Indeed veröffentlicht keinen. Dieser wird von HasData gepflegt und liest öffentliche Seiten, weshalb er kein Indeed-Entwicklerkonto benötigt.

Was ist ein Indeed-MCP-Server?

Ein Server, der Indeed-Jobdaten als Tools bereitstellt, die ein KI-Client aufrufen kann. Der Client sendet einen Tool-Aufruf über das Model Context Protocol, der Server ruft die Daten ab und gibt strukturiertes JSON zurück, und das Modell arbeitet mit dem Ergebnis. Dieser Server stellt zwei Tools bereit und läuft remote.

Brauche ich einen Indeed-API-Schlüssel oder ein Partnerkonto?

Nein. Die einzige Anmeldeinformation ist Ihr HasData-Schlüssel. Es gibt kein Publisher-Konto, für das Sie sich bewerben müssen, da die Tools öffentliche Indeed-Seiten lesen.

Wie blättere ich durch mehr als eine Ergebnisseite?

Übergeben Sie den start-Offset als Zahl an das Listing-Tool, nicht als URL. Die Antwort gibt pagination.nextPage zurück, dessen eigener start-Wert der Offset für die nächste Seite ist. Lesen Sie also diese Zahl und geben Sie sie zurück, anstatt die URL einzusetzen.

Warum fehlt manchmal ein Gehalt?

Weil die Anzeige kein Gehalt angibt. Das salary-Objekt ist nur vorhanden, wenn Indeed einen Betrag anzeigt. Lesen Sie es defensiv.

Kann ich das zusammen mit anderen HasData-APIs verwenden?

Ja. Der Parameter apis akzeptiert eine Liste, und ?apis=indeed,glassdoor versorgt Ihren Agenten mit Indeed und Glassdoor. Lassen Sie den Parameter weg und Sie erhalten alles.

Compliance und personenbezogene Daten

HasData greift ausschließlich auf öffentlich verfügbare Daten zu. Die Nutzungsbedingungen einer Plattform können den automatisierten Zugriff einschränken, und Sie sind für Ihre eigene Compliance verantwortlich. Soweit die von Ihnen erhobenen Daten personenbezogene Informationen enthalten, stellen Sie sicher, dass Sie eine rechtmäßige Grundlage dafür nach DSGVO, CCPA oder den entsprechenden Regelungen Ihrer Rechtsordnung haben.

HasData-Links

Entwicklung

Dieses Repository ist Konfiguration und Dokumentation für einen Remote-Server. Es gibt keinen Build-Schritt und nichts zu containerisieren.

Die Tests in test/ prüfen den Tool-Vertrag, also den Teil, der ohne einen Commit hier brechen kann. Sie prüfen, dass ?apis=indeed genau zwei Tools zurückgibt, dass jedes Tool weiterhin seine erforderlichen Parameter deklariert, dass sich kein Name geändert hat und dass der verwendete Schlüssel tatsächlich akzeptiert wird. Dieser letzte Check ruft ein Tool tatsächlich auf und kostet 5 Credits – das ist der Preis eines Kanarienvogels, der aus dem richtigen Grund fehlschlagen kann.

# macOS and Linux
HASDATA_API_KEY=your_key_here npm test

# Windows PowerShell
$env:HASDATA_API_KEY="your_key_here"; npm test

Dieselbe Testsuite läuft in CI bei jedem Push und einmal pro Woche planmäßig, weil sich die Upstream-Tool-Liste ändern kann, ohne dass jemand dieses Repository anfasst. Ein Fehler bedeutet, dass sich die Tool-Liste geändert hat, der Schlüssel nicht mehr funktioniert oder der Endpunkt nicht erreichbar war – die Assertion-Meldung sagt, welcher Fall vorliegt.

Mitwirken

Korrekturen an den Tool-Tabellen und den Antwortbeispielen sind der nützlichste Beitrag, weil dies die Teile sind, die abweichen. Geben Sie den von Ihnen gemachten Aufruf und die erhaltene Antwort an. Pull Requests aus Forks führen die Suite ohne Schlüssel aus, und die Live-Checks werden übersprungen, statt rot zu werden.

Lizenz

MIT. Siehe LICENSE.