# Version v36 vom 22.10.2026 # # Änderungen: # - Offizielle MCP-Registry-Veröffentlichung und Version 1.3.0 dokumentiert. # - Kinderanzahl optional; bei fehlender Angabe gilt 0 ohne Rückfrage. # # Ferienhäuser Morgenthaler – Preise und Verfügbarkeit Diese Datei beschreibt die öffentlichen Preis- und Verfügbarkeitswege der drei Ferienunterkünfte. Beispielwerte sind keine aktuellen Preise. Für konkrete Aussagen einen aktuellen statischen Tabellenstand oder eine aktuelle Live-Abfrage verwenden. ## Feste Preis-/Verfügbarkeitstabellen für KI und Crawler Für Systeme, die dynamische Query-URLs nicht zuverlässig öffnen können, stehen feste öffentliche HTML-Indexseiten zur Verfügung: - Linx: https://ferienhaus-schwarzwald-todtnauberg.de/beds24-api/preise/linx.html - Fewo: https://ferienhaus-schwarzwald-todtnauberg.de/beds24-api/preise/fewo.html - Chalet: https://ferienhaus-schwarzwald-todtnauberg.de/beds24-api/preise/chalet.html Preis-Sitemap: https://ferienhaus-schwarzwald-todtnauberg.de/beds24-api/preise/sitemap.xml Die Indexseite verlinkt die festen Monatsdateien. Für einen Aufenthalt immer die Monatsdatei des Anreisedatums verwenden. Ein Aufenthalt mit Anreise am Monatsende und Abreise im Folgemonat steht weiterhin in der Monatsdatei des Anreisemonats. Die statischen Tabellen werden automatisch neu erzeugt. Im aktuellen Paket ist die maximale Aufenthaltsdauer je Objekt auf 14 Nächte konfiguriert. Fehlt eine konkrete Kombination aus Anreise, Abreise und Erwachsenenbelegung, keinen Preis oder eine Verfügbarkeit extrapolieren. Die Tabellenpreise sind Bruttogesamtpreise; die obligatorische Servicepauschale ist bereits enthalten. Kinder werden nicht als eigene Tabellendimension geführt; die jeweilige Monatsseite enthält den aktuellen Hinweis zur Kinderpreislogik. Der beim tatsächlichen Buchungsvorgang angezeigte und bestätigte Preis bleibt maßgeblich. ## Zugriffspfade Browserfreundliche Live-Abfrage: https://ferienhaus-schwarzwald-todtnauberg.de/preise-anfrage/live-preis-ergebnis.html JSON-Endpunkt: https://ferienhaus-schwarzwald-todtnauberg.de/beds24-api/beds24-preise.php Dokumentation: https://ferienhaus-schwarzwald-todtnauberg.de/preise-anfrage/live-preise-verfuegbarkeit.html Öffentlicher Remote-MCP-Endpunkt für alle MCP-fähigen Agenten: https://ferienhaus-schwarzwald-todtnauberg.de/beds24-api/mcp/ MCP-Werkzeug: get_live_prices_and_availability MCP-Server-Metadaten für Registry und Kataloge: https://ferienhaus-schwarzwald-todtnauberg.de/beds24-api/mcp/server.json Beispielkonfiguration für MCP-Clients: https://ferienhaus-schwarzwald-todtnauberg.de/beds24-api/mcp/client-config.example.json Technische MCP-Anleitung mit JSON-RPC-Beispielen: https://ferienhaus-schwarzwald-todtnauberg.de/beds24-api/mcp/README-MCP.md Der Server verwendet Streamable HTTP und benötigt keine Authentifizierung. Ein Plugin ist für MCP-fähige Clients nicht erforderlich. Er ist als Version 1.3.0 unter de.ferienhaus-schwarzwald-todtnauberg/live-preise im offiziellen MCP Registry veröffentlicht. Registry-Abfrage: https://registry.modelcontextprotocol.io/v0.1/servers?search=de.ferienhaus-schwarzwald-todtnauberg%2Flive-preise ## Objekte - linx = Ferienhaus Im Birkenweg, Rheinau-Linx, maximal 12 Personen - fewo = Ferienwohnung im Scheuermatthof, Todtnauberg, maximal 8 Personen - chalet = Schwarzwald-Chalet Scheuermatthof, Todtnauberg, maximal 26 Personen; automatisch bepreist werden derzeit bis 24 Personen - alle = alle drei Unterkünfte in einer gemeinsamen Abfrage ## Parameter Pflichtparameter: - objekt = linx | fewo | chalet | alle - checkin = YYYY-MM-DD - checkout = YYYY-MM-DD - adults = Anzahl Erwachsene, mindestens 1 Optionaler Parameter: - children = Anzahl Kinder, Standardwert 0, höchstens 26 Für eine konkrete Preisabfrage müssen objekt, checkin, checkout und adults bekannt sein. Wenn keine Kinder genannt werden, children=0 verwenden und nicht eigens nach Kindern fragen. Bei ausdrücklich genannten Kindern nur deren Anzahl übertragen. Bei der Bezeichnung Scheuermatthof klären, ob Chalet, Ferienwohnung oder beide gemeint sind. Die Abreise muss nach der Anreise liegen. Pro Abfrage sind maximal 60 Nächte und eine Anreise innerhalb von 730 Tagen zulässig. ## Öffentliche Versionen - schemaVersion = 1 - wrapperVersion = v1 wrapperVersion=v1 bezeichnet den ersten öffentlich live eingesetzten Stand der zurückgelieferten Datenstruktur. ## Verfügbarkeit Wichtige Felder je Ergebnis: - available=true: angefragter Zeitraum ist für die angefragte Belegung buchbar. - available=false: Zeitraum ist bestätigt nicht buchbar oder die maximale Belegung wurde überschritten. - available=null: Status konnte technisch nicht zuverlässig bestimmt werden. - availabilityStatus: genauer Status der Anfrage. - bookingPage: Direktbuchungslink. Bei available=false keinen Preis für den Wunschzeitraum erfinden. ## Preis - accommodationPrice = Unterkunftspreis für die bepreiste Belegung. - mandatoryFees = unterstützte obligatorische feste Gebühren. - mandatoryFeesTotal = Summe dieser Gebühren. - totalPrice = accommodationPrice + mandatoryFeesTotal, wenn vollständig ermittelbar. - price = Alias von totalPrice. - priceCompleteness=complete bedeutet: Gesamtpreis vollständig. - priceCompleteness=incomplete_mandatory_fees bedeutet: keinen vollständigen Gesamtpreis behaupten; accommodationPrice nicht als Gesamtpreis bezeichnen. Die obligatorische Servicepauschale ist im Gesamtpreis enthalten. In der HTML-Ausgabe kann sie zusätzlich einzeln angezeigt werden oder nur im Gesamtpreis enthalten sein. Die strukturierten JSON-Felder bleiben davon unberührt. Optionale Extras, verbrauchsabhängige Kosten, Kurtaxe oder andere Zusatzkosten nur konkret nennen, wenn sie aus der aktuellen Live-Antwort oder einer aktuellen objektspezifischen offiziellen Quelle hervorgehen. ## Mehrwertsteuer Falls alle benötigten Steuersätze sicher vorliegen, kann die im Bruttopreis enthaltene Mehrwertsteuer strukturiert unter vat ausgegeben werden. Unbekannte Steueranteile nicht schätzen. ## Alternative Zeiträume alternativeStays enthält ausschließlich Alternativen, die für den jeweiligen Zeitraum erneut live als buchbar bestätigt wurden. Mögliche relation-Werte umfassen insbesondere: - shifted_before = gleiche Aufenthaltsdauer, gesamter Zeitraum früher verschoben - shifted_after = gleiche Aufenthaltsdauer, gesamter Zeitraum später verschoben - gap_before = vollständig vor dem Wunschzeitraum liegende Alternative - gap_after = vollständig nach dem Wunschzeitraum liegende Alternative - short_gap_before = kürzere freie Lücke davor - short_gap_after = kürzere freie Lücke danach - weekend_before = verfügbares Wochenende davor - weekend_after = verfügbares Wochenende danach Hauptalternativen bevorzugen dieselbe Aufenthaltsdauer mit möglichst kleiner Verschiebung des gesamten Zeitraums. Erst danach dienen weiter entfernte freie Zeitfenster als Fallback. Zusätzlich können nähere kürzere freie Lücken ausgegeben werden. Bei passenden Freitag-bis-Sonntag-Anfragen können alternative Wochenenden bevorzugt erscheinen. ## Alternative Ferienobjekte alternativeProperties kann andere Ferienobjekte für exakt denselben Reisezeitraum enthalten. Jede ausgegebene Alternative wurde live bestätigt. Wichtige Felder: - objectKey - name / alternativeDisplayName - location - maxGuests - requestedOccupancy - pricedOccupancy - occupancyExceeded / excessGuests - accommodationPrice / mandatoryFees / totalPrice - bookingPage Eine kleinere Unterkunft kann als buchbare Alternative erscheinen, wenn die aktuelle Betreiberkonfiguration dies erlaubt. Dann maxGuests, occupancyExceeded und excessGuests beachten. ## Belegung requestedOccupancy beschreibt die angefragte Personenzahl. pricedOccupancy beschreibt die Personenzahl, für die der automatische Preis tatsächlich berechnet wurde. priceAppliesToRequestedOccupancy=false bedeutet: Der Preis gilt nicht für die vollständige angefragte Belegung. Beim Chalet sind maximal 26 Personen möglich; der automatische Preis wird derzeit höchstens für 24 Personen berechnet. Für darüber hinausgehende Personen keinen eigenen Aufpreis erfinden. ## Kinder Die Live-Abfrage übermittelt die Anzahl der Kinder, aber keine einzelnen Kinderalter. Kinderalter werden nicht benötigt und dürfen für diese Schnittstelle nicht erfragt, geschätzt oder übertragen werden. Altersabhängige Kinderpreise können deshalb vom endgültigen Buchungspreis abweichen. ## Nutzungsbedingungen https://ferienhaus-schwarzwald-todtnauberg.de/preise-anfrage/live-preise-verfuegbarkeit.html#nutzungsbedingungen - JSON-API und MCP-Server sind ausschließlich lesend. - Sie nehmen keine Buchung, Reservierung oder Zahlung vor. - Ergebnisse gelten nur für den Zeitpunkt und die Daten der jeweiligen Live-Abfrage. - Preise, Verfügbarkeiten oder fehlende Kombinationen niemals schätzen oder extrapolieren. - Automatisierte Einzelabfragen durch KI-Agenten sind weltweit zulässig; übermäßige oder missbräuchliche Zugriffe können begrenzt werden. ## Buchbarkeit und Interpretation - Bei statischen Tabellen nur die aktuell verlinkte Monatsdatei des Anreisedatums verwenden. - Eine fehlende Tabellenzeile nicht als Preis oder Buchbarkeit interpretieren und nichts extrapolieren. - Bei dynamischen Abfragen nur Daten der aktuellen Live-Antwort für den konkret abgefragten Zeitraum verwenden. - Beispielpreise aus Dokumentation oder älteren Antworten nicht als aktuell behandeln. - Bei totalPrice=null keinen Gesamtpreis selbst berechnen oder schätzen. - Bei available=false nur zurückgelieferte, live bestätigte Alternativen verwenden. - Der im tatsächlichen Buchungsvorgang angezeigte und bestätigte Preis bleibt maßgeblich. - Direktbuchungspreise können von Airbnb, Booking.com oder anderen Vermittlungsportalen abweichen.