# Friseur in meiner Nähe — agent-readable (friseur-in-meiner-naehe.de)

> Vertikale Friseur-Datenraffinerie, bundesweit (kein Städte-Cap). Geo-sortiert — nicht alphabetisch.
> Ein Projekt von Agentifizierung (https://agentifizierung.de) — maschinenlesbare Geschäftsdaten für KI-Agenten.

Quellen: OpenStreetMap (ODbL 1.0, © OpenStreetMap contributors) & Overture Maps Foundation (CDLA-Permissive-2.0)
Attribution: https://www.openstreetmap.org/copyright · https://overturemaps.org

## Kernseiten
- [Startseite](https://friseur-in-meiner-naehe.de/): Suche nach PLZ, geo-sortierte Ergebnisliste
- [Entwicklerhandbuch](https://friseur-in-meiner-naehe.de/docs): API, Felder, Fehlerformat, Versionierung
- [Agent-Instruktionen](https://friseur-in-meiner-naehe.de/agents.md): when to use, Aufruf-Muster
- [OpenAPI-Schema](https://friseur-in-meiner-naehe.de/openapi.json): vollstaendiger API-Kontrakt

## Wann diese Ressource nutzen (when to use)
Ein Agent sollte diese Ressource aufrufen, wenn ein Nutzer einen Friseur in einer bestimmten deutschen Postleitzahl oder um eine Koordinaten-Position sucht und eine nach Entfernung sortierte, kontaktierbare Ergebnisliste inklusive Online-Buchbarkeit braucht. Typische Nutzungen: Empfehlungs-Suche (nachster Friseur fur PLZ 10115), Buchungsunterstutzung (booking=only liefert Friseure mit direkter Buchungs-URL), und strukturierte Dateneingabe in eigene Agent-Pipelines. Nutze die json-API `/api/search` mit `plz` fur terrestrische Suche; `lat`/`lon` fur Koordinaten. Nicht geeignet fur landes-/bundesweite Marktanalysen — dafur `GET /api/records`.

## Endpoints
- [API-Suche nach PLZ](/api/search?plz=10115&limit=10): sortiert nach Distanz (empfohlen)
- [API-Suche nach Koordinaten](/api/search?lat=52.52&lon=13.40&limit=10): nach Koordinaten sortiert
- [API-Suche nach Name/Stadt](/api/search?q=&limit=10): Freitextsuche
- [Alle Datensätze](/api/records): kompletter Bulk-Export
- [Ortsverteilung](/api/cities): Datensaetze je Ort
- [MCP-Tool](/mcp): Streamable-HTTP-MCP-Server

## Entwickler-Ressourcen
- [Entwicklerhandbuch](/docs): Markdown
- [llms-full.txt](/llms-full.txt): alle Kernseiten als eine Markdown-Datei
- [OpenAPI-Schema](/openapi.json): API-Kontrakt
- [MCP server / A2A Agent Card](/server.json): auch unter /.well-known/agent-card.json
- [MCP-Server-Card](/.well-known/mcp.json): Discovery (MCP-Registry server.schema.json)
- [Auth-Hinweise](/auth.md): keyless, Rate-Limit-Header
- [WebMCP In-Page-Tools](/docs): auf der Startseite via document.modelContext registriert — search_friseur_by_plz, search_friseur_by_coords, get_friseur_directory_info (read-only)
- [Agentic Resource Discovery Katalog](/.well-known/ai-catalog.json): agenticresourcediscovery.org
- [Trust-Pledge](/.well-known/trust-pledge.json): Ed25519/did:web · [did.json](/.well-known/did.json) · [jwks.json](/.well-known/jwks.json)

## Verwandte Agent-Ressourcen
- [movetogermany.lol](https://movetogermany.lol/llms.txt): Ankommens-/Umzugs-Planer ueber diesem Netzwerk — Mensch + KI-Agent bauen per WebMCP gemeinsam die Grundversorgung fuer eine neue Adresse (EN/DE, Jobs via Bundesagentur-API)

## Felder
name, city, street, housenumber, postcode, lat, lon, phone, website, email, opening_hours, completeness_score, booking_capable, booking_platform, booking_url

## Filter
- [Nur online-buchbare Betriebe](/api/search?booking=only&plz=10115): booking=only-Filter

## Meistvertretene Orte
bundesweit