Fragen & Antworten

Das Widget zeigt eine fertige Liste auf deiner Website und braucht eine Widget-ID. Die Partner-API liefert Daten für eigene Anwendungen und braucht eine separat freigegebene API-ID. ChatGPT und Claude verwenden die MCP-Anbindung für Suchanfragen im Gespräch.

Nutze „Partner-ID anfragen“ auf der Widget- oder API-Seite. Ergänze Name, Website, Region, Verwendung und den gewünschten Typ: Widget oder API. Wir prüfen die Anfrage und vergeben die Kennung für diesen Zugang. Für beide Typen brauchst du getrennte IDs; eine automatische Freischaltung gibt es derzeit nicht.

Nein. Die Kennung ist kein Geheimnis; im Widget steht sie sichtbar im HTML. Sie muss für den angesprochenen Endpunkt aktiv und mit dem passenden Typ freigegeben sein. Ist eine Website hinterlegt, prüfen wir zusätzlich deren genaue Origin. Fremde Browser können ihren Origin-Header nicht frei setzen; Serverprogramme können ihn nachahmen. Die ID und CORS sind deshalb keine starke Server-Authentisierung.

Nein. Ersetze DEINE-PARTNER-ID durch die ausgegebene Kennung des passenden Typs. Fehlende oder fehlerhafte Werte werden mit 400 abgelehnt. Unbekannte oder deaktivierte Kennungen, der falsche Typ sowie eine fehlende oder fremde Origin bei Website-Bindung erhalten 403. Die lokale Vorschau ist davon unabhängig.

Beschreibe deinen Einsatzzweck bei der Anfrage. Wir klären die Freigabe und Konditionen mit dir, bevor du Widget oder Partner-API verwendest. Aus einer technischen Vorschau ergibt sich keine zugesagte Nutzung oder Verfügbarkeit.

Nein. Füge den Einbettcode in einen Block „Individuelles HTML“ ein. Dein WordPress-Konto und dein Hosting-Tarif müssen JavaScript in diesem Bereich erlauben. Das Widget funktioniert auch auf anderen Websites mit eigenem HTML und JavaScript.

WordPress, dein Tarif oder ein Sicherheitsplugin kann Skripte aus Beiträgen entfernen. Prüfe den veröffentlichten HTML-Code und die Berechtigungen. Binde das Skript gegebenenfalls über eine dafür vorgesehene Theme-Funktion ein; der Widget-Container bleibt an der gewünschten Stelle.

Ja. Jeder Container bekommt seine eigenen data-Parameter. Das gemeinsame SDK reicht einmal pro Seite; mehrere Einbindungen werden ebenfalls erkannt. Die Standard-CSS-Datei wird nur einmal geladen.

Kompatible Updates werden über dieselbe Datei /cdn/widgets/v1.js ausgeliefert. Skript und CSS dürfen eine Stunde im HTTP-Cache liegen. Deine eingebauten Parameter bleiben erhalten. Änderungen an deinem eigenen CSS musst du selbst prüfen.

Verwende eine Liste genauer fünfstelliger PLZ oder eine PLZ mit Umkreis bis 200 km. PLZ und Kreise bilden Verwaltungsregionen nicht exakt ab. Für eine grobe regionale Auswahl reicht das häufig; PLZ-Präfixe wie 92* akzeptiert das Widget nicht.

Nein. Wähle entweder postcodes oder die Kombination postcode und radius-km. Suchtext und Datumsbereich kannst du in beiden Fällen zusätzlich angeben.

50 ist das Maximum pro Ladung, nicht für die gesamte Liste. Standard sind 20. „Mehr laden“ hängt die nächste Seite an, sofern weitere Ergebnisse verfügbar sind. Der Endpunkt akzeptiert einen Offset bis 1.000.

Ja, mit data-show-more="false". Dann zeigt das Widget nur die erste Seite. Beide Vorgabensätze lassen die Schaltfläche standardmäßig an. Ein Wiederholungsbutton nach einem Ladefehler bleibt unabhängig davon möglich.

Der Katalog wird regelmäßig aktualisiert; Ergebnisdaten werden bis zu 30 Minuten gecacht. Auch kurzfristige Absagen können später sichtbar werden. Prüfe vor einer längeren Anfahrt den Markt und die verlinkte Veranstalterquelle.

Die Vorschau zeigt ausdrücklich feste Beispieldaten. Sie verwendet den echten Widget-Code, fragt aber keine echten Termine ab. Deine Region und Suche werden in den kopierbaren Einbettcode übernommen und wirken erst auf deiner Website.

Ohne Treffer zeigt das Widget einen verständlichen Hinweis. Bei einem Ladefehler bietet es „Erneut versuchen“ an. Ein Fehler wird nicht als leere Ergebnisliste ausgegeben.

full aktiviert Standard-CSS, Rahmen, Überschrift, Datum, Ort und Quellenzeile. minimal schaltet diese Vorgaben aus und zeigt eine einfache Linkliste. „Mehr laden“ bleibt an. Jeder ausdrückliche Parameter überschreibt den gewählten Vorgabensatz.

