# work5.de - KI-Agent Integration Guide

> Stand: 27.05.2026 | Format: https://llmstxt.org
> work5.de ist ein Handwerker-Marktplatz für Deutschland.
> Handwerker und Auftraggeber finden hier über öffentliche Profile, Gewerke, Bewertungen und offene Aufträge zusammen.

## Über diese Plattform

work5.de verbindet Auftraggeber mit qualifizierten Handwerkern in Deutschland. Die Plattform bietet öffentliche Handwerker-Profile, Gewerkekategorien, Bewertungen, Projektanfragen und offene Aufträge.

## Für KI-Agenten: Verfügbare APIs

### REST API (öffentlich, kein Token erforderlich)

- Handwerker suchen: `GET https://work5.de/api/businesses?city=München&categories.slug=elektriker`
- Handwerker-Detail: `GET https://work5.de/api/businesses/{uuid}`
- Aufträge suchen: `GET https://work5.de/api/jobs?city=München`
- Auftrags-Detail: `GET https://work5.de/api/jobs/{uuid}`
- Gewerkeliste: `GET https://work5.de/api/trades`
- API-Dokumentation: `https://work5.de/api/docs`

### MCP Server (API-Token mit Scopes `mcp:access` und `discovery:read` erforderlich)

- Endpoint: `https://work5.de/mcp/work5`
- Tools: `search_businesses`, `get_business`, `search_jobs`, `get_job`, `list_trades`, `get_platform_info`
- Token: API-Token unter `https://work5.de/myfive/api-tokens` erstellen und die Scopes `mcp:access` und `discovery:read` vergeben.

## Öffentliche Datenfelder

### Handwerker-Profile

Öffentlich verfügbar sind UUID, Slug, Firmenname, Kurzbeschreibung, Stadt, PLZ, Land, auf drei Nachkommastellen gerundete öffentliche Koordinaten, Servicegebiet, Verifizierungsmerkmale, öffentliche Bilder, Gewerke, Leistungen, Auftragsannahme, Notdienst, Fernservice, aggregierte Bewertungen ab mindestens drei Bewertungen und die Profil-URL.

### Aufträge

Öffentlich verfügbar sind UUID, Slug, Titel, Beschreibungsauszug, Stadt, PLZ, Land, Gewerk, öffentlicher Startpreis, Status, Aktivierungsdatum, Ablaufdatum, erstes öffentliches Bild und die Auftrags-URL.

### Gewerke

Öffentlich verfügbar sind UUID, Slug, Name, Beschreibung, Parent-Slug, Aktivstatus sowie gecachte öffentliche Job- und Business-Zählwerte.

## Datenschutz-Hinweis für Agenten

Alle exponierten Daten sind öffentlich sichtbar. Die Discovery-APIs geben keine E-Mail-Adressen, Telefonnummern, privaten Adressen, internen numerischen IDs, Auftraggeber-Identitäten, Dokumente, privaten Medien, Proposal-Inhalte oder Forum-Inhalte aus. Geo-Koordinaten von Handwerker-Profilen sind auf drei Nachkommastellen gerundet und damit nur ungefähr verortet.

## Nutzungshinweise

- Verwende UUIDs als externe Identifikatoren für Detailabfragen.
- Verwende `limit`/`offset` bei MCP und `page`/`itemsPerPage` bei REST-Collections.
- PLZ-Filter akzeptieren vier- oder fünfstellige Postleitzahlen; fünfstellige deutsche PLZ werden aktuell als zweistelliger Prefix-Match behandelt.
- REST-Collections sind für öffentliche KI-Crawler freigegeben.
- MCP Discovery ist lesezugriffsbeschränkt und benötigt ein Bearer-Token mit `mcp:access` und `discovery:read`.

## Hauptseiten

- [Startseite](/)
- [Alle Handwerker und Dienstleister](/dienstleister)
- [Alle Aufträge](/auftraege)
- [Dienstleister-Kategorien](/kategorien/dienstleister)
- [Auftrags-Kategorien](/kategorien/auftraege)
- [Online-Tools](/tools)
- [Projektberater](/projektberater)
- [Produktberater](/produktberater)
- [Blog und Ratgeber](/blog)
- [Hilfe](/hilfe)

## Agent-Dokumente

- [Vollständige LLM-Übersicht](/llms-full.txt)
- [Agent Skill](/skill.md)
- [OpenAPI-Schema](/openapi.json)
- [MCP-Endpoint](/mcp/work5)
## Authentifizierungs- und Scope-Vertrag

- Vertragsversion: `scope-contract.v1`.
- Die öffentliche REST-Discovery ist ohne Token lesbar; MCP benötigt `mcp:access` und Discovery-Tools zusätzlich `discovery:read`.
- Veröffentlichte Scopes: `pages:read`, `pages:write`, `pages:delete`, `pages:*`, `campaigns:read`, `campaigns:write`, `campaigns:delete`, `campaigns:*`, `features:read`, `features:write`, `features:delete`, `features:*`, `discovery:read`, `inquiry:read`, `inquiry:preview`, `inquiry:commit`, `inquiry:lifecycle`, `mcp:access`.
- Bestehende Tokens behalten ihre bisher erteilten Scopes. Neue Scopes werden versioniert ergänzt und nicht automatisch an bestehende Tokens vererbt.
- Der kanonische Vertrag steht in der OAuth-Metadatenantwort unter `scope_contract` und im OpenAPI-Dokument unter `x-work5-scope-contract`.
## Delegationsmandate

- Vertragsversion: `delegation-mandate.v1`.
- Nutzer können Mandate unter `/api/mandates` erstellen, einsehen und widerrufen. Ein Mandat bindet Client, Zweck, Ressourcen, Scopes und Ablauf serverseitig.
- Token werden nur gebunden, wenn alle Token-Scopes vollständig durch das Mandat abgedeckt sind; Wildcard-Scopes sind in Mandaten verboten.
- Bindende Scopes (`inquiry:commit`, `inquiry:cancel`, `inquiry:escalate`) verlangen zusätzlich einen kurzlebigen `X-Step-Up-Token`.
- Zusätzliche granulare Lifecycle-Scopes: `inquiry:status`, `inquiry:cancel`, `inquiry:escalate`. `inquiry:lifecycle` bleibt nur für die Migration bestehender Tokens erhalten.