BeachFinder - beaches and live conditions
Search 184,900 swim spots, conditions, water activities, providers and guides worldwide.
Sollte ich dies verwenden
Qualität und Sicherheit
A
Basierend auf einer automatisierten Analyse der Tool-Definitionen und der Einhaltung des Protokolls.
Kontextkosten
~14,698Tokens (Tool-Definitionen)
~13.9 KBTypische Antwortgröße
Erhebliche Auswirkung auf die Aufmerksamkeit (11.48% von 128k Kontext)
Dies ist die ungefähre Anzahl der Tokens, die jedes Mal verbraucht werden, wenn die Tools des Servers in den Kontext eines Modells geladen werden. Höhere Werte verringern die Aufmerksamkeit, die für andere Aufgaben verfügbar ist.
Installieren
Installation mit einem Klick
Fügen Sie dies Ihrer Datei `claude_desktop_config.json` hinzu:
{
"mcpServers": {
"beachfinder": {
"url": "https://getbeachfinder.com/mcp"
}
}
}Remote-Endpunkte
https://getbeachfinder.com/mcpstreamable-httpWas es kann
Tool-Inventar
Tools (12)
🟢 Nur lesen🟡 Schreiben🔴 Löschen⚪ Unbekannt
🟢search_beaches(query, city, country, lat, lng, ...)
Find public beaches by city or consented coordinates and rank them for swimming, family, warm-water, low-wind, surf, accessibility or amenities. Returns compact results with BeachFinder links.
Eingabe-Schema
{
"type": "object",
"properties": {
"query": {
"type": "string",
"minLength": 1,
"maxLength": 90,
"description": "Exact beach, activity or professional-service request in the user's language. Preserve narrow needs such as surfboard repair, freediving school, SUP rental, rafting guide, campervan rental, motorhome dealer, van conversion or RV repair."
},
"city": {
"type": "string",
"minLength": 1,
"maxLength": 90,
"description": "Destination city; use this instead of coordinates"
},
"country": {
"type": "string",
"minLength": 2,
"maxLength": 60
},
"lat": {
"type": "number",
"minimum": -90,
"maximum": 90,
"description": "Latitude supplied with user consent"
},
"lng": {
"type": "number",
"minimum": -180,
"maximum": 180,
"description": "Longitude supplied with user consent"
},
"radiusKm": {
"type": "number",
"minimum": 1,
"maximum": 150,
"default": 50
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 10,
"default": 5
},
"lang": {
"type": "string",
"enum": [
"en",
"fr",
"es",
"de",
"it",
"pt",
"nl",
"ja",
"ko",
"zh",
"ar",
"tr",
"ru",
"id"
],
"default": "en"
},
"intent": {
"type": "string",
"enum": [
"general",
"swimming",
"family",
"low-wind",
"warm-water",
"surf",
"accessible",
"amenities"
],
"default": "general"
},
"maxWindKmh": {
"type": "number",
"minimum": 0,
"maximum": 150
},
"minWaterTempC": {
"type": "number",
"minimum": -5,
"maximum": 45
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}Ausgabe-Schema
{
"type": "object",
"properties": {
"ok": {
"type": "boolean",
"const": true
},
"operation": {
"type": "string"
},
"query": {
"type": "object",
"additionalProperties": {}
},
"answer": {
"type": "string"
},
"updatedAt": {
"type": "string"
},
"confidence": {
"type": "string",
"enum": [
"high",
"medium",
"low"
]
},
"answerConfidence": {
"type": "string",
"enum": [
"high",
"medium",
"low"
]
},
"primaryAnswerId": {
"type": [
"string",
"null"
]
},
"degraded": {
"type": "boolean"
},
"results": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"entityType": {
"type": "string",
"enum": [
"beach",
"swim_spot",
"river_spot",
"van_spot",
"provider",
"guide"
]
},
"verificationStatus": {
"type": "string",
"enum": [
"owner_verified",
"source_backed",
"mapped"
]
},
"name": {
"type": "string"
},
"category": {
"type": [
"string",
"null"
]
},
"location": {
"type": "string"
},
"distanceKm": {
"type": [
"number",
"null"
]
},
"geo": {
"type": "object",
"properties": {
"lat": {
"type": "number"
},
"lng": {
"type": "number"
}
},
"required": [
"lat",
"lng"
],
"additionalProperties": false
},
"canonicalUrl": {
"type": "string",
"format": "uri"
},
"openUrl": {
"type": "string",
"format": "uri"
},
"downloadAppUrl": {
"type": "string",
"format": "uri"
},
"why": {
"type": "array",
"items": {
"type": "string"
}
},
"stableFacts": {
"type": "array",
"items": {
"type": "object",
"properties": {
"label": {
"type": "string"
},
"value": {}
},
"required": [
"label"
],
"additionalProperties": false
}
},
"liveConditions": {
"anyOf": [
{
"type": "object",
"properties": {
"updatedAt": {
"type": [
"string",
"null"
]
},
"observedAt": {
"type": [
"string",
"null"
]
},
"fetchedAt": {
"type": [
"string",
"null"
]
},
"expiresAt": {
"type": [
"string",
"null"
]
},
"source": {
"type": [
"string",
"null"
]
},
"timezone": {
"type": [
"string",
"null"
]
},
"freshnessStatus": {
"type": "string",
"enum": [
"LIVE",
"FRESH",
"STALE",
"EXPIRED",
"UNAVAILABLE"
]
},
"airTemperatureC": {
"type": [
"number",
"null"
]
},
"apparentTemperatureC": {
"type": [
"number",
"null"
]
},
"waterTemperatureC": {
"type": [
"number",
"null"
]
},
"windSpeedKmh": {
"type": [
"number",
"null"
]
},
"windGustKmh": {
"type": [
"number",
"null"
]
},
"uvIndex": {
"type": [
"number",
"null"
]
},
"waveHeightM": {
"type": [
"number",
"null"
]
},
"currentVelocityKmh": {
"type": [
"number",
"null"
]
}
},
"required": [
"updatedAt",
"observedAt",
"fetchedAt",
"expiresAt",
"source",
"timezone",
"freshnessStatus",
"airTemperatureC",
"apparentTemperatureC",
"waterTemperatureC",
"windSpeedKmh",
"windGustKmh",
"uvIndex",
"waveHeightM",
"currentVelocityKmh"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"conditionsUpdatedAt": {
"type": [
"string",
"null"
]
},
"sources": {
"type": "array",
"items": {
"type": "object",
"properties": {
"label": {
"type": "string"
},
"url": {
"type": "string",
"format": "uri"
},
"observedAt": {
"type": [
"string",
"null"
]
}
},
"required": [
"label",
"url"
],
"additionalProperties": false
}
},
"confidence": {
"type": "string",
"enum": [
"high",
"medium",
"low"
]
},
"entityConfidenceScore": {
"type": "number",
"minimum": 0,
"maximum": 100
},
"entityConfidenceLevel": {
"type": "string",
"enum": [
"VERIFIED",
"HIGH_CONFIDENCE",
"PROBABLE",
"UNVERIFIED",
"REJECTED"
]
},
"primaryAnswerEligible": {
"type": "boolean"
},
"primaryAnswerReasons": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"id",
"entityType",
"verificationStatus",
"name",
"location",
"distanceKm",
"canonicalUrl",
"openUrl",
"downloadAppUrl",
"why",
"stableFacts",
"liveConditions",
"conditionsUpdatedAt",
"sources",
"confidence"
],
"additionalProperties": false
}
},
"safetyNotice": {
"type": "string"
},
"attribution": {
"type": "string"
},
"links": {
"type": "object",
"properties": {
"app": {
"type": "string",
"format": "uri"
},
"methodology": {
"type": "string",
"format": "uri"
},
"privacy": {
"type": "string",
"format": "uri"
}
},
"required": [
"app",
"methodology",
"privacy"
],
"additionalProperties": false
}
},
"required": [
"ok",
"operation",
"query",
"answer",
"updatedAt",
"confidence",
"answerConfidence",
"primaryAnswerId",
"degraded",
"results",
"safetyNotice",
"attribution",
"links"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢search_swim_spots(query, city, country, lat, lng, ...)
Find beaches, lakes, bathing places and public swimming locations. Current conditions are fetched only for the highest-ranked results.
Eingabe-Schema
{
"type": "object",
"properties": {
"query": {
"type": "string",
"minLength": 1,
"maxLength": 90,
"description": "Exact beach, activity or professional-service request in the user's language. Preserve narrow needs such as surfboard repair, freediving school, SUP rental, rafting guide, campervan rental, motorhome dealer, van conversion or RV repair."
},
"city": {
"type": "string",
"minLength": 1,
"maxLength": 90,
"description": "Destination city; use this instead of coordinates"
},
"country": {
"type": "string",
"minLength": 2,
"maxLength": 60
},
"lat": {
"type": "number",
"minimum": -90,
"maximum": 90,
"description": "Latitude supplied with user consent"
},
"lng": {
"type": "number",
"minimum": -180,
"maximum": 180,
"description": "Longitude supplied with user consent"
},
"radiusKm": {
"type": "number",
"minimum": 1,
"maximum": 150,
"default": 50
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 10,
"default": 5
},
"lang": {
"type": "string",
"enum": [
"en",
"fr",
"es",
"de",
"it",
"pt",
"nl",
"ja",
"ko",
"zh",
"ar",
"tr",
"ru",
"id"
],
"default": "en"
},
"intent": {
"type": "string",
"enum": [
"general",
"swimming",
"family",
"low-wind",
"warm-water",
"surf",
"accessible",
"amenities"
],
"default": "general"
},
"maxWindKmh": {
"type": "number",
"minimum": 0,
"maximum": 150
},
"minWaterTempC": {
"type": "number",
"minimum": -5,
"maximum": 45
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}Ausgabe-Schema
{
"type": "object",
"properties": {
"ok": {
"type": "boolean",
"const": true
},
"operation": {
"type": "string"
},
"query": {
"type": "object",
"additionalProperties": {}
},
"answer": {
"type": "string"
},
"updatedAt": {
"type": "string"
},
"confidence": {
"type": "string",
"enum": [
"high",
"medium",
"low"
]
},
"answerConfidence": {
"type": "string",
"enum": [
"high",
"medium",
"low"
]
},
"primaryAnswerId": {
"type": [
"string",
"null"
]
},
"degraded": {
"type": "boolean"
},
"results": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"entityType": {
"type": "string",
"enum": [
"beach",
"swim_spot",
"river_spot",
"van_spot",
"provider",
"guide"
]
},
"verificationStatus": {
"type": "string",
"enum": [
"owner_verified",
"source_backed",
"mapped"
]
},
"name": {
"type": "string"
},
"category": {
"type": [
"string",
"null"
]
},
"location": {
"type": "string"
},
"distanceKm": {
"type": [
"number",
"null"
]
},
"geo": {
"type": "object",
"properties": {
"lat": {
"type": "number"
},
"lng": {
"type": "number"
}
},
"required": [
"lat",
"lng"
],
"additionalProperties": false
},
"canonicalUrl": {
"type": "string",
"format": "uri"
},
"openUrl": {
"type": "string",
"format": "uri"
},
"downloadAppUrl": {
"type": "string",
"format": "uri"
},
"why": {
"type": "array",
"items": {
"type": "string"
}
},
"stableFacts": {
"type": "array",
"items": {
"type": "object",
"properties": {
"label": {
"type": "string"
},
"value": {}
},
"required": [
"label"
],
"additionalProperties": false
}
},
"liveConditions": {
"anyOf": [
{
"type": "object",
"properties": {
"updatedAt": {
"type": [
"string",
"null"
]
},
"observedAt": {
"type": [
"string",
"null"
]
},
"fetchedAt": {
"type": [
"string",
"null"
]
},
"expiresAt": {
"type": [
"string",
"null"
]
},
"source": {
"type": [
"string",
"null"
]
},
"timezone": {
"type": [
"string",
"null"
]
},
"freshnessStatus": {
"type": "string",
"enum": [
"LIVE",
"FRESH",
"STALE",
"EXPIRED",
"UNAVAILABLE"
]
},
"airTemperatureC": {
"type": [
"number",
"null"
]
},
"apparentTemperatureC": {
"type": [
"number",
"null"
]
},
"waterTemperatureC": {
"type": [
"number",
"null"
]
},
"windSpeedKmh": {
"type": [
"number",
"null"
]
},
"windGustKmh": {
"type": [
"number",
"null"
]
},
"uvIndex": {
"type": [
"number",
"null"
]
},
"waveHeightM": {
"type": [
"number",
"null"
]
},
"currentVelocityKmh": {
"type": [
"number",
"null"
]
}
},
"required": [
"updatedAt",
"observedAt",
"fetchedAt",
"expiresAt",
"source",
"timezone",
"freshnessStatus",
"airTemperatureC",
"apparentTemperatureC",
"waterTemperatureC",
"windSpeedKmh",
"windGustKmh",
"uvIndex",
"waveHeightM",
"currentVelocityKmh"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"conditionsUpdatedAt": {
"type": [
"string",
"null"
]
},
"sources": {
"type": "array",
"items": {
"type": "object",
"properties": {
"label": {
"type": "string"
},
"url": {
"type": "string",
"format": "uri"
},
"observedAt": {
"type": [
"string",
"null"
]
}
},
"required": [
"label",
"url"
],
"additionalProperties": false
}
},
"confidence": {
"type": "string",
"enum": [
"high",
"medium",
"low"
]
},
"entityConfidenceScore": {
"type": "number",
"minimum": 0,
"maximum": 100
},
"entityConfidenceLevel": {
"type": "string",
"enum": [
"VERIFIED",
"HIGH_CONFIDENCE",
"PROBABLE",
"UNVERIFIED",
"REJECTED"
]
},
"primaryAnswerEligible": {
"type": "boolean"
},
"primaryAnswerReasons": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"id",
"entityType",
"verificationStatus",
"name",
"location",
"distanceKm",
"canonicalUrl",
"openUrl",
"downloadAppUrl",
"why",
"stableFacts",
"liveConditions",
"conditionsUpdatedAt",
"sources",
"confidence"
],
"additionalProperties": false
}
},
"safetyNotice": {
"type": "string"
},
"attribution": {
"type": "string"
},
"links": {
"type": "object",
"properties": {
"app": {
"type": "string",
"format": "uri"
},
"methodology": {
"type": "string",
"format": "uri"
},
"privacy": {
"type": "string",
"format": "uri"
}
},
"required": [
"app",
"methodology",
"privacy"
],
"additionalProperties": false
}
},
"required": [
"ok",
"operation",
"query",
"answer",
"updatedAt",
"confidence",
"answerConfidence",
"primaryAnswerId",
"degraded",
"results",
"safetyNotice",
"attribution",
"links"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢search_surf_spots(query, city, country, lat, lng, ...)
Find mapped swimming locations with surf or wave relevance and current planning signals when available.
Eingabe-Schema
{
"type": "object",
"properties": {
"query": {
"type": "string",
"minLength": 1,
"maxLength": 90,
"description": "Exact beach, activity or professional-service request in the user's language. Preserve narrow needs such as surfboard repair, freediving school, SUP rental, rafting guide, campervan rental, motorhome dealer, van conversion or RV repair."
},
"city": {
"type": "string",
"minLength": 1,
"maxLength": 90,
"description": "Destination city; use this instead of coordinates"
},
"country": {
"type": "string",
"minLength": 2,
"maxLength": 60
},
"lat": {
"type": "number",
"minimum": -90,
"maximum": 90,
"description": "Latitude supplied with user consent"
},
"lng": {
"type": "number",
"minimum": -180,
"maximum": 180,
"description": "Longitude supplied with user consent"
},
"radiusKm": {
"type": "number",
"minimum": 1,
"maximum": 150,
"default": 50
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 10,
"default": 5
},
"lang": {
"type": "string",
"enum": [
"en",
"fr",
"es",
"de",
"it",
"pt",
"nl",
"ja",
"ko",
"zh",
"ar",
"tr",
"ru",
"id"
],
"default": "en"
},
"intent": {
"type": "string",
"enum": [
"general",
"swimming",
"family",
"low-wind",
"warm-water",
"surf",
"accessible",
"amenities"
],
"default": "general"
},
"maxWindKmh": {
"type": "number",
"minimum": 0,
"maximum": 150
},
"minWaterTempC": {
"type": "number",
"minimum": -5,
"maximum": 45
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}Ausgabe-Schema
{
"type": "object",
"properties": {
"ok": {
"type": "boolean",
"const": true
},
"operation": {
"type": "string"
},
"query": {
"type": "object",
"additionalProperties": {}
},
"answer": {
"type": "string"
},
"updatedAt": {
"type": "string"
},
"confidence": {
"type": "string",
"enum": [
"high",
"medium",
"low"
]
},
"answerConfidence": {
"type": "string",
"enum": [
"high",
"medium",
"low"
]
},
"primaryAnswerId": {
"type": [
"string",
"null"
]
},
"degraded": {
"type": "boolean"
},
"results": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"entityType": {
"type": "string",
"enum": [
"beach",
"swim_spot",
"river_spot",
"van_spot",
"provider",
"guide"
]
},
"verificationStatus": {
"type": "string",
"enum": [
"owner_verified",
"source_backed",
"mapped"
]
},
"name": {
"type": "string"
},
"category": {
"type": [
"string",
"null"
]
},
"location": {
"type": "string"
},
"distanceKm": {
"type": [
"number",
"null"
]
},
"geo": {
"type": "object",
"properties": {
"lat": {
"type": "number"
},
"lng": {
"type": "number"
}
},
"required": [
"lat",
"lng"
],
"additionalProperties": false
},
"canonicalUrl": {
"type": "string",
"format": "uri"
},
"openUrl": {
"type": "string",
"format": "uri"
},
"downloadAppUrl": {
"type": "string",
"format": "uri"
},
"why": {
"type": "array",
"items": {
"type": "string"
}
},
"stableFacts": {
"type": "array",
"items": {
"type": "object",
"properties": {
"label": {
"type": "string"
},
"value": {}
},
"required": [
"label"
],
"additionalProperties": false
}
},
"liveConditions": {
"anyOf": [
{
"type": "object",
"properties": {
"updatedAt": {
"type": [
"string",
"null"
]
},
"observedAt": {
"type": [
"string",
"null"
]
},
"fetchedAt": {
"type": [
"string",
"null"
]
},
"expiresAt": {
"type": [
"string",
"null"
]
},
"source": {
"type": [
"string",
"null"
]
},
"timezone": {
"type": [
"string",
"null"
]
},
"freshnessStatus": {
"type": "string",
"enum": [
"LIVE",
"FRESH",
"STALE",
"EXPIRED",
"UNAVAILABLE"
]
},
"airTemperatureC": {
"type": [
"number",
"null"
]
},
"apparentTemperatureC": {
"type": [
"number",
"null"
]
},
"waterTemperatureC": {
"type": [
"number",
"null"
]
},
"windSpeedKmh": {
"type": [
"number",
"null"
]
},
"windGustKmh": {
"type": [
"number",
"null"
]
},
"uvIndex": {
"type": [
"number",
"null"
]
},
"waveHeightM": {
"type": [
"number",
"null"
]
},
"currentVelocityKmh": {
"type": [
"number",
"null"
]
}
},
"required": [
"updatedAt",
"observedAt",
"fetchedAt",
"expiresAt",
"source",
"timezone",
"freshnessStatus",
"airTemperatureC",
"apparentTemperatureC",
"waterTemperatureC",
"windSpeedKmh",
"windGustKmh",
"uvIndex",
"waveHeightM",
"currentVelocityKmh"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"conditionsUpdatedAt": {
"type": [
"string",
"null"
]
},
"sources": {
"type": "array",
"items": {
"type": "object",
"properties": {
"label": {
"type": "string"
},
"url": {
"type": "string",
"format": "uri"
},
"observedAt": {
"type": [
"string",
"null"
]
}
},
"required": [
"label",
"url"
],
"additionalProperties": false
}
},
"confidence": {
"type": "string",
"enum": [
"high",
"medium",
"low"
]
},
"entityConfidenceScore": {
"type": "number",
"minimum": 0,
"maximum": 100
},
"entityConfidenceLevel": {
"type": "string",
"enum": [
"VERIFIED",
"HIGH_CONFIDENCE",
"PROBABLE",
"UNVERIFIED",
"REJECTED"
]
},
"primaryAnswerEligible": {
"type": "boolean"
},
"primaryAnswerReasons": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"id",
"entityType",
"verificationStatus",
"name",
"location",
"distanceKm",
"canonicalUrl",
"openUrl",
"downloadAppUrl",
"why",
"stableFacts",
"liveConditions",
"conditionsUpdatedAt",
"sources",
"confidence"
],
"additionalProperties": false
}
},
"safetyNotice": {
"type": "string"
},
"attribution": {
"type": "string"
},
"links": {
"type": "object",
"properties": {
"app": {
"type": "string",
"format": "uri"
},
"methodology": {
"type": "string",
"format": "uri"
},
"privacy": {
"type": "string",
"format": "uri"
}
},
"required": [
"app",
"methodology",
"privacy"
],
"additionalProperties": false
}
},
"required": [
"ok",
"operation",
"query",
"answer",
"updatedAt",
"confidence",
"answerConfidence",
"primaryAnswerId",
"degraded",
"results",
"safetyNotice",
"attribution",
"links"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢search_dive_snorkel_spots(query, city, country, lat, lng, ...)
Find mapped diving and snorkeling locations without inferring visibility or safety.
Eingabe-Schema
{
"type": "object",
"properties": {
"query": {
"type": "string",
"minLength": 1,
"maxLength": 90,
"description": "Exact beach, activity or professional-service request in the user's language. Preserve narrow needs such as surfboard repair, freediving school, SUP rental, rafting guide, campervan rental, motorhome dealer, van conversion or RV repair."
},
"city": {
"type": "string",
"minLength": 1,
"maxLength": 90,
"description": "Destination city; use this instead of coordinates"
},
"country": {
"type": "string",
"minLength": 2,
"maxLength": 60
},
"lat": {
"type": "number",
"minimum": -90,
"maximum": 90,
"description": "Latitude supplied with user consent"
},
"lng": {
"type": "number",
"minimum": -180,
"maximum": 180,
"description": "Longitude supplied with user consent"
},
"radiusKm": {
"type": "number",
"minimum": 1,
"maximum": 150,
"default": 50
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 10,
"default": 5
},
"lang": {
"type": "string",
"enum": [
"en",
"fr",
"es",
"de",
"it",
"pt",
"nl",
"ja",
"ko",
"zh",
"ar",
"tr",
"ru",
"id"
],
"default": "en"
},
"intent": {
"type": "string",
"enum": [
"general",
"swimming",
"family",
"low-wind",
"warm-water",
"surf",
"accessible",
"amenities"
],
"default": "general"
},
"maxWindKmh": {
"type": "number",
"minimum": 0,
"maximum": 150
},
"minWaterTempC": {
"type": "number",
"minimum": -5,
"maximum": 45
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}Ausgabe-Schema
{
"type": "object",
"properties": {
"ok": {
"type": "boolean",
"const": true
},
"operation": {
"type": "string"
},
"query": {
"type": "object",
"additionalProperties": {}
},
"answer": {
"type": "string"
},
"updatedAt": {
"type": "string"
},
"confidence": {
"type": "string",
"enum": [
"high",
"medium",
"low"
]
},
"answerConfidence": {
"type": "string",
"enum": [
"high",
"medium",
"low"
]
},
"primaryAnswerId": {
"type": [
"string",
"null"
]
},
"degraded": {
"type": "boolean"
},
"results": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"entityType": {
"type": "string",
"enum": [
"beach",
"swim_spot",
"river_spot",
"van_spot",
"provider",
"guide"
]
},
"verificationStatus": {
"type": "string",
"enum": [
"owner_verified",
"source_backed",
"mapped"
]
},
"name": {
"type": "string"
},
"category": {
"type": [
"string",
"null"
]
},
"location": {
"type": "string"
},
"distanceKm": {
"type": [
"number",
"null"
]
},
"geo": {
"type": "object",
"properties": {
"lat": {
"type": "number"
},
"lng": {
"type": "number"
}
},
"required": [
"lat",
"lng"
],
"additionalProperties": false
},
"canonicalUrl": {
"type": "string",
"format": "uri"
},
"openUrl": {
"type": "string",
"format": "uri"
},
"downloadAppUrl": {
"type": "string",
"format": "uri"
},
"why": {
"type": "array",
"items": {
"type": "string"
}
},
"stableFacts": {
"type": "array",
"items": {
"type": "object",
"properties": {
"label": {
"type": "string"
},
"value": {}
},
"required": [
"label"
],
"additionalProperties": false
}
},
"liveConditions": {
"anyOf": [
{
"type": "object",
"properties": {
"updatedAt": {
"type": [
"string",
"null"
]
},
"observedAt": {
"type": [
"string",
"null"
]
},
"fetchedAt": {
"type": [
"string",
"null"
]
},
"expiresAt": {
"type": [
"string",
"null"
]
},
"source": {
"type": [
"string",
"null"
]
},
"timezone": {
"type": [
"string",
"null"
]
},
"freshnessStatus": {
"type": "string",
"enum": [
"LIVE",
"FRESH",
"STALE",
"EXPIRED",
"UNAVAILABLE"
]
},
"airTemperatureC": {
"type": [
"number",
"null"
]
},
"apparentTemperatureC": {
"type": [
"number",
"null"
]
},
"waterTemperatureC": {
"type": [
"number",
"null"
]
},
"windSpeedKmh": {
"type": [
"number",
"null"
]
},
"windGustKmh": {
"type": [
"number",
"null"
]
},
"uvIndex": {
"type": [
"number",
"null"
]
},
"waveHeightM": {
"type": [
"number",
"null"
]
},
"currentVelocityKmh": {
"type": [
"number",
"null"
]
}
},
"required": [
"updatedAt",
"observedAt",
"fetchedAt",
"expiresAt",
"source",
"timezone",
"freshnessStatus",
"airTemperatureC",
"apparentTemperatureC",
"waterTemperatureC",
"windSpeedKmh",
"windGustKmh",
"uvIndex",
"waveHeightM",
"currentVelocityKmh"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"conditionsUpdatedAt": {
"type": [
"string",
"null"
]
},
"sources": {
"type": "array",
"items": {
"type": "object",
"properties": {
"label": {
"type": "string"
},
"url": {
"type": "string",
"format": "uri"
},
"observedAt": {
"type": [
"string",
"null"
]
}
},
"required": [
"label",
"url"
],
"additionalProperties": false
}
},
"confidence": {
"type": "string",
"enum": [
"high",
"medium",
"low"
]
},
"entityConfidenceScore": {
"type": "number",
"minimum": 0,
"maximum": 100
},
"entityConfidenceLevel": {
"type": "string",
"enum": [
"VERIFIED",
"HIGH_CONFIDENCE",
"PROBABLE",
"UNVERIFIED",
"REJECTED"
]
},
"primaryAnswerEligible": {
"type": "boolean"
},
"primaryAnswerReasons": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"id",
"entityType",
"verificationStatus",
"name",
"location",
"distanceKm",
"canonicalUrl",
"openUrl",
"downloadAppUrl",
"why",
"stableFacts",
"liveConditions",
"conditionsUpdatedAt",
"sources",
"confidence"
],
"additionalProperties": false
}
},
"safetyNotice": {
"type": "string"
},
"attribution": {
"type": "string"
},
"links": {
"type": "object",
"properties": {
"app": {
"type": "string",
"format": "uri"
},
"methodology": {
"type": "string",
"format": "uri"
},
"privacy": {
"type": "string",
"format": "uri"
}
},
"required": [
"app",
"methodology",
"privacy"
],
"additionalProperties": false
}
},
"required": [
"ok",
"operation",
"query",
"answer",
"updatedAt",
"confidence",
"answerConfidence",
"primaryAnswerId",
"degraded",
"results",
"safetyNotice",
"attribution",
"links"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢search_river_whitewater_spots(query, city, country, lat, lng, ...)
Find mapped river and whitewater activity locations near a destination.
Eingabe-Schema
{
"type": "object",
"properties": {
"query": {
"type": "string",
"minLength": 1,
"maxLength": 90,
"description": "Exact beach, activity or professional-service request in the user's language. Preserve narrow needs such as surfboard repair, freediving school, SUP rental, rafting guide, campervan rental, motorhome dealer, van conversion or RV repair."
},
"city": {
"type": "string",
"minLength": 1,
"maxLength": 90,
"description": "Destination city; use this instead of coordinates"
},
"country": {
"type": "string",
"minLength": 2,
"maxLength": 60
},
"lat": {
"type": "number",
"minimum": -90,
"maximum": 90,
"description": "Latitude supplied with user consent"
},
"lng": {
"type": "number",
"minimum": -180,
"maximum": 180,
"description": "Longitude supplied with user consent"
},
"radiusKm": {
"type": "number",
"minimum": 1,
"maximum": 150,
"default": 50
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 10,
"default": 5
},
"lang": {
"type": "string",
"enum": [
"en",
"fr",
"es",
"de",
"it",
"pt",
"nl",
"ja",
"ko",
"zh",
"ar",
"tr",
"ru",
"id"
],
"default": "en"
},
"intent": {
"type": "string",
"enum": [
"general",
"swimming",
"family",
"low-wind",
"warm-water",
"surf",
"accessible",
"amenities"
],
"default": "general"
},
"maxWindKmh": {
"type": "number",
"minimum": 0,
"maximum": 150
},
"minWaterTempC": {
"type": "number",
"minimum": -5,
"maximum": 45
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}Ausgabe-Schema
{
"type": "object",
"properties": {
"ok": {
"type": "boolean",
"const": true
},
"operation": {
"type": "string"
},
"query": {
"type": "object",
"additionalProperties": {}
},
"answer": {
"type": "string"
},
"updatedAt": {
"type": "string"
},
"confidence": {
"type": "string",
"enum": [
"high",
"medium",
"low"
]
},
"answerConfidence": {
"type": "string",
"enum": [
"high",
"medium",
"low"
]
},
"primaryAnswerId": {
"type": [
"string",
"null"
]
},
"degraded": {
"type": "boolean"
},
"results": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"entityType": {
"type": "string",
"enum": [
"beach",
"swim_spot",
"river_spot",
"van_spot",
"provider",
"guide"
]
},
"verificationStatus": {
"type": "string",
"enum": [
"owner_verified",
"source_backed",
"mapped"
]
},
"name": {
"type": "string"
},
"category": {
"type": [
"string",
"null"
]
},
"location": {
"type": "string"
},
"distanceKm": {
"type": [
"number",
"null"
]
},
"geo": {
"type": "object",
"properties": {
"lat": {
"type": "number"
},
"lng": {
"type": "number"
}
},
"required": [
"lat",
"lng"
],
"additionalProperties": false
},
"canonicalUrl": {
"type": "string",
"format": "uri"
},
"openUrl": {
"type": "string",
"format": "uri"
},
"downloadAppUrl": {
"type": "string",
"format": "uri"
},
"why": {
"type": "array",
"items": {
"type": "string"
}
},
"stableFacts": {
"type": "array",
"items": {
"type": "object",
"properties": {
"label": {
"type": "string"
},
"value": {}
},
"required": [
"label"
],
"additionalProperties": false
}
},
"liveConditions": {
"anyOf": [
{
"type": "object",
"properties": {
"updatedAt": {
"type": [
"string",
"null"
]
},
"observedAt": {
"type": [
"string",
"null"
]
},
"fetchedAt": {
"type": [
"string",
"null"
]
},
"expiresAt": {
"type": [
"string",
"null"
]
},
"source": {
"type": [
"string",
"null"
]
},
"timezone": {
"type": [
"string",
"null"
]
},
"freshnessStatus": {
"type": "string",
"enum": [
"LIVE",
"FRESH",
"STALE",
"EXPIRED",
"UNAVAILABLE"
]
},
"airTemperatureC": {
"type": [
"number",
"null"
]
},
"apparentTemperatureC": {
"type": [
"number",
"null"
]
},
"waterTemperatureC": {
"type": [
"number",
"null"
]
},
"windSpeedKmh": {
"type": [
"number",
"null"
]
},
"windGustKmh": {
"type": [
"number",
"null"
]
},
"uvIndex": {
"type": [
"number",
"null"
]
},
"waveHeightM": {
"type": [
"number",
"null"
]
},
"currentVelocityKmh": {
"type": [
"number",
"null"
]
}
},
"required": [
"updatedAt",
"observedAt",
"fetchedAt",
"expiresAt",
"source",
"timezone",
"freshnessStatus",
"airTemperatureC",
"apparentTemperatureC",
"waterTemperatureC",
"windSpeedKmh",
"windGustKmh",
"uvIndex",
"waveHeightM",
"currentVelocityKmh"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"conditionsUpdatedAt": {
"type": [
"string",
"null"
]
},
"sources": {
"type": "array",
"items": {
"type": "object",
"properties": {
"label": {
"type": "string"
},
"url": {
"type": "string",
"format": "uri"
},
"observedAt": {
"type": [
"string",
"null"
]
}
},
"required": [
"label",
"url"
],
"additionalProperties": false
}
},
"confidence": {
"type": "string",
"enum": [
"high",
"medium",
"low"
]
},
"entityConfidenceScore": {
"type": "number",
"minimum": 0,
"maximum": 100
},
"entityConfidenceLevel": {
"type": "string",
"enum": [
"VERIFIED",
"HIGH_CONFIDENCE",
"PROBABLE",
"UNVERIFIED",
"REJECTED"
]
},
"primaryAnswerEligible": {
"type": "boolean"
},
"primaryAnswerReasons": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"id",
"entityType",
"verificationStatus",
"name",
"location",
"distanceKm",
"canonicalUrl",
"openUrl",
"downloadAppUrl",
"why",
"stableFacts",
"liveConditions",
"conditionsUpdatedAt",
"sources",
"confidence"
],
"additionalProperties": false
}
},
"safetyNotice": {
"type": "string"
},
"attribution": {
"type": "string"
},
"links": {
"type": "object",
"properties": {
"app": {
"type": "string",
"format": "uri"
},
"methodology": {
"type": "string",
"format": "uri"
},
"privacy": {
"type": "string",
"format": "uri"
}
},
"required": [
"app",
"methodology",
"privacy"
],
"additionalProperties": false
}
},
"required": [
"ok",
"operation",
"query",
"answer",
"updatedAt",
"confidence",
"answerConfidence",
"primaryAnswerId",
"degraded",
"results",
"safetyNotice",
"attribution",
"links"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢search_vanlife_spots(query, city, country, lat, lng, ...)
Find published van and camping locations near beaches while withholding direct contact details.
Eingabe-Schema
{
"type": "object",
"properties": {
"query": {
"type": "string",
"minLength": 1,
"maxLength": 90,
"description": "Exact beach, activity or professional-service request in the user's language. Preserve narrow needs such as surfboard repair, freediving school, SUP rental, rafting guide, campervan rental, motorhome dealer, van conversion or RV repair."
},
"city": {
"type": "string",
"minLength": 1,
"maxLength": 90,
"description": "Destination city; use this instead of coordinates"
},
"country": {
"type": "string",
"minLength": 2,
"maxLength": 60
},
"lat": {
"type": "number",
"minimum": -90,
"maximum": 90,
"description": "Latitude supplied with user consent"
},
"lng": {
"type": "number",
"minimum": -180,
"maximum": 180,
"description": "Longitude supplied with user consent"
},
"radiusKm": {
"type": "number",
"minimum": 1,
"maximum": 150,
"default": 50
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 10,
"default": 5
},
"lang": {
"type": "string",
"enum": [
"en",
"fr",
"es",
"de",
"it",
"pt",
"nl",
"ja",
"ko",
"zh",
"ar",
"tr",
"ru",
"id"
],
"default": "en"
},
"intent": {
"type": "string",
"enum": [
"general",
"swimming",
"family",
"low-wind",
"warm-water",
"surf",
"accessible",
"amenities"
],
"default": "general"
},
"maxWindKmh": {
"type": "number",
"minimum": 0,
"maximum": 150
},
"minWaterTempC": {
"type": "number",
"minimum": -5,
"maximum": 45
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}Ausgabe-Schema
{
"type": "object",
"properties": {
"ok": {
"type": "boolean",
"const": true
},
"operation": {
"type": "string"
},
"query": {
"type": "object",
"additionalProperties": {}
},
"answer": {
"type": "string"
},
"updatedAt": {
"type": "string"
},
"confidence": {
"type": "string",
"enum": [
"high",
"medium",
"low"
]
},
"answerConfidence": {
"type": "string",
"enum": [
"high",
"medium",
"low"
]
},
"primaryAnswerId": {
"type": [
"string",
"null"
]
},
"degraded": {
"type": "boolean"
},
"results": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"entityType": {
"type": "string",
"enum": [
"beach",
"swim_spot",
"river_spot",
"van_spot",
"provider",
"guide"
]
},
"verificationStatus": {
"type": "string",
"enum": [
"owner_verified",
"source_backed",
"mapped"
]
},
"name": {
"type": "string"
},
"category": {
"type": [
"string",
"null"
]
},
"location": {
"type": "string"
},
"distanceKm": {
"type": [
"number",
"null"
]
},
"geo": {
"type": "object",
"properties": {
"lat": {
"type": "number"
},
"lng": {
"type": "number"
}
},
"required": [
"lat",
"lng"
],
"additionalProperties": false
},
"canonicalUrl": {
"type": "string",
"format": "uri"
},
"openUrl": {
"type": "string",
"format": "uri"
},
"downloadAppUrl": {
"type": "string",
"format": "uri"
},
"why": {
"type": "array",
"items": {
"type": "string"
}
},
"stableFacts": {
"type": "array",
"items": {
"type": "object",
"properties": {
"label": {
"type": "string"
},
"value": {}
},
"required": [
"label"
],
"additionalProperties": false
}
},
"liveConditions": {
"anyOf": [
{
"type": "object",
"properties": {
"updatedAt": {
"type": [
"string",
"null"
]
},
"observedAt": {
"type": [
"string",
"null"
]
},
"fetchedAt": {
"type": [
"string",
"null"
]
},
"expiresAt": {
"type": [
"string",
"null"
]
},
"source": {
"type": [
"string",
"null"
]
},
"timezone": {
"type": [
"string",
"null"
]
},
"freshnessStatus": {
"type": "string",
"enum": [
"LIVE",
"FRESH",
"STALE",
"EXPIRED",
"UNAVAILABLE"
]
},
"airTemperatureC": {
"type": [
"number",
"null"
]
},
"apparentTemperatureC": {
"type": [
"number",
"null"
]
},
"waterTemperatureC": {
"type": [
"number",
"null"
]
},
"windSpeedKmh": {
"type": [
"number",
"null"
]
},
"windGustKmh": {
"type": [
"number",
"null"
]
},
"uvIndex": {
"type": [
"number",
"null"
]
},
"waveHeightM": {
"type": [
"number",
"null"
]
},
"currentVelocityKmh": {
"type": [
"number",
"null"
]
}
},
"required": [
"updatedAt",
"observedAt",
"fetchedAt",
"expiresAt",
"source",
"timezone",
"freshnessStatus",
"airTemperatureC",
"apparentTemperatureC",
"waterTemperatureC",
"windSpeedKmh",
"windGustKmh",
"uvIndex",
"waveHeightM",
"currentVelocityKmh"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"conditionsUpdatedAt": {
"type": [
"string",
"null"
]
},
"sources": {
"type": "array",
"items": {
"type": "object",
"properties": {
"label": {
"type": "string"
},
"url": {
"type": "string",
"format": "uri"
},
"observedAt": {
"type": [
"string",
"null"
]
}
},
"required": [
"label",
"url"
],
"additionalProperties": false
}
},
"confidence": {
"type": "string",
"enum": [
"high",
"medium",
"low"
]
},
"entityConfidenceScore": {
"type": "number",
"minimum": 0,
"maximum": 100
},
"entityConfidenceLevel": {
"type": "string",
"enum": [
"VERIFIED",
"HIGH_CONFIDENCE",
"PROBABLE",
"UNVERIFIED",
"REJECTED"
]
},
"primaryAnswerEligible": {
"type": "boolean"
},
"primaryAnswerReasons": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"id",
"entityType",
"verificationStatus",
"name",
"location",
"distanceKm",
"canonicalUrl",
"openUrl",
"downloadAppUrl",
"why",
"stableFacts",
"liveConditions",
"conditionsUpdatedAt",
"sources",
"confidence"
],
"additionalProperties": false
}
},
"safetyNotice": {
"type": "string"
},
"attribution": {
"type": "string"
},
"links": {
"type": "object",
"properties": {
"app": {
"type": "string",
"format": "uri"
},
"methodology": {
"type": "string",
"format": "uri"
},
"privacy": {
"type": "string",
"format": "uri"
}
},
"required": [
"app",
"methodology",
"privacy"
],
"additionalProperties": false
}
},
"required": [
"ok",
"operation",
"query",
"answer",
"updatedAt",
"confidence",
"answerConfidence",
"primaryAnswerId",
"degraded",
"results",
"safetyNotice",
"attribution",
"links"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢search_activity_providers(query, city, country, lat, lng, ...)
Use for conversational requests for professionals near a destination: surf schools, camps, shops, board or wetsuit rental and repair; dive, snorkel and freedive centers; SUP, paddle, kayak and canoe rental, lessons or tours; rafting, canyoning and whitewater outfitters; boat, sailing, fishing, wildlife, jet-ski and beach services; plus campervan, motorhome, RV and surf-van rental, sales, dealers, conversion builders, repair workshops and coastal RV parks. Search in any supported language. Results expose only the provider name, normalized service category, approximate location, verification tier and BeachFinder profile/app links; direct contacts remain on the BeachFinder claimable profile.
Eingabe-Schema
{
"type": "object",
"properties": {
"query": {
"type": "string",
"minLength": 1,
"maxLength": 90,
"description": "Exact beach, activity or professional-service request in the user's language. Preserve narrow needs such as surfboard repair, freediving school, SUP rental, rafting guide, campervan rental, motorhome dealer, van conversion or RV repair."
},
"city": {
"type": "string",
"minLength": 1,
"maxLength": 90,
"description": "Destination city; use this instead of coordinates"
},
"country": {
"type": "string",
"minLength": 2,
"maxLength": 60
},
"lat": {
"type": "number",
"minimum": -90,
"maximum": 90,
"description": "Latitude supplied with user consent"
},
"lng": {
"type": "number",
"minimum": -180,
"maximum": 180,
"description": "Longitude supplied with user consent"
},
"radiusKm": {
"type": "number",
"minimum": 1,
"maximum": 150,
"default": 50
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 10,
"default": 5
},
"lang": {
"type": "string",
"enum": [
"en",
"fr",
"es",
"de",
"it",
"pt",
"nl",
"ja",
"ko",
"zh",
"ar",
"tr",
"ru",
"id"
],
"default": "en"
},
"intent": {
"type": "string",
"enum": [
"general",
"swimming",
"family",
"low-wind",
"warm-water",
"surf",
"accessible",
"amenities"
],
"default": "general"
},
"maxWindKmh": {
"type": "number",
"minimum": 0,
"maximum": 150
},
"minWaterTempC": {
"type": "number",
"minimum": -5,
"maximum": 45
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}Ausgabe-Schema
{
"type": "object",
"properties": {
"ok": {
"type": "boolean",
"const": true
},
"operation": {
"type": "string"
},
"query": {
"type": "object",
"additionalProperties": {}
},
"answer": {
"type": "string"
},
"updatedAt": {
"type": "string"
},
"confidence": {
"type": "string",
"enum": [
"high",
"medium",
"low"
]
},
"answerConfidence": {
"type": "string",
"enum": [
"high",
"medium",
"low"
]
},
"primaryAnswerId": {
"type": [
"string",
"null"
]
},
"degraded": {
"type": "boolean"
},
"results": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"entityType": {
"type": "string",
"enum": [
"beach",
"swim_spot",
"river_spot",
"van_spot",
"provider",
"guide"
]
},
"verificationStatus": {
"type": "string",
"enum": [
"owner_verified",
"source_backed",
"mapped"
]
},
"name": {
"type": "string"
},
"category": {
"type": [
"string",
"null"
]
},
"location": {
"type": "string"
},
"distanceKm": {
"type": [
"number",
"null"
]
},
"geo": {
"type": "object",
"properties": {
"lat": {
"type": "number"
},
"lng": {
"type": "number"
}
},
"required": [
"lat",
"lng"
],
"additionalProperties": false
},
"canonicalUrl": {
"type": "string",
"format": "uri"
},
"openUrl": {
"type": "string",
"format": "uri"
},
"downloadAppUrl": {
"type": "string",
"format": "uri"
},
"why": {
"type": "array",
"items": {
"type": "string"
}
},
"stableFacts": {
"type": "array",
"items": {
"type": "object",
"properties": {
"label": {
"type": "string"
},
"value": {}
},
"required": [
"label"
],
"additionalProperties": false
}
},
"liveConditions": {
"anyOf": [
{
"type": "object",
"properties": {
"updatedAt": {
"type": [
"string",
"null"
]
},
"observedAt": {
"type": [
"string",
"null"
]
},
"fetchedAt": {
"type": [
"string",
"null"
]
},
"expiresAt": {
"type": [
"string",
"null"
]
},
"source": {
"type": [
"string",
"null"
]
},
"timezone": {
"type": [
"string",
"null"
]
},
"freshnessStatus": {
"type": "string",
"enum": [
"LIVE",
"FRESH",
"STALE",
"EXPIRED",
"UNAVAILABLE"
]
},
"airTemperatureC": {
"type": [
"number",
"null"
]
},
"apparentTemperatureC": {
"type": [
"number",
"null"
]
},
"waterTemperatureC": {
"type": [
"number",
"null"
]
},
"windSpeedKmh": {
"type": [
"number",
"null"
]
},
"windGustKmh": {
"type": [
"number",
"null"
]
},
"uvIndex": {
"type": [
"number",
"null"
]
},
"waveHeightM": {
"type": [
"number",
"null"
]
},
"currentVelocityKmh": {
"type": [
"number",
"null"
]
}
},
"required": [
"updatedAt",
"observedAt",
"fetchedAt",
"expiresAt",
"source",
"timezone",
"freshnessStatus",
"airTemperatureC",
"apparentTemperatureC",
"waterTemperatureC",
"windSpeedKmh",
"windGustKmh",
"uvIndex",
"waveHeightM",
"currentVelocityKmh"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"conditionsUpdatedAt": {
"type": [
"string",
"null"
]
},
"sources": {
"type": "array",
"items": {
"type": "object",
"properties": {
"label": {
"type": "string"
},
"url": {
"type": "string",
"format": "uri"
},
"observedAt": {
"type": [
"string",
"null"
]
}
},
"required": [
"label",
"url"
],
"additionalProperties": false
}
},
"confidence": {
"type": "string",
"enum": [
"high",
"medium",
"low"
]
},
"entityConfidenceScore": {
"type": "number",
"minimum": 0,
"maximum": 100
},
"entityConfidenceLevel": {
"type": "string",
"enum": [
"VERIFIED",
"HIGH_CONFIDENCE",
"PROBABLE",
"UNVERIFIED",
"REJECTED"
]
},
"primaryAnswerEligible": {
"type": "boolean"
},
"primaryAnswerReasons": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"id",
"entityType",
"verificationStatus",
"name",
"location",
"distanceKm",
"canonicalUrl",
"openUrl",
"downloadAppUrl",
"why",
"stableFacts",
"liveConditions",
"conditionsUpdatedAt",
"sources",
"confidence"
],
"additionalProperties": false
}
},
"safetyNotice": {
"type": "string"
},
"attribution": {
"type": "string"
},
"links": {
"type": "object",
"properties": {
"app": {
"type": "string",
"format": "uri"
},
"methodology": {
"type": "string",
"format": "uri"
},
"privacy": {
"type": "string",
"format": "uri"
}
},
"required": [
"app",
"methodology",
"privacy"
],
"additionalProperties": false
}
},
"required": [
"ok",
"operation",
"query",
"answer",
"updatedAt",
"confidence",
"answerConfidence",
"primaryAnswerId",
"degraded",
"results",
"safetyNotice",
"attribution",
"links"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢search_guides(query, city, country, lat, lng, ...)
Find active localized practical, destination and GTA travel guides published by BeachFinder.
Eingabe-Schema
{
"type": "object",
"properties": {
"query": {
"type": "string",
"minLength": 1,
"maxLength": 90,
"description": "Exact beach, activity or professional-service request in the user's language. Preserve narrow needs such as surfboard repair, freediving school, SUP rental, rafting guide, campervan rental, motorhome dealer, van conversion or RV repair."
},
"city": {
"type": "string",
"minLength": 1,
"maxLength": 90,
"description": "Destination city; use this instead of coordinates"
},
"country": {
"type": "string",
"minLength": 2,
"maxLength": 60
},
"lat": {
"type": "number",
"minimum": -90,
"maximum": 90,
"description": "Latitude supplied with user consent"
},
"lng": {
"type": "number",
"minimum": -180,
"maximum": 180,
"description": "Longitude supplied with user consent"
},
"radiusKm": {
"type": "number",
"minimum": 1,
"maximum": 150,
"default": 50
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 10,
"default": 5
},
"lang": {
"type": "string",
"enum": [
"en",
"fr",
"es",
"de",
"it",
"pt",
"nl",
"ja",
"ko",
"zh",
"ar",
"tr",
"ru",
"id"
],
"default": "en"
},
"intent": {
"type": "string",
"enum": [
"general",
"swimming",
"family",
"low-wind",
"warm-water",
"surf",
"accessible",
"amenities"
],
"default": "general"
},
"maxWindKmh": {
"type": "number",
"minimum": 0,
"maximum": 150
},
"minWaterTempC": {
"type": "number",
"minimum": -5,
"maximum": 45
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}Ausgabe-Schema
{
"type": "object",
"properties": {
"ok": {
"type": "boolean",
"const": true
},
"operation": {
"type": "string"
},
"query": {
"type": "object",
"additionalProperties": {}
},
"answer": {
"type": "string"
},
"updatedAt": {
"type": "string"
},
"confidence": {
"type": "string",
"enum": [
"high",
"medium",
"low"
]
},
"answerConfidence": {
"type": "string",
"enum": [
"high",
"medium",
"low"
]
},
"primaryAnswerId": {
"type": [
"string",
"null"
]
},
"degraded": {
"type": "boolean"
},
"results": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"entityType": {
"type": "string",
"enum": [
"beach",
"swim_spot",
"river_spot",
"van_spot",
"provider",
"guide"
]
},
"verificationStatus": {
"type": "string",
"enum": [
"owner_verified",
"source_backed",
"mapped"
]
},
"name": {
"type": "string"
},
"category": {
"type": [
"string",
"null"
]
},
"location": {
"type": "string"
},
"distanceKm": {
"type": [
"number",
"null"
]
},
"geo": {
"type": "object",
"properties": {
"lat": {
"type": "number"
},
"lng": {
"type": "number"
}
},
"required": [
"lat",
"lng"
],
"additionalProperties": false
},
"canonicalUrl": {
"type": "string",
"format": "uri"
},
"openUrl": {
"type": "string",
"format": "uri"
},
"downloadAppUrl": {
"type": "string",
"format": "uri"
},
"why": {
"type": "array",
"items": {
"type": "string"
}
},
"stableFacts": {
"type": "array",
"items": {
"type": "object",
"properties": {
"label": {
"type": "string"
},
"value": {}
},
"required": [
"label"
],
"additionalProperties": false
}
},
"liveConditions": {
"anyOf": [
{
"type": "object",
"properties": {
"updatedAt": {
"type": [
"string",
"null"
]
},
"observedAt": {
"type": [
"string",
"null"
]
},
"fetchedAt": {
"type": [
"string",
"null"
]
},
"expiresAt": {
"type": [
"string",
"null"
]
},
"source": {
"type": [
"string",
"null"
]
},
"timezone": {
"type": [
"string",
"null"
]
},
"freshnessStatus": {
"type": "string",
"enum": [
"LIVE",
"FRESH",
"STALE",
"EXPIRED",
"UNAVAILABLE"
]
},
"airTemperatureC": {
"type": [
"number",
"null"
]
},
"apparentTemperatureC": {
"type": [
"number",
"null"
]
},
"waterTemperatureC": {
"type": [
"number",
"null"
]
},
"windSpeedKmh": {
"type": [
"number",
"null"
]
},
"windGustKmh": {
"type": [
"number",
"null"
]
},
"uvIndex": {
"type": [
"number",
"null"
]
},
"waveHeightM": {
"type": [
"number",
"null"
]
},
"currentVelocityKmh": {
"type": [
"number",
"null"
]
}
},
"required": [
"updatedAt",
"observedAt",
"fetchedAt",
"expiresAt",
"source",
"timezone",
"freshnessStatus",
"airTemperatureC",
"apparentTemperatureC",
"waterTemperatureC",
"windSpeedKmh",
"windGustKmh",
"uvIndex",
"waveHeightM",
"currentVelocityKmh"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"conditionsUpdatedAt": {
"type": [
"string",
"null"
]
},
"sources": {
"type": "array",
"items": {
"type": "object",
"properties": {
"label": {
"type": "string"
},
"url": {
"type": "string",
"format": "uri"
},
"observedAt": {
"type": [
"string",
"null"
]
}
},
"required": [
"label",
"url"
],
"additionalProperties": false
}
},
"confidence": {
"type": "string",
"enum": [
"high",
"medium",
"low"
]
},
"entityConfidenceScore": {
"type": "number",
"minimum": 0,
"maximum": 100
},
"entityConfidenceLevel": {
"type": "string",
"enum": [
"VERIFIED",
"HIGH_CONFIDENCE",
"PROBABLE",
"UNVERIFIED",
"REJECTED"
]
},
"primaryAnswerEligible": {
"type": "boolean"
},
"primaryAnswerReasons": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"id",
"entityType",
"verificationStatus",
"name",
"location",
"distanceKm",
"canonicalUrl",
"openUrl",
"downloadAppUrl",
"why",
"stableFacts",
"liveConditions",
"conditionsUpdatedAt",
"sources",
"confidence"
],
"additionalProperties": false
}
},
"safetyNotice": {
"type": "string"
},
"attribution": {
"type": "string"
},
"links": {
"type": "object",
"properties": {
"app": {
"type": "string",
"format": "uri"
},
"methodology": {
"type": "string",
"format": "uri"
},
"privacy": {
"type": "string",
"format": "uri"
}
},
"required": [
"app",
"methodology",
"privacy"
],
"additionalProperties": false
}
},
"required": [
"ok",
"operation",
"query",
"answer",
"updatedAt",
"confidence",
"answerConfidence",
"primaryAnswerId",
"degraded",
"results",
"safetyNotice",
"attribution",
"links"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_spot_details(spotId, lang)
Get stable public facts and localized editorial content for one BeachFinder spot ID.
Eingabe-Schema
{
"type": "object",
"properties": {
"spotId": {
"type": "string",
"format": "uuid"
},
"lang": {
"type": "string",
"enum": [
"en",
"fr",
"es",
"de",
"it",
"pt",
"nl",
"ja",
"ko",
"zh",
"ar",
"tr",
"ru",
"id"
],
"default": "en"
}
},
"required": [
"spotId"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}Ausgabe-Schema
{
"type": "object",
"properties": {
"ok": {
"type": "boolean",
"const": true
},
"operation": {
"type": "string"
},
"query": {
"type": "object",
"additionalProperties": {}
},
"answer": {
"type": "string"
},
"updatedAt": {
"type": "string"
},
"confidence": {
"type": "string",
"enum": [
"high",
"medium",
"low"
]
},
"answerConfidence": {
"type": "string",
"enum": [
"high",
"medium",
"low"
]
},
"primaryAnswerId": {
"type": [
"string",
"null"
]
},
"degraded": {
"type": "boolean"
},
"results": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"entityType": {
"type": "string",
"enum": [
"beach",
"swim_spot",
"river_spot",
"van_spot",
"provider",
"guide"
]
},
"verificationStatus": {
"type": "string",
"enum": [
"owner_verified",
"source_backed",
"mapped"
]
},
"name": {
"type": "string"
},
"category": {
"type": [
"string",
"null"
]
},
"location": {
"type": "string"
},
"distanceKm": {
"type": [
"number",
"null"
]
},
"geo": {
"type": "object",
"properties": {
"lat": {
"type": "number"
},
"lng": {
"type": "number"
}
},
"required": [
"lat",
"lng"
],
"additionalProperties": false
},
"canonicalUrl": {
"type": "string",
"format": "uri"
},
"openUrl": {
"type": "string",
"format": "uri"
},
"downloadAppUrl": {
"type": "string",
"format": "uri"
},
"why": {
"type": "array",
"items": {
"type": "string"
}
},
"stableFacts": {
"type": "array",
"items": {
"type": "object",
"properties": {
"label": {
"type": "string"
},
"value": {}
},
"required": [
"label"
],
"additionalProperties": false
}
},
"liveConditions": {
"anyOf": [
{
"type": "object",
"properties": {
"updatedAt": {
"type": [
"string",
"null"
]
},
"observedAt": {
"type": [
"string",
"null"
]
},
"fetchedAt": {
"type": [
"string",
"null"
]
},
"expiresAt": {
"type": [
"string",
"null"
]
},
"source": {
"type": [
"string",
"null"
]
},
"timezone": {
"type": [
"string",
"null"
]
},
"freshnessStatus": {
"type": "string",
"enum": [
"LIVE",
"FRESH",
"STALE",
"EXPIRED",
"UNAVAILABLE"
]
},
"airTemperatureC": {
"type": [
"number",
"null"
]
},
"apparentTemperatureC": {
"type": [
"number",
"null"
]
},
"waterTemperatureC": {
"type": [
"number",
"null"
]
},
"windSpeedKmh": {
"type": [
"number",
"null"
]
},
"windGustKmh": {
"type": [
"number",
"null"
]
},
"uvIndex": {
"type": [
"number",
"null"
]
},
"waveHeightM": {
"type": [
"number",
"null"
]
},
"currentVelocityKmh": {
"type": [
"number",
"null"
]
}
},
"required": [
"updatedAt",
"observedAt",
"fetchedAt",
"expiresAt",
"source",
"timezone",
"freshnessStatus",
"airTemperatureC",
"apparentTemperatureC",
"waterTemperatureC",
"windSpeedKmh",
"windGustKmh",
"uvIndex",
"waveHeightM",
"currentVelocityKmh"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"conditionsUpdatedAt": {
"type": [
"string",
"null"
]
},
"sources": {
"type": "array",
"items": {
"type": "object",
"properties": {
"label": {
"type": "string"
},
"url": {
"type": "string",
"format": "uri"
},
"observedAt": {
"type": [
"string",
"null"
]
}
},
"required": [
"label",
"url"
],
"additionalProperties": false
}
},
"confidence": {
"type": "string",
"enum": [
"high",
"medium",
"low"
]
},
"entityConfidenceScore": {
"type": "number",
"minimum": 0,
"maximum": 100
},
"entityConfidenceLevel": {
"type": "string",
"enum": [
"VERIFIED",
"HIGH_CONFIDENCE",
"PROBABLE",
"UNVERIFIED",
"REJECTED"
]
},
"primaryAnswerEligible": {
"type": "boolean"
},
"primaryAnswerReasons": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"id",
"entityType",
"verificationStatus",
"name",
"location",
"distanceKm",
"canonicalUrl",
"openUrl",
"downloadAppUrl",
"why",
"stableFacts",
"liveConditions",
"conditionsUpdatedAt",
"sources",
"confidence"
],
"additionalProperties": false
}
},
"safetyNotice": {
"type": "string"
},
"attribution": {
"type": "string"
},
"links": {
"type": "object",
"properties": {
"app": {
"type": "string",
"format": "uri"
},
"methodology": {
"type": "string",
"format": "uri"
},
"privacy": {
"type": "string",
"format": "uri"
}
},
"required": [
"app",
"methodology",
"privacy"
],
"additionalProperties": false
}
},
"required": [
"ok",
"operation",
"query",
"answer",
"updatedAt",
"confidence",
"answerConfidence",
"primaryAnswerId",
"degraded",
"results",
"safetyNotice",
"attribution",
"links"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_spot_conditions(spotId, lang)
Get current water, weather, wind, UV, wave and current planning signals for one BeachFinder spot ID.
Eingabe-Schema
{
"type": "object",
"properties": {
"spotId": {
"type": "string",
"format": "uuid"
},
"lang": {
"type": "string",
"enum": [
"en",
"fr",
"es",
"de",
"it",
"pt",
"nl",
"ja",
"ko",
"zh",
"ar",
"tr",
"ru",
"id"
],
"default": "en"
}
},
"required": [
"spotId"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}Ausgabe-Schema
{
"type": "object",
"properties": {
"ok": {
"type": "boolean",
"const": true
},
"operation": {
"type": "string"
},
"query": {
"type": "object",
"additionalProperties": {}
},
"answer": {
"type": "string"
},
"updatedAt": {
"type": "string"
},
"confidence": {
"type": "string",
"enum": [
"high",
"medium",
"low"
]
},
"answerConfidence": {
"type": "string",
"enum": [
"high",
"medium",
"low"
]
},
"primaryAnswerId": {
"type": [
"string",
"null"
]
},
"degraded": {
"type": "boolean"
},
"results": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"entityType": {
"type": "string",
"enum": [
"beach",
"swim_spot",
"river_spot",
"van_spot",
"provider",
"guide"
]
},
"verificationStatus": {
"type": "string",
"enum": [
"owner_verified",
"source_backed",
"mapped"
]
},
"name": {
"type": "string"
},
"category": {
"type": [
"string",
"null"
]
},
"location": {
"type": "string"
},
"distanceKm": {
"type": [
"number",
"null"
]
},
"geo": {
"type": "object",
"properties": {
"lat": {
"type": "number"
},
"lng": {
"type": "number"
}
},
"required": [
"lat",
"lng"
],
"additionalProperties": false
},
"canonicalUrl": {
"type": "string",
"format": "uri"
},
"openUrl": {
"type": "string",
"format": "uri"
},
"downloadAppUrl": {
"type": "string",
"format": "uri"
},
"why": {
"type": "array",
"items": {
"type": "string"
}
},
"stableFacts": {
"type": "array",
"items": {
"type": "object",
"properties": {
"label": {
"type": "string"
},
"value": {}
},
"required": [
"label"
],
"additionalProperties": false
}
},
"liveConditions": {
"anyOf": [
{
"type": "object",
"properties": {
"updatedAt": {
"type": [
"string",
"null"
]
},
"observedAt": {
"type": [
"string",
"null"
]
},
"fetchedAt": {
"type": [
"string",
"null"
]
},
"expiresAt": {
"type": [
"string",
"null"
]
},
"source": {
"type": [
"string",
"null"
]
},
"timezone": {
"type": [
"string",
"null"
]
},
"freshnessStatus": {
"type": "string",
"enum": [
"LIVE",
"FRESH",
"STALE",
"EXPIRED",
"UNAVAILABLE"
]
},
"airTemperatureC": {
"type": [
"number",
"null"
]
},
"apparentTemperatureC": {
"type": [
"number",
"null"
]
},
"waterTemperatureC": {
"type": [
"number",
"null"
]
},
"windSpeedKmh": {
"type": [
"number",
"null"
]
},
"windGustKmh": {
"type": [
"number",
"null"
]
},
"uvIndex": {
"type": [
"number",
"null"
]
},
"waveHeightM": {
"type": [
"number",
"null"
]
},
"currentVelocityKmh": {
"type": [
"number",
"null"
]
}
},
"required": [
"updatedAt",
"observedAt",
"fetchedAt",
"expiresAt",
"source",
"timezone",
"freshnessStatus",
"airTemperatureC",
"apparentTemperatureC",
"waterTemperatureC",
"windSpeedKmh",
"windGustKmh",
"uvIndex",
"waveHeightM",
"currentVelocityKmh"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"conditionsUpdatedAt": {
"type": [
"string",
"null"
]
},
"sources": {
"type": "array",
"items": {
"type": "object",
"properties": {
"label": {
"type": "string"
},
"url": {
"type": "string",
"format": "uri"
},
"observedAt": {
"type": [
"string",
"null"
]
}
},
"required": [
"label",
"url"
],
"additionalProperties": false
}
},
"confidence": {
"type": "string",
"enum": [
"high",
"medium",
"low"
]
},
"entityConfidenceScore": {
"type": "number",
"minimum": 0,
"maximum": 100
},
"entityConfidenceLevel": {
"type": "string",
"enum": [
"VERIFIED",
"HIGH_CONFIDENCE",
"PROBABLE",
"UNVERIFIED",
"REJECTED"
]
},
"primaryAnswerEligible": {
"type": "boolean"
},
"primaryAnswerReasons": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"id",
"entityType",
"verificationStatus",
"name",
"location",
"distanceKm",
"canonicalUrl",
"openUrl",
"downloadAppUrl",
"why",
"stableFacts",
"liveConditions",
"conditionsUpdatedAt",
"sources",
"confidence"
],
"additionalProperties": false
}
},
"safetyNotice": {
"type": "string"
},
"attribution": {
"type": "string"
},
"links": {
"type": "object",
"properties": {
"app": {
"type": "string",
"format": "uri"
},
"methodology": {
"type": "string",
"format": "uri"
},
"privacy": {
"type": "string",
"format": "uri"
}
},
"required": [
"app",
"methodology",
"privacy"
],
"additionalProperties": false
}
},
"required": [
"ok",
"operation",
"query",
"answer",
"updatedAt",
"confidence",
"answerConfidence",
"primaryAnswerId",
"degraded",
"results",
"safetyNotice",
"attribution",
"links"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_community_conditions(spotId, lang)
Get an anonymous aggregate of active BeachFinder community reports for one spot. No user identity is returned.
Eingabe-Schema
{
"type": "object",
"properties": {
"spotId": {
"type": "string",
"format": "uuid"
},
"lang": {
"type": "string",
"enum": [
"en",
"fr",
"es",
"de",
"it",
"pt",
"nl",
"ja",
"ko",
"zh",
"ar",
"tr",
"ru",
"id"
],
"default": "en"
}
},
"required": [
"spotId"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}Ausgabe-Schema
{
"type": "object",
"properties": {
"ok": {
"type": "boolean",
"const": true
},
"operation": {
"type": "string"
},
"query": {
"type": "object",
"additionalProperties": {}
},
"answer": {
"type": "string"
},
"updatedAt": {
"type": "string"
},
"confidence": {
"type": "string",
"enum": [
"high",
"medium",
"low"
]
},
"answerConfidence": {
"type": "string",
"enum": [
"high",
"medium",
"low"
]
},
"primaryAnswerId": {
"type": [
"string",
"null"
]
},
"degraded": {
"type": "boolean"
},
"results": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"entityType": {
"type": "string",
"enum": [
"beach",
"swim_spot",
"river_spot",
"van_spot",
"provider",
"guide"
]
},
"verificationStatus": {
"type": "string",
"enum": [
"owner_verified",
"source_backed",
"mapped"
]
},
"name": {
"type": "string"
},
"category": {
"type": [
"string",
"null"
]
},
"location": {
"type": "string"
},
"distanceKm": {
"type": [
"number",
"null"
]
},
"geo": {
"type": "object",
"properties": {
"lat": {
"type": "number"
},
"lng": {
"type": "number"
}
},
"required": [
"lat",
"lng"
],
"additionalProperties": false
},
"canonicalUrl": {
"type": "string",
"format": "uri"
},
"openUrl": {
"type": "string",
"format": "uri"
},
"downloadAppUrl": {
"type": "string",
"format": "uri"
},
"why": {
"type": "array",
"items": {
"type": "string"
}
},
"stableFacts": {
"type": "array",
"items": {
"type": "object",
"properties": {
"label": {
"type": "string"
},
"value": {}
},
"required": [
"label"
],
"additionalProperties": false
}
},
"liveConditions": {
"anyOf": [
{
"type": "object",
"properties": {
"updatedAt": {
"type": [
"string",
"null"
]
},
"observedAt": {
"type": [
"string",
"null"
]
},
"fetchedAt": {
"type": [
"string",
"null"
]
},
"expiresAt": {
"type": [
"string",
"null"
]
},
"source": {
"type": [
"string",
"null"
]
},
"timezone": {
"type": [
"string",
"null"
]
},
"freshnessStatus": {
"type": "string",
"enum": [
"LIVE",
"FRESH",
"STALE",
"EXPIRED",
"UNAVAILABLE"
]
},
"airTemperatureC": {
"type": [
"number",
"null"
]
},
"apparentTemperatureC": {
"type": [
"number",
"null"
]
},
"waterTemperatureC": {
"type": [
"number",
"null"
]
},
"windSpeedKmh": {
"type": [
"number",
"null"
]
},
"windGustKmh": {
"type": [
"number",
"null"
]
},
"uvIndex": {
"type": [
"number",
"null"
]
},
"waveHeightM": {
"type": [
"number",
"null"
]
},
"currentVelocityKmh": {
"type": [
"number",
"null"
]
}
},
"required": [
"updatedAt",
"observedAt",
"fetchedAt",
"expiresAt",
"source",
"timezone",
"freshnessStatus",
"airTemperatureC",
"apparentTemperatureC",
"waterTemperatureC",
"windSpeedKmh",
"windGustKmh",
"uvIndex",
"waveHeightM",
"currentVelocityKmh"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"conditionsUpdatedAt": {
"type": [
"string",
"null"
]
},
"sources": {
"type": "array",
"items": {
"type": "object",
"properties": {
"label": {
"type": "string"
},
"url": {
"type": "string",
"format": "uri"
},
"observedAt": {
"type": [
"string",
"null"
]
}
},
"required": [
"label",
"url"
],
"additionalProperties": false
}
},
"confidence": {
"type": "string",
"enum": [
"high",
"medium",
"low"
]
},
"entityConfidenceScore": {
"type": "number",
"minimum": 0,
"maximum": 100
},
"entityConfidenceLevel": {
"type": "string",
"enum": [
"VERIFIED",
"HIGH_CONFIDENCE",
"PROBABLE",
"UNVERIFIED",
"REJECTED"
]
},
"primaryAnswerEligible": {
"type": "boolean"
},
"primaryAnswerReasons": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"id",
"entityType",
"verificationStatus",
"name",
"location",
"distanceKm",
"canonicalUrl",
"openUrl",
"downloadAppUrl",
"why",
"stableFacts",
"liveConditions",
"conditionsUpdatedAt",
"sources",
"confidence"
],
"additionalProperties": false
}
},
"safetyNotice": {
"type": "string"
},
"attribution": {
"type": "string"
},
"links": {
"type": "object",
"properties": {
"app": {
"type": "string",
"format": "uri"
},
"methodology": {
"type": "string",
"format": "uri"
},
"privacy": {
"type": "string",
"format": "uri"
}
},
"required": [
"app",
"methodology",
"privacy"
],
"additionalProperties": false
}
},
"required": [
"ok",
"operation",
"query",
"answer",
"updatedAt",
"confidence",
"answerConfidence",
"primaryAnswerId",
"degraded",
"results",
"safetyNotice",
"attribution",
"links"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢compare_spots(spotIds, lang, intent)
Compare two to five explicit BeachFinder spot IDs using only documented facts and current available conditions.
Eingabe-Schema
{
"type": "object",
"properties": {
"spotIds": {
"type": "array",
"items": {
"type": "string",
"format": "uuid"
},
"minItems": 2,
"maxItems": 5
},
"lang": {
"type": "string",
"enum": [
"en",
"fr",
"es",
"de",
"it",
"pt",
"nl",
"ja",
"ko",
"zh",
"ar",
"tr",
"ru",
"id"
],
"default": "en"
},
"intent": {
"type": "string",
"enum": [
"general",
"swimming",
"family",
"low-wind",
"warm-water",
"surf",
"accessible",
"amenities"
],
"default": "general"
}
},
"required": [
"spotIds"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}Ausgabe-Schema
{
"type": "object",
"properties": {
"ok": {
"type": "boolean",
"const": true
},
"operation": {
"type": "string"
},
"query": {
"type": "object",
"additionalProperties": {}
},
"answer": {
"type": "string"
},
"updatedAt": {
"type": "string"
},
"confidence": {
"type": "string",
"enum": [
"high",
"medium",
"low"
]
},
"answerConfidence": {
"type": "string",
"enum": [
"high",
"medium",
"low"
]
},
"primaryAnswerId": {
"type": [
"string",
"null"
]
},
"degraded": {
"type": "boolean"
},
"results": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"entityType": {
"type": "string",
"enum": [
"beach",
"swim_spot",
"river_spot",
"van_spot",
"provider",
"guide"
]
},
"verificationStatus": {
"type": "string",
"enum": [
"owner_verified",
"source_backed",
"mapped"
]
},
"name": {
"type": "string"
},
"category": {
"type": [
"string",
"null"
]
},
"location": {
"type": "string"
},
"distanceKm": {
"type": [
"number",
"null"
]
},
"geo": {
"type": "object",
"properties": {
"lat": {
"type": "number"
},
"lng": {
"type": "number"
}
},
"required": [
"lat",
"lng"
],
"additionalProperties": false
},
"canonicalUrl": {
"type": "string",
"format": "uri"
},
"openUrl": {
"type": "string",
"format": "uri"
},
"downloadAppUrl": {
"type": "string",
"format": "uri"
},
"why": {
"type": "array",
"items": {
"type": "string"
}
},
"stableFacts": {
"type": "array",
"items": {
"type": "object",
"properties": {
"label": {
"type": "string"
},
"value": {}
},
"required": [
"label"
],
"additionalProperties": false
}
},
"liveConditions": {
"anyOf": [
{
"type": "object",
"properties": {
"updatedAt": {
"type": [
"string",
"null"
]
},
"observedAt": {
"type": [
"string",
"null"
]
},
"fetchedAt": {
"type": [
"string",
"null"
]
},
"expiresAt": {
"type": [
"string",
"null"
]
},
"source": {
"type": [
"string",
"null"
]
},
"timezone": {
"type": [
"string",
"null"
]
},
"freshnessStatus": {
"type": "string",
"enum": [
"LIVE",
"FRESH",
"STALE",
"EXPIRED",
"UNAVAILABLE"
]
},
"airTemperatureC": {
"type": [
"number",
"null"
]
},
"apparentTemperatureC": {
"type": [
"number",
"null"
]
},
"waterTemperatureC": {
"type": [
"number",
"null"
]
},
"windSpeedKmh": {
"type": [
"number",
"null"
]
},
"windGustKmh": {
"type": [
"number",
"null"
]
},
"uvIndex": {
"type": [
"number",
"null"
]
},
"waveHeightM": {
"type": [
"number",
"null"
]
},
"currentVelocityKmh": {
"type": [
"number",
"null"
]
}
},
"required": [
"updatedAt",
"observedAt",
"fetchedAt",
"expiresAt",
"source",
"timezone",
"freshnessStatus",
"airTemperatureC",
"apparentTemperatureC",
"waterTemperatureC",
"windSpeedKmh",
"windGustKmh",
"uvIndex",
"waveHeightM",
"currentVelocityKmh"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"conditionsUpdatedAt": {
"type": [
"string",
"null"
]
},
"sources": {
"type": "array",
"items": {
"type": "object",
"properties": {
"label": {
"type": "string"
},
"url": {
"type": "string",
"format": "uri"
},
"observedAt": {
"type": [
"string",
"null"
]
}
},
"required": [
"label",
"url"
],
"additionalProperties": false
}
},
"confidence": {
"type": "string",
"enum": [
"high",
"medium",
"low"
]
},
"entityConfidenceScore": {
"type": "number",
"minimum": 0,
"maximum": 100
},
"entityConfidenceLevel": {
"type": "string",
"enum": [
"VERIFIED",
"HIGH_CONFIDENCE",
"PROBABLE",
"UNVERIFIED",
"REJECTED"
]
},
"primaryAnswerEligible": {
"type": "boolean"
},
"primaryAnswerReasons": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"id",
"entityType",
"verificationStatus",
"name",
"location",
"distanceKm",
"canonicalUrl",
"openUrl",
"downloadAppUrl",
"why",
"stableFacts",
"liveConditions",
"conditionsUpdatedAt",
"sources",
"confidence"
],
"additionalProperties": false
}
},
"safetyNotice": {
"type": "string"
},
"attribution": {
"type": "string"
},
"links": {
"type": "object",
"properties": {
"app": {
"type": "string",
"format": "uri"
},
"methodology": {
"type": "string",
"format": "uri"
},
"privacy": {
"type": "string",
"format": "uri"
}
},
"required": [
"app",
"methodology",
"privacy"
],
"additionalProperties": false
}
},
"required": [
"ok",
"operation",
"query",
"answer",
"updatedAt",
"confidence",
"answerConfidence",
"primaryAnswerId",
"degraded",
"results",
"safetyNotice",
"attribution",
"links"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}Community
Nachweis
Aktuelle Beobachtungen
verifiziertVersion nicht aufgezeichnet12 Tools
verifiziertVersion nicht aufgezeichnet12 Tools