Akzent, Text und Hintergrund über data-color-accent, data-color-text und data-color-background. Akzeptiert werden #RGB und #RRGGBB. Wähle gut lesbare Kontraste. Ohne Standard-CSS bestimmt dein eigenes Stylesheet die Darstellung.

Ja. data-heading setzt reinen Text; data-show-heading="false" blendet ihn aus. Mit data-heading-level von 2 bis 5 passt du die Überschriftenhierarchie deiner Seite an. HTML innerhalb der Überschrift ist nicht vorgesehen.

Ja. Mit data-mode="minimal" erhältst du eine Linkliste ohne Standard-CSS. Du kannst einzelne Inhalte wieder einschalten. Alle mf-widget-Klassen bleiben im normalen HTML erhalten; eine Shadow-DOM-Abschirmung gibt es nicht.

Normalerweise nicht. Verwende einen eigenen Container und ausreichend spezifische Regeln, zum Beispiel .meine-maerkte .mf-widget__link. Unsere Standardregeln gelten nur innerhalb des Widgets. Die Reihenfolge und Spezifität der Styles deiner Website bleiben maßgeblich.

Die Standardliste passt sich der Breite ihres Containers an. Prüfe trotzdem deine veröffentlichten Seiten, besonders bei langen Marktnamen und eigenem CSS. Eine feste Höhe, Karte oder ein konfigurierbarer Karten-/Rastermodus ist derzeit nicht vorgesehen.

Nein. Es verwendet keine Anmeldung, Cookies, Analyse- oder Werbedienste und keinen Local Storage. Es lädt keine externen Karten, Bilder oder Schriften. Der normale HTTP-Cache kann Skript, CSS und Ergebnisse zwischenspeichern.

Das lässt sich nicht pauschal für jede Website zusagen. Beim Laden werden Verbindungsdaten einschließlich der IP-Adresse verarbeitet. Prüfe Rechtsgrundlage, Informationspflichten und gegebenenfalls eine Einwilligung für deine konkrete Einbindung. Der vorbereitete Freigabecode kann eine lokale Zwei-Klick-Lösung bieten, ersetzt aber nicht die rechtliche Prüfung.

Lade das gesamte SDK und rufe mount erst nach der passenden Freigabe auf. Vorher darf auch kein vorsorglicher Skript- oder CSS-Abruf stattfinden. Bei Widerruf rufst du window.MyFlohmarktWidgets.destroy(container) auf. Unser kopierbarer Freigabecode enthält bereits ein einfaches Beispiel ohne Speicherung der Zustimmung.

Pro Partner-ID, Zugangsart (Widget oder API) und Stunde zählen wir Aufrufe, Fehler, ausgelieferte Einträge und Cachetreffer sowie den letzten Aufruf. Diese Aggregate enthalten keine Besucher-ID oder IP-Adresse und werden nach 90 Tagen bereinigt. Browser-Cachetreffer erreichen die API nicht; die Statistik zählt deshalb keine eindeutigen Besucher oder vollständigen Seitenaufrufe.

Das gemeinsame Skript und sein CSS kommen von my-flohmarkt.de unter /cdn/widgets/. Daten lädt das Widget von api.my-flohmarkt.de. Ist deine Partner-ID an eine Website gebunden, funktioniert der Datenabruf nur mit deren genauer Origin; andere oder fehlende Origins werden abgelehnt. Für die Bereitstellung nutzen wir Cloudflare und Hetzner. Die Empfänger stehen in unserer Datenschutzerklärung.

Das Website-Widget braucht eine aktive Widget-ID, die direkte Partner-API eine separat freigegebene API-ID. Die Endpunkte lehnen IDs des anderen Typs ab. ChatGPT, Claude und andere MCP-Clients nutzen https://mcp.my-flohmarkt.de/mcp ohne Partner-ID. Die Partner-API läuft auf api.my-flohmarkt.de und nicht über MCP.

Füge https://mcp.my-flohmarkt.de/mcp als entfernten Streamable-HTTP-Server hinzu. Es gibt keine Anmeldung und kein OAuth. Der Client entdeckt die Werkzeuge über das MCP-Protokoll. Die Adresse ist keine normale Webseite.

Ja. Die getrennten API- und Widget-Endpunkte haben denselben Suchvertrag: limit von 1–50, Standard 20, und offset von 0–1.000. Erhöhe offset für die nächste Seite um limit und beachte hasMore. Die direkte API-Anbindung gestaltet ihren eigenen Button; das Widget bringt „Mehr laden“ mit. Für jeden Zugang ist eine ID des passenden Typs erforderlich.

Nein. Die Werkzeuge sind öffentlich und nur lesend. Sie suchen Termine und lesen Details oder Katalogänderungen. Eintragen und Veranstalterfunktionen nutzt du auf unserer Website; Standbuchungen klärst du mit dem jeweiligen Veranstalter.

Prüfe, ob My Flohmarkt installiert beziehungsweise verbunden ist und starte bei ChatGPT einen neuen Chat. In Claude lässt sich der Connector im Chat aktivieren. Bei Firmenkonten kann eine administrative Freigabe fehlen. Maßgeblich sind außerdem die aktuellen Verfügbarkeiten und Einstellungen des Anbieters.