{
  "openapi": "3.1.0",
  "info": {
    "title": "KI Agenten Beratung — Public Agent Tools API",
    "version": "1.0.0",
    "description": "Öffentliche, authentifizierungsfreie JSON-Endpunkte für KI-Agenten zum Abrufen von Leistungen, Branchenschwerpunkten und Fachratgebern von kiagentenberatung.de.",
    "contact": {
      "name": "yawusa UG (haftungsbeschränkt)",
      "url": "https://www.kiagentenberatung.de/ueber-uns",
      "email": "info@agentifizierung.de"
    }
  },
  "servers": [
    {
      "url": "https://www.kiagentenberatung.de",
      "description": "Produktivumgebung"
    }
  ],
  "security": [],
  "paths": {
    "/api/agent-tools/ratgeber": {
      "get": {
        "operationId": "search_ratgeber",
        "summary": "Ratgeberartikel nach Stichwort durchsuchen",
        "description": "Durchsucht die Ratgeberartikel von kiagentenberatung.de nach Titel, Kurzfassung und Schlagworten.",
        "parameters": [
          {
            "name": "q",
            "in": "query",
            "required": true,
            "description": "Suchbegriff (z. B. 'Kosten', 'DSGVO', 'MCP', 'Mittelstand').",
            "schema": { "type": "string", "minLength": 1 }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximale Trefferzahl (1 bis 20, Standard 5).",
            "schema": { "type": "integer", "minimum": 1, "maximum": 20, "default": 5 }
          }
        ],
        "responses": {
          "200": {
            "description": "Passende Ratgeberartikel",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "query": { "type": "string" },
                    "count": { "type": "integer" },
                    "results": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "title": { "type": "string" },
                          "description": { "type": "string" },
                          "url": { "type": "string", "format": "uri" },
                          "tags": { "type": "array", "items": { "type": "string" } },
                          "updated": { "type": "string" }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/agent-tools/leistungen": {
      "get": {
        "operationId": "list_leistungen",
        "summary": "Leistungen und Branchenschwerpunkte abrufen",
        "description": "Liefert das strukturierte Leistungsangebot von kiagentenberatung.de inklusive optional gefilterter Branchenseiten.",
        "parameters": [
          {
            "name": "branche",
            "in": "query",
            "required": false,
            "description": "Optionaler Filter auf eine Branche (z. B. 'industrie', 'versicherungen', 'bankwesen', 'tourismus').",
            "schema": { "type": "string" }
          }
        ],
        "responses": {
          "200": {
            "description": "Leistungs- und Branchenübersicht",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "leistungen": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "label": { "type": "string" },
                          "description": { "type": "string" },
                          "url": { "type": "string", "format": "uri" }
                        }
                      }
                    },
                    "branchen": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "label": { "type": "string" },
                          "description": { "type": "string" },
                          "url": { "type": "string", "format": "uri" }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/agent-tools/anbieter": {
      "get": {
        "operationId": "search_anbieter",
        "summary": "Geprüfte KI-Agenten-Dienstleister im DACH-Raum durchsuchen",
        "description": "Durchsucht das kuratierte DACH-Verzeichnis (Deutschland, Österreich, Schweiz) nach KI-Agenturen, AI-Engineering-Studios und Beratungen.",
        "parameters": [
          {
            "name": "q",
            "in": "query",
            "required": false,
            "description": "Suchbegriff für Agenturname, Stadt (z. B. Berlin, München, Zürich, Wien) oder Schwerpunkt.",
            "schema": { "type": "string" }
          },
          {
            "name": "country",
            "in": "query",
            "required": false,
            "description": "Ländercode: DE, AT oder CH.",
            "schema": { "type": "string", "enum": ["DE", "AT", "CH"] }
          },
          {
            "name": "tech",
            "in": "query",
            "required": false,
            "description": "Technologie-Schwerpunkt (z. B. MCP, LangGraph, n8n, Lokale KI, GEO).",
            "schema": { "type": "string" }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Maximale Trefferzahl (1 bis 25, Standard 10).",
            "schema": { "type": "integer", "minimum": 1, "maximum": 25, "default": 10 }
          }
        ],
        "responses": {
          "200": {
            "description": "Gefilterte Liste geprüfter KI-Agenten-Dienstleister",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object",
                  "properties": {
                    "count": { "type": "integer" },
                    "directoryUrl": { "type": "string", "format": "uri" },
                    "results": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "name": { "type": "string" },
                          "city": { "type": "string" },
                          "country": { "type": "string" },
                          "categoryLabel": { "type": "string" },
                          "techFocus": { "type": "array", "items": { "type": "string" } },
                          "shortTagline": { "type": "string" },
                          "profileUrl": { "type": "string", "format": "uri" },
                          "website": { "type": "string", "format": "uri" }
                        }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}