Fournisseurs de recherche#
Seurch mélange les résultats de plusieurs fournisseurs indépendants. Les onglets et fiches qui apparaissent dépendent des clés que vous définissez. Un fournisseur sans clé est masqué ; l’onglet ou la fiche concerné n’apparaît tout simplement pas, plutôt que d’afficher une erreur.
Tous les appels amont se font côté serveur ; les clés ne sont jamais exposées au navigateur.
Cette page est l’aperçu indiquant quelle clé active quoi. Pour les instructions d’inscription pas à pas pour chaque fournisseur, voir Obtenir les clés API.
La base : Brave#
| Variable | Obtenir une clé |
|---|---|
BRAVE_API_KEY | brave.com/search/api (niveau gratuit disponible) |
BRAVE_SUGGEST_API_KEY | Au même endroit, un abonnement séparé pour la complétion automatique |
Brave est le point de départ recommandé : une seule clé alimente les onglets Web, Images, Actualités et Vidéos. Sans moteur web configuré, ces onglets affichent un avis de configuration à la place des résultats.
Moteurs web supplémentaires#
Ajoutez l’un ou les deux pour mélanger d’autres index indépendants dans l’onglet Web (fusionnés par Reciprocal Rank Fusion, voir Recherche web) :
| Variable | Fournisseur | Obtenir une clé |
|---|---|---|
MOJEEK_API_KEY | Mojeek (index UK indépendant) | mojeek.com/services/search/api |
MARGINALIA_API_KEY | Marginalia (index petit web) | Pas d’inscription, la valeur littérale public est une clé partagée gratuite (limitée à ~1 requête / 5 s). Pour un quota plus élevé, en faire la demande sur marginalia-search.com |
Fournisseurs de médias#
Chaque onglet de médias mélange Brave avec un second fournisseur. Le fournisseur supplémentaire est aussi la seule source pour les moteurs Mojeek/Marginalia, qui n’ont pas de recherche de médias propre.
| Onglet | Variable | Fournisseur | Clé |
|---|---|---|---|
| Images | PIXABAY_API_KEY | Pixabay | Gratuite |
| Actualités | WORLDNEWS_API_KEY | World News API | Niveau gratuit |
| Vidéos | (aucune) | Sepia / PeerTube | Aucune clé requise |
Cartes ne nécessite aucune clé, il utilise Nominatim d’OpenStreetMap.
Fournisseurs de fiches de connaissance#
L’onglet web peut afficher jusqu’à trois fiches de connaissance latérales :
| Fiche | Variable | Fournisseur | Clé |
|---|---|---|---|
| Wikipédia | (aucune) | Wikipedia / Wikidata | Aucune clé requise |
| Film / Série | TMDB_API_KEY | TMDB | Gratuite |
| Lieux | TRIPADVISOR_API_KEY | TripAdvisor Content API | Gratuite |
| Q&A | STACKEXCHANGE_API_KEY | Stack Exchange | Optionnelle, augmente le quota partagé anonyme |
Les API de fiches payantes ne sont appelées que lorsqu’une requête ressemble réellement à un film ou un lieu, et chaque consultation est mise en cache pendant une heure, ce qui les maintient confortablement dans les niveaux gratuits.
Page de statut des fournisseurs#
Une page /status intégrée indique si chaque fournisseur configuré est opérationnel. Elle ne dépense jamais de quota payant pour le savoir :
- Les fournisseurs avec un point de terminaison de santé gratuit (Nominatim, LibreTranslate, Open-Meteo, Frankfurter) sont sondés régulièrement.
- Le statut de tous les autres fournisseurs est déduit du fait que des recherches réelles ont récemment réussi.
Maintenez le statut à jour en exécutant check_provider_health périodiquement, voir Maintenance.
Liste blanche réseau#
Si le trafic sortant de votre serveur est restreint, les deux appels réseau de réponse instantanée nécessitent que ces hôtes soient autorisés :
api.frankfurter.dev(taux de change)geocoding-api.open-meteo.cometapi.open-meteo.com(météo)
Tout le reste est atteint via HTTPS standard vers l’hôte API de chaque fournisseur. Les réponses instantanées locales (calculs, unités, hachages, …) ne nécessitent aucun réseau.