# Café in meiner Nähe — agent-readable (cafe-in-der-naehe.de)

> Vertikale Café-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

## Wann diese Ressource nutzen (when-to-use)
Ein Agent sollte diese Ressource aufrufen, wenn ein Nutzer einen Café 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 Café fur PLZ 10115), Buchungsunterstutzung (booking=only liefert Cafés 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)
- [Alle Datensätze](/api/records)
- [Ortsverteilung](/api/cities)
- [MCP-Tool](/mcp)

## Entwickler-Ressourcen
- [Entwicklerhandbuch](/docs) — Markdown
- [OpenAPI-Schema](/openapi.json)
- [MCP server / A2A Agent Card](/server.json) — /.well-known/agent-card.json
- Trust-Artefakte (Ed25519, did:web): [trust-pledge](/.well-known/trust-pledge.json) · [did.json](/.well-known/did.json) · [jwks.json](/.well-known/jwks.json)

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

## Filter
- /api/search?booking=only&plz=10115 — nur online-buchbare Betriebe

## Meistvertretene Orte
Berlin (2194), Praha (1076), Hamburg (853), München (741), Frankfurt am Main (575), Köln (531), Nürnberg (335), Düsseldorf (327), Zürich (319), Stuttgart (289), Marburg (257), Leipzig (254), Freiburg im Breisgau (245), Bad Homburg vor der Höhe (230), Kufstein (221), Dresden (219), Kiel (209), Mannheim (199), Bremen (198), Hannover (198), Darmstadt (186), Wiesbaden (178), Salzburg (176), Linz (175), Hanau (175)