# In meiner Nähe - lokale Betriebe in Deutschland (Connector)

Stand: Prototyp v0.1.0. Nicht bei Meta eingereicht, nicht von Meta geprüft.

## Produktbeschreibung (Entwurf für die Connector-Einreichung)
Findet lokale Betriebe in ganz Deutschland - vom Zahnarzt über die Bankfiliale bis zum Elektriker - im Umkreis einer Postleitzahl, Koordinate oder eines Orts. Ergebnisse sind nach Entfernung sortiert und zeigen, ob der Betrieb zum gewünschten Zeitpunkt geöffnet hat, dazu Adresse, Telefon und Website. Über 1 Million Einträge in 81 Kategorien aus offenen Daten (OpenStreetMap, Overture Maps). Der Connector liefert Orts- und Kontaktinformationen, keine Beratung und keine bezahlten Platzierungen.

## Einbinden
- MCP-Server (Streamable HTTP): `https://naehe.agentifizierung.de/mcp`
- Suche/Details: ohne Anmeldung. Sandbox-Tools: `Authorization: Bearer <API-Key>`.

## Tools
| Tool | Zweck | Anmeldung |
|---|---|---|
| list_categories | alle Kategorien + Anzahl Einträge | nein |
| find_nearby | Umkreissuche je Kategorie, Radius, Zeitpunkt, Filter, Öffnungsstatus | nein |
| get_business | Details zu einer ID | nein |
| atm_fee_hint | Bank: Indikation gebührenfreier Automaten-Netze in der Nähe | nein |
| sandbox_list_sample_businesses | fiktive Betriebe + freie Slots | nein |
| sandbox_hold_slot | Slot vormerken (hold_id, Ablaufzeit, kein Preis) | ja |
| sandbox_request_appointment | Hold -> Sandbox-Termin, nur mit user_approved=true + idempotency_key | ja |
| sandbox_my_bookings | eigene Holds/Termine | ja |

## Beispiel-Prompts
- "Welcher Zahnarzt in 50667 hat heute nach 18 Uhr noch offen?"
- "Ich bin bei der Sparkasse - wo in der Nähe vom Marienplatz hebe ich vermutlich ohne Gebühr ab?"
- "Such mir einen Elektriker im Umkreis von 5 km um 10115 mit Telefonnummer."
- "Welche Bäckereien haben am Sonntag um 8 Uhr in Hamburg-Altona offen?"
- "Gibt es eine Tierarztpraxis in der Nähe, die jetzt geöffnet ist?"

## Kategorien
Arztpraxis, Augenarzt, Autoglas, Autohaus, Autowerkstatt, Bank, Baumarkt, Blumenladen, Bäcker, Café, Containerdienst, Copyshop, Dachdecker, Datenrettung, Detektei, Drogerie, Eisdiele, Elektriker, Elektrofachgeschäft, Entrümpelung, Fahrradwerkstatt, Fahrschule, Fahrzeugaufbereitung, Fensterbauer, Fliesenleger, Friseur, Gartenbau, Gebäudereinigung, Goldankauf, Gärtner, Handyreparatur, Hausgeräte-Kundendienst, Hausverwaltung, Heilpraktiker, Heizungsbauer, Hotel, Hörakustiker, Immobilienmakler, Kfz-Gutachter, Kino, Klimaanlagen-Installateur, Kosmetikstudio, Krankenhaus, Küchenstudio, Laserhaarentfernung, Maler, Massage, Möbelhaus, Nachhilfe, Nagelstudio, Notar, Optiker, Parkhaus, Pflegedienst, Physiotherapie, Pilates, Pizzeria, Reifenwechsel, Restaurant, Rohrreinigung, Sanitär, Schneiderei, Schuhgeschäft, Schuldnerberatung, Schädlingsbekämpfung, Solaranlagen-Anbieter, Steuerberater, Supermarkt, Tankstelle, Tattooentfernung, Tattoostudio, Tierklinik, Transporter mieten, Umzugsunternehmen, Versicherungsmakler, Werbeagentur, Yoga-Studio, Zahnarzt, Zahnimplantate, Zoohandlung, Ölwechsel

## Fehlercodes
Wie bei den Einzelverzeichnissen (siehe z. B. https://bank-in-meiner-naehe.de/connector.md), plus CATEGORY_REQUIRED/CATEGORY_AMBIGUOUS (400), CATEGORY_NOT_FOUND (404), UPSTREAM_UNAVAILABLE (503).

## Datenschutz
Standortangaben werden nur für die jeweilige Anfrage genutzt und weder gespeichert noch geloggt. Sandbox-Daten enthalten nur fiktive Betriebe und den Nutzer-Bezeichner des API-Keys.

## Verifiziert vs. Annahme
Verifiziert: MCP-Handshake und Tool-Aufrufe mit dem offiziellen MCP-Python-SDK, Umkreissuche, Öffnungsstatus (unklare Formate -> unknown), Auth pro Nutzer, Hold-Ablauf, Idempotenz.

Annahmen (nicht verifiziert): Auth-Methode, die Muse akzeptiert (Bearer vs. OAuth); Einbindung per URL; Review-Kriterien und Kategorien des Meta-Verzeichnisses.

## Support
info@agentifizierung.de · +49 30 754 202 99 · Betreiber: yawusa UG (haftungsbeschränkt), Impressum: https://naehe.agentifizierung.de/impressum