Suchanbieter#
Seurch kombiniert Ergebnisse von mehreren unabhängigen Anbietern. Welche Tabs und Karten erscheinen, hängt davon ab, welche Schlüssel Sie setzen. Ein Anbieter ohne Schlüssel wird ausgeblendet; der betroffene Tab oder die Karte erscheint einfach nicht, anstatt einen Fehler anzuzeigen.
Alle vorgelagerten Aufrufe erfolgen serverseitig; Schlüssel werden nie an den Browser weitergegeben.
Diese Seite bietet den Überblick darüber, welcher Schlüssel was aktiviert. Schritt-für-Schritt-Anweisungen zur Anmeldung bei jedem Anbieter finden Sie unter API-Schlüssel erhalten.
Die Basis: Brave#
| Variable | Schlüssel erhalten |
|---|---|
BRAVE_API_KEY | brave.com/search/api (kostenloses Kontingent verfügbar) |
BRAVE_SUGGEST_API_KEY | Gleiche Stelle, ein separates Abonnement für Autocomplete |
Brave ist der empfohlene Ausgangspunkt: Ein einzelner Schlüssel betreibt die Web-, Bilder-, Nachrichten- und Videos-Tabs. Ohne konfigurierte Web-Suchmaschine zeigen diese Tabs einen Konfigurationshinweis anstelle von Ergebnissen.
Zusätzliche Web-Suchmaschinen#
Fügen Sie beliebige davon hinzu, um weitere unabhängige Indizes in den Web-Tab einzumischen (zusammengeführt mit Reciprocal Rank Fusion; siehe Web-Suche):
| Variable | Anbieter | Schlüssel erhalten |
|---|---|---|
MOJEEK_API_KEY | Mojeek (unabhängiger britischer Index) | mojeek.com/services/search/api |
MARGINALIA_API_KEY | Marginalia (Small-Web-Index) | Keine Anmeldung; der Literalwert public ist ein kostenloser geteilter Schlüssel (begrenzt auf ~1 Anfrage / 5 s). Für ein höheres Kontingent auf marginalia-search.com anfragen |
STAAN_API_KEY | Staan (europäischer Index, von Qwant und Ecosia) | staan.ai — 1.000 kostenlose Anfragen pro Monat, danach ab 1 EUR pro 1.000. Endet nach den ersten vier Seiten einer Suche |
Medienanbieter#
Jeder Medien-Tab mischt Brave mit einem zweiten Anbieter. Der ergänzende Anbieter ist auch die einzige Quelle für die reinen Web-Suchmaschinen (Mojeek, Marginalia und Staan), die keine eigene Mediensuche haben.
| Tab | Variable | Anbieter | Schlüssel |
|---|---|---|---|
| Bilder | PIXABAY_API_KEY | Pixabay | Kostenlos |
| Nachrichten | WORLDNEWS_API_KEY | World News API | Kostenloses Kontingent |
| Videos | (keiner) | Sepia / PeerTube | Kein Schlüssel erforderlich |
Karten benötigt überhaupt keinen Schlüssel; es verwendet OpenStreetMaps Nominatim.
Wissenskarten-Anbieter#
Der Web-Tab kann bis zu drei Wissenskarten seitlich anzeigen:
| Karte | Variable | Anbieter | Schlüssel |
|---|---|---|---|
| Wikipedia | (keiner) | Wikipedia / Wikidata | Kein Schlüssel erforderlich |
| Film / TV | THETVDB_API_KEY (+ THETVDB_PIN) | TheTVDB | Kommerzielle Lizenz oder ein nutzerfinanzierter Schlüssel plus Abonnenten-PIN |
| Orte | TRIPADVISOR_API_KEY | TripAdvisor Terra Partner API | Partnerschlüssel, per X-API-Key gesendet |
| Q&A | STACKEXCHANGE_API_KEY | Stack Exchange | Optional, erhöht das gemeinsame anonyme Kontingent |
Die kostenpflichtigen Karten-APIs werden nur aufgerufen, wenn eine Anfrage tatsächlich wie ein Film oder ein Ort aussieht, und jeder Abruf wird eine Stunde gecacht. Das Aufrufvolumen bleibt damit niedrig und bescheiden gemessen an einer TheTVDB-Lizenz oder einem TripAdvisor-Tarif.
Die Orte-Karte läuft über TripAdvisors Terra Partner API, die die eingestellte Content API ersetzt hat — Schlüssel für die alte liefern jetzt
403. Sie wird aus den Katalog-Endpunkten aufgebaut, die ohne Partner-Zulassungsliste antworten. Die Karte zeigt daher Name, Gebiet, Adresse, Bewertung, Anzahl der Rezensionen und eine Beschreibung, aber kein Foto, keine Küche, keine Preisklasse und kein Ranking; diese erfordern eine Lizenz je Standort.
Anbieter-Statusseite#
Eine eingebaute /status-Seite zeigt, ob jeder konfigurierte vorgelagerte Anbieter erreichbar ist, verlinkt aus der Fußzeile der Website und aus Einstellungen → Anbieterstatus. Sie verbraucht dabei nie kostenpflichtiges Kontingent:
- Anbieter mit einem kostenlosen Gesundheits-Endpunkt (Nominatim, LibreTranslate, Open-Meteo, Frankfurter) werden planmäßig abgefragt.
- Der Status jedes anderen Anbieters wird davon abgeleitet, ob echte Suchen kürzlich erfolgreich waren.
Halten Sie den Status aktuell, indem Sie check_provider_health regelmäßig ausführen; siehe Wartung.
Setzen Sie STATUS_PAGE_ENABLED=false, um diese Information für sich zu behalten: Die Seite liefert 404, und ihre Links verschwinden. Die Gesundheit wird weiterhin aufgezeichnet, und /status/health antwortet weiterhin, sodass ein externer Überwachungsdienst weiterarbeitet, siehe Überwachung.
Netzwerk-Zulassungsliste#
Wenn der ausgehende Datenverkehr Ihres Servers eingeschränkt ist, benötigen die zwei Sofortantwort-Netzwerkaufrufe diese Hosts auf der Zulassungsliste:
api.frankfurter.dev(Wechselkurse)geocoding-api.open-meteo.comundapi.open-meteo.com(Wetter)
Die Wissenskarten erreichen api4.thetvdb.com, artworks.thetvdb.com, terra.tripadvisor.com und www.wikidata.org.
Alles andere wird über Standard-HTTPS zum API-Host jedes Anbieters erreicht. Die lokalen Sofortantworten (Mathematik, Einheiten, Hashes, …) benötigen überhaupt kein Netzwerk.