{
  "openapi": "3.1.0",
  "info": {
    "title": "Alleskralle Jobs API",
    "description": "Read-only Jobsuche auf alleskralle.com (DE/AT/CH). Search & Fetch Pattern: zuerst /search für eine kompakte Liste, dann /fetch für Details. Blättern nur über das zurückgegebene next_cursor; die Seitenzahl ist begrenzt.",
    "version": "1.0.0"
  },
  "servers": [
    { "url": "https://mcp.alleskralle.com" }
  ],
  "paths": {
    "/search": {
      "get": {
        "operationId": "searchJobs",
        "summary": "Stellenanzeigen suchen",
        "description": "Liefert eine kompakte Trefferliste (id, title, company, location, date). Die Bewerbungs-/Detail-URL ist bewusst NICHT enthalten — für Details und den Link die id eines Treffers an /fetch übergeben.",
        "parameters": [
          {
            "name": "query",
            "in": "query",
            "required": true,
            "description": "Suchbegriff (Jobtitel, Tätigkeit, Skill).",
            "schema": { "type": "string" }
          },
          {
            "name": "location",
            "in": "query",
            "required": false,
            "description": "Ort, Stadt oder PLZ.",
            "schema": { "type": "string" }
          },
          {
            "name": "country",
            "in": "query",
            "required": false,
            "description": "Strikt auf ein Land einschränken: AT (Österreich), DE (Deutschland) oder CH (Schweiz). Kombinierbar mit location.",
            "schema": { "type": "string", "enum": ["AT", "DE", "CH"] }
          },
          {
            "name": "remote",
            "in": "query",
            "required": false,
            "description": "Auf Remote-/Homeoffice-Stellen einschränken. Hinweis: Volltext-Heuristik, kein strukturiertes Feld, kann ungenau sein.",
            "schema": { "type": "boolean" }
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "description": "next_cursor aus einer vorherigen Antwort, um die nächste Seite zu laden.",
            "schema": { "type": "string" }
          }
        ],
        "responses": {
          "200": {
            "description": "Trefferliste",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "results": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "id": { "type": "string", "description": "ID des Treffers, für /fetch." },
                          "title": { "type": "string" },
                          "company": { "type": "string" },
                          "location": { "type": "string" },
                          "date": { "type": "string", "description": "Veröffentlichungsdatum der Anzeige (YYYY-MM-DD), sofern bekannt." }
                        }
                      }
                    },
                    "next_cursor": {
                      "type": ["string", "null"],
                      "description": "Cursor für die nächste Seite, oder null wenn keine weitere Seite verfügbar/erlaubt ist."
                    }
                  }
                }
              }
            }
          },
          "400": { "$ref": "#/components/responses/Error" },
          "429": { "$ref": "#/components/responses/Error" },
          "503": { "$ref": "#/components/responses/Error" }
        }
      }
    },
    "/fetch": {
      "get": {
        "operationId": "fetchJob",
        "summary": "Job-Details abrufen",
        "description": "Liefert die vollständigen Details zu einer Stellenanzeige anhand ihrer id. Das Feld apply_url ist der Bewerbungslink — diesen NICHT selbst abrufen, sondern dem Nutzer als anklickbaren Link ausgeben, damit er sich bei Interesse selbst bewirbt.",
        "parameters": [
          {
            "name": "id",
            "in": "query",
            "required": true,
            "description": "Die id eines Treffers aus /search.",
            "schema": { "type": "string" }
          }
        ],
        "responses": {
          "200": {
            "description": "Job-Details",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "id": { "type": "string" },
                    "title": { "type": "string" },
                    "company": { "type": "string" },
                    "description": { "type": "string" },
                    "salary_string": { "type": "string" },
                    "employmenttype": { "type": "string" },
                    "location": { "type": "string" },
                    "date": { "type": "string", "description": "Veröffentlichungsdatum der Anzeige (YYYY-MM-DD), sofern bekannt." },
                    "apply_url": { "type": "string", "description": "Bewerbungslink zur Original-Stellenanzeige (Weiterleitung über alleskralle.com). NICHT selbst abrufen — dem Nutzer als anklickbaren Link ausgeben, damit er sich selbst bewirbt." }
                  }
                }
              }
            }
          },
          "404": { "$ref": "#/components/responses/Error" },
          "429": { "$ref": "#/components/responses/Error" },
          "503": { "$ref": "#/components/responses/Error" }
        }
      }
    }
  },
  "components": {
    "responses": {
      "Error": {
        "description": "Fehler",
        "content": {
          "application/json": {
            "schema": {
              "type": "object",
              "properties": {
                "error": {
                  "type": "object",
                  "properties": {
                    "code": { "type": "string" },
                    "message": { "type": "string" }
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}