Documentation Seurch

Authentification

Mon, 01 Jan 0001 00:00:00 +0000

Authentification#

Chaque requête API doit comporter une clé API valide. Les clés sont émises par utilisateur ; une requête sans clé reçoit 401, et une requête avec une clé incorrecte ou révoquée est rejetée.

L’API est une fonctionnalité auto-hébergée, donc les clés sont émises sur votre propre instance, pas sur le service hébergé seurch.eu.

Obtenir une clé#

Sur votre instance :

Dans l’interface web : Paramètres → Clés API, créez une clé (nommez-la optionnellement). La clé complète est affichée une seule fois ; copiez-la immédiatement.
Depuis la ligne de commande (administrateurs) : python manage.py create_api_key <nom_utilisateur> --name "mon script", voir Gestion des clés API.

Une clé ressemble à :

Premiers pas

Mon, 01 Jan 0001 00:00:00 +0000

Premiers pas#

Se connecter#

Seurch nécessite un compte ; il n’existe pas de recherche anonyme. Le compte lui-même peut toutefois être anonyme : seuls un nom d’utilisateur et un mot de passe sont nécessaires, aucune adresse e-mail ni information personnelle n’est requise (l’e-mail est facultatif et sert uniquement à la réinitialisation du mot de passe, voir Votre compte). Sur le service hébergé, les comptes sont sur invitation pendant la phase alpha ; sur une instance auto-hébergée, c’est l’administrateur qui les crée.

Prérequis

Mon, 01 Jan 0001 00:00:00 +0000

Prérequis#

Environnement d’exécution#

Composant	Notes
Un moteur de conteneurs	Docker ou Podman, pour exécuter l’image publiée.
PostgreSQL	La base de données applicative. Tout PostgreSQL raisonnablement récent (16+) convient.
Une clé API Brave Search	Le minimum pour des résultats utiles, voir Fournisseurs de recherche. Le niveau gratuit suffit pour commencer.
HTTPS sortant	Le serveur appelle les fournisseurs amont ; si vous êtes derrière une liste blanche, voir les hôtes des fournisseurs.

Tout le reste — serveur web, service des fichiers statiques et compilation des catalogues de traduction — est intégré dans l’image.

Démarrage rapide

Mon, 01 Jan 0001 00:00:00 +0000

Démarrage rapide#

Le moyen le plus rapide d’avoir une instance opérationnelle est l’image Docker. Vous avez besoin d’une base de données PostgreSQL et, au minimum, d’une clé API Brave Search.

Avec Docker#

docker run -p 8000:8000 \
 -e SECRET_KEY=votre-long-secret-aléatoire \
 -e DATABASE_URL=postgres://utilisateur:motdepasse@hôte-db:5432/seurch \
 -e ALLOWED_HOSTS=search.example.com \
 -e BRAVE_API_KEY=votre-clé-brave \
 -e BRAVE_SUGGEST_API_KEY=votre-clé-brave-suggest \
 -e MARGINALIA_API_KEY=public \
 seurch

Au démarrage, le conteneur :

Applique les migrations de base de données (sans effet une fois le schéma à jour).
Sert l’application avec gunicorn (2 workers) sur le port 8000.
Sert ses propres fichiers statiques via WhiteNoise (compressés et hachés), sans serveur web séparé ni CDN requis.
Répond à une vérification de santé sur /up.

Les catalogues de traduction et les fichiers statiques sont compilés à la construction, il n’y a donc rien d’autre à lancer.

Limites de débit

Mon, 01 Jan 0001 00:00:00 +0000

Limites de débit#

Chaque clé API dispose de son propre budget, appliqué par deux limites qui s’appliquent ensemble. Une requête doit satisfaire les deux :

Limite	Par défaut	Rôle
Burst	`60/min`	Plafond à court terme, protège les fournisseurs amont d’un client incontrôlé.
Sustained	`5000/day`	Plafonne le volume quotidien total.

Sur une instance auto-hébergée, ces valeurs sont configurables avec API_THROTTLE_BURST et API_THROTTLE_SUSTAINED, voir Configuration.

Lorsque vous dépassez une limite#

Dépasser l’une ou l’autre limite renvoie :

Recherche web

Mon, 01 Jan 0001 00:00:00 +0000

Recherche web#

L’onglet Web est le cœur de Seurch. Il peut s’appuyer sur trois index web indépendants et fusionner ceux que vous activez en une seule liste classée.

Les trois moteurs#

Moteur	Description
Brave	Un grand index web indépendant (alimente aussi Images, Actualités et Vidéos).
Mojeek	Un index de recherche britannique indépendant avec son propre robot d’exploration.
Marginalia	Un index non commercial axé sur le web petit et non commercial.

Vous choisissez les moteurs à utiliser dans Paramètres → Moteurs. Activez-en un seul pour une source unique, ou plusieurs pour les combiner. Les trois sont activés par défaut.

Configuration

Mon, 01 Jan 0001 00:00:00 +0000

Configuration#

Seurch est entièrement configuré via des variables d’environnement (en production) ou un fichier .env (en développement). Le dépôt inclut un fichier .env.example documentant chaque variable ; cette page en est la référence.

Noyau#

Variable	Rôle	Notes
`SECRET_KEY`	Clé secrète Django	Requise en production. Longue et aléatoire.
`DEBUG`	Mode débogage	Maintenez `False` (la valeur par défaut) en production.
`ALLOWED_HOSTS`	Noms d’hôtes séparés par des virgules que l’application servira	ex. `search.example.com`.
`DATABASE_URL`	URL de connexion PostgreSQL	ex. `postgres://utilisateur:mdp@hôte:5432/seurch`.
`LOG_LEVEL`	Verbosité des logs	`DEBUG` / `INFO` / `WARNING` / `ERROR` (par défaut `INFO`).

Fournisseurs de recherche#

Ces clés déterminent quels moteurs, onglets de médias et fiches de connaissance sont disponibles. Un fournisseur sans clé est simplement masqué (pas affiché comme cassé). Détails complets dans Fournisseurs de recherche.

Conventions

Mon, 01 Jan 0001 00:00:00 +0000

Conventions#

Paramètres de requête partagés#

Les points de terminaison de recherche acceptent un ensemble commun de paramètres. Chacun correspond à une option que le site web conserve dans son cookie de préférences ; ici, ils sont explicites dans l’URL.

Paramètre	S’applique à	Valeurs	Par défaut
`q`	tous les points de terminaison de recherche	La chaîne de requête (requise)	—
`engine`	web, images, actualités, vidéos, fiches	`brave`, `mojeek`, `marginalia`, ou `all` ; séparez-en plusieurs par une virgule ou un espace	`all`
`safe`	web, images, actualités, vidéos, fiches	`on` / `off` (`off`, `false`, `0`, `no` signifient tous off)	`on`
`lang`	la plupart des points de terminaison	Un code de langue, par ex. `fr`, `en`	vide (auto)
`page`	web, images, actualités, vidéos	Numéro de page, `1`–`50`	`1`
`date`	web, actualités, vidéos	Plage temporelle : `d` (jour), `w` (semaine), `m` (mois), `y` (année)	aucun

Notes :

Onglets de recherche

Mon, 01 Jan 0001 00:00:00 +0000

Onglets de recherche#

En plus de l’onglet Web, Seurch propose des onglets dédiés aux images, aux actualités, aux vidéos, aux cartes et à la traduction. Chacun exécute votre requête contre des sources adaptées à ce type de contenu. Un onglet n’apparaît que lorsque l’instance dispose du fournisseur correspondant configuré.

Images#

Les résultats d’images proviennent de l’index Brave, complétés par Pixabay lorsqu’il est activé. Les résultats sont affichés sous forme de grille de miniatures.

Fournisseurs de recherche

Mon, 01 Jan 0001 00:00:00 +0000

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.

Points de terminaison de recherche

Mon, 01 Jan 0001 00:00:00 +0000

Points de terminaison de recherche#

Les points de terminaison essentiels : recherche web, d’images, d’actualités et de vidéos, plus l’assistant « images similaires ». Tous acceptent les paramètres partagés (q, engine, safe, lang, page, date).

Recherche web#

GET /api/v1/web/?q=...

curl -H "Authorization: Api-Key seurch_sk_<préfixe>.<secret>" \
 "https://search.example.com/api/v1/web/?q=climat&engine=all&lang=fr&date=w"

{
 "query": "climat",
 "tab": "web",
 "page": 1,
 "engine": ["brave", "mojeek", "marginalia"],
 "correction": "",
 "results": [
 {
 "title": "Changement climatique",
 "url": "https://example.org/climat",
 "description": "...",
 "display_url": "example.org",
 "favicon_url": "https://...",
 "age": "il y a 2 jours",
 "source": "all",
 "source_label": "Brave, Mojeek, Marginalia",
 "sitelinks": []
 }
 ]
}

source / source_label — quels moteurs ont renvoyé le résultat. brave / mojeek / marginalia pour un seul moteur, ou both / all pour un accord inter-moteurs (source_label est la forme lisible).
correction — une correction orthographique suggérée, ou "".

Recherche d’images#

GET /api/v1/images/?q=...

{
 "query": "golden retriever",
 "tab": "images",
 "page": 1,
 "engine": ["brave"],
 "results": [
 {
 "title": "...",
 "url": "https://example.com/page",
 "source": "example.com",
 "thumbnail": "https://.../thumb.jpg"
 }
 ]
}

Images similaires#

Reproduit la grille « images similaires » de la lightbox du site web, une recherche d’images alimentée par la légende d’une image ouverte.

Réponses instantanées

Mon, 01 Jan 0001 00:00:00 +0000

Réponses instantanées#

Pour les requêtes utilitaires courantes, Seurch affiche une réponse instantanée tout en haut des résultats web, vous donnant la réponse sans cliquer nulle part. C’est dans l’esprit des réponses instantanées de DuckDuckGo.

Presque toutes les réponses instantanées sont calculées localement sur le serveur, sans tiers impliqué et sans envoyer votre requête nulle part.

Ce que vous pouvez demander#

Catégorie	Exemples de requêtes
Calculatrice	`2+2`, `sqrt(16)*3`, `15% de 200`
Conversion d’unités	`5 km en miles`, `100 f en c`, `2 tasses en ml`
Conversion de base	`0xff en décimal`, `255 en binaire`
Couleur	`#4f46e5`, `rgb(255,128,0)`, `color picker`
Horloge mondiale	`heure à tokyo`, `quelle heure est-il à new york`
Code QR	`qr code https://example.com`
Hachage / UUID	`md5 hello`, `sha256 de test`, `uuid`
Mot de passe	`générateur de mot de passe`, `mot de passe sécurisé`
Heure Unix	`timestamp unix`, `1700000000 en date`
Encodage / décodage	`base64 encoder bonjour`, `url décoder foo%20bar`
JSON / Regex	`formateur json`, `testeur regex`
HTTP / Ports	`http 404`, `port 443`
Aléatoire	`lancer 2d6`, `pile ou face`, `nombre aléatoire 1-100`
Minuteur	`minuteur 5 minutes`, `chronomètre`
Mon IP	`quelle est mon ip`

Déclencheurs multilingues#

Les réponses instantanées se déclenchent dans sept langues : anglais, français, allemand, espagnol, italien, portugais et néerlandais. Par exemple, tous ces exemples fonctionnent :

Cartes

Mon, 01 Jan 0001 00:00:00 +0000

Cartes#

Géocodez un nom de lieu ou effectuez un géocodage inverse d’une paire de coordonnées, en utilisant Nominatim d’OpenStreetMap. Aucune clé de fournisseur n’est requise.

GET /api/v1/maps/

Géocoder un nom de lieu#

GET /api/v1/maps/?q=<lieu>&limit=<n>&lang=<code>

q — le lieu ou l’adresse à rechercher (requis dans ce mode).
limit — nombre maximum de résultats, 1–50 (par défaut 10).
lang — langue préférée pour les noms.

curl -H "Authorization: Api-Key seurch_sk_<préfixe>.<secret>" \
 "https://search.example.com/api/v1/maps/?q=Tour+Eiffel&limit=1"

{
 "query": "Tour Eiffel",
 "places": [
 {
 "name": "Tour Eiffel",
 "display_name": "Tour Eiffel, Paris, France",
 "lat": 48.8584,
 "lon": 2.2945,
 "category": "tourism",
 "type": "attraction",
 "addresstype": "tourism",
 "importance": 0.82,
 "embed_url": "https://www.openstreetmap.org/export/embed.html?...",
 "mini_embed_url": "https://...",
 "osm_url": "https://www.openstreetmap.org/...",
 "directions_url": "https://www.openstreetmap.org/directions?...",
 "geo_uri": "geo:48.8584,2.2945"
 }
 ]
}

Géocodage inverse de coordonnées#

Passez lat et lon à la place de q :

Fiches de connaissance

Mon, 01 Jan 0001 00:00:00 +0000

Fiches de connaissance#

Lorsque votre recherche web (première page) porte sur un sujet bien connu, Seurch affiche jusqu’à trois fiches de connaissance à côté des résultats, un résumé rapide qui vous évite souvent de cliquer.

Les fiches#

Fiche	Source	Affiche
Wikipédia	Wikipédia	Un résumé, une image et un lien vers le sujet. C’est la fiche principale, elle aide aussi à détecter ce que les autres fiches doivent montrer.
Film / Série	TMDB	Détails d’un film ou d’une série : affiche, note, année, synopsis.
Lieux	TripAdvisor	Un restaurant, un hôtel ou une attraction : note, adresse (qui renvoie à la carte) et un lien.
Q&A	Stack Exchange	La meilleure question et réponse pour une requête technique.

Comment elles sont choisies#

Seurch n’affiche une fiche que lorsque votre requête correspond réellement à ce type de sujet :

Obtenir les clés API

Mon, 01 Jan 0001 00:00:00 +0000

Obtenir les clés API#

Guides pas à pas pour obtenir la clé de chaque fournisseur. Aucune n’est requise pour démarrer Seurch, mais au moins un moteur web (Brave est le plus simple) est nécessaire pour des résultats utiles. Chaque fournisseur que vous ignorez masque simplement son onglet ou sa fiche ; voir Fournisseurs de recherche pour ce que chacun active.

Une fois que vous avez une clé, définissez la variable d’environnement correspondante (voir Configuration) et redémarrez l’application.

Bangs

Mon, 01 Jan 0001 00:00:00 +0000

Bangs#

Les bangs sont des !raccourcis que vous tapez dans la zone de recherche pour envoyer directement une requête vers un autre site ou un onglet Seurch différent. Seurch comprend le vocabulaire de bangs à la mode DuckDuckGo largement utilisé, des milliers de sites, plus quelques-uns qui lui sont propres.

Les définitions de bangs proviennent du dépôt de bangs open source de Kagi, la même liste !bang communautaire que Kagi publie. Les auto-hébergeurs peuvent la rafraîchir avec make bangs, voir Maintenance.

Traduction

Mon, 01 Jan 0001 00:00:00 +0000

Traduction#

Traduisez du texte entre langues, alimenté par le LibreTranslate de l’instance. Ce point de terminaison accepte GET ou POST ; utilisez POST pour garder le texte long hors de l’URL et des journaux.

GET /api/v1/translate/
POST /api/v1/translate/

Traduire du texte#

Paramètre	Requis	Signification
`q` (ou `text`)	oui	Le texte à traduire
`target`	oui	Code de la langue cible (par ex. `fr`)
`source`	non	Code de la langue source ; par défaut `auto` (détection automatique)

# GET
curl -H "Authorization: Api-Key seurch_sk_<préfixe>.<secret>" \
 "https://search.example.com/api/v1/translate/?q=hello&target=fr"

# POST (mieux pour les textes longs)
curl -X POST -H "Authorization: Api-Key seurch_sk_<préfixe>.<secret>" \
 -d "q=hello world" -d "target=fr" \
 "https://search.example.com/api/v1/translate/"

{
 "source": "auto",
 "target": "fr",
 "translated_text": "bonjour le monde",
 "detected_lang": "en"
}

detected_lang n’est renseigné que lorsque source était auto (sinon vide).
Si la traduction n’est pas configurée sur l’instance, le point de terminaison renvoie 503 avec {"detail": "Translation is unavailable or not configured on this deployment."}.

Lister les langues disponibles#

GET /api/v1/translate/languages/

{
 "languages": [
 { "code": "en", "name": "English" },
 { "code": "fr", "name": "French" }
 ]
}

La liste reflète ce que l’instance LibreTranslate connectée propose ; voir Traduction pour le côté auto-hébergement.

Traduction

Mon, 01 Jan 0001 00:00:00 +0000

Traduction (LibreTranslate)#

L’onglet Traduction est alimenté par LibreTranslate, un serveur de traduction automatique open source et auto-hébergeable. Seurch l’appelle côté serveur ; aucun service de traduction tiers n’est impliqué.

Activer l’onglet#

Pointez Seurch vers une instance LibreTranslate avec LIBRETRANSLATE_URL :

LIBRETRANSLATE_URL=http://libretranslate:5000

Définissez-la et l’onglet Traduction (ainsi que son paramètre) apparaissent, avec les langues que cette instance propose.
Laissez-la non définie et l’onglet Traduction ainsi que son paramètre sont entièrement désactivés.

Exécuter LibreTranslate#

La pile de développement démarre automatiquement un LibreTranslate local (make up en lance un sur http://localhost:5000). Pour la production, déployez le vôtre, par exemple :

Instantané et fiches

Mon, 01 Jan 0001 00:00:00 +0000

Réponses instantanées et fiches de connaissance#

Ces deux points de terminaison reproduisent les réponses en ligne et les panneaux latéraux du site web. Leur contenu variant selon le type de réponse et le fournisseur, ils renvoient du JSON de forme fournisseur plutôt qu’un schéma fixe par champ ; traitez les structures comme des données et lisez les champs dont vous avez besoin.

Réponses instantanées#

GET /api/v1/instant/?q=...

Renvoie la réponse instantanée pour une requête utilitaire (calculs, conversion d’unités/base/couleur, météo, devise, horloge mondiale, hachages, QR, « quelle est mon IP », …), ou null lorsque la requête n’est pas une réponse inline de Seurch.

Paramètres

Mon, 01 Jan 0001 00:00:00 +0000

Paramètres#

Ouvrez Paramètres depuis la page d’accueil ou le menu pour personnaliser Seurch. Vos préférences se synchronisent automatiquement avec votre compte et sont restaurées sur tous les appareils connectés. Elles sont également stockées dans votre navigateur, ce qui les applique même avant que vous vous connectiez.

Ce que vous pouvez modifier#

Paramètre	Options	Par défaut
Moteurs	Toute combinaison de Brave / Mojeek / Marginalia	Tous activés
Recherche sécurisée	Activée / Désactivée	Activée
Langue de recherche	Auto, ou l’une des sept langues d’interface	Auto (votre navigateur)
Langue d’interface	Auto, ou l’une des sept langues d’interface	Auto
Thème	Système / Clair / Sombre	Système
Ouvrir les liens	Même onglet / Nouvel onglet	Même onglet
Proxy des images	Activé / Désactivé	Désactivé
Chargement différé des fiches	Activé / Désactivé	Activé
Sources de données	Bascules activé/désactivé par fournisseur	Tous activés

Moteurs#

Choisissez quels index web Seurch interroge et fusionne, voir Recherche web. C’est aussi là que vous gérez vos sites bloqués et vos bangs personnalisés.

Utilisateurs et accès

Mon, 01 Jan 0001 00:00:00 +0000

Utilisateurs et accès#

Seurch est accessible uniquement par connexion et sans inscription publique, donc en tant qu’administrateur, vous contrôlez qui a un compte. C’est ce qui maintient une instance privée pour vos utilisateurs.

Créer des comptes#

Créez des utilisateurs avec la commande de gestion standard de Django :

# Docker
docker exec -it <conteneur> python manage.py createsuperuser

# Depuis les sources
make superuser

createsuperuser crée un compte administrateur ; pour les utilisateurs ordinaires, vous pouvez les créer de la même façon (ou depuis l’administration Django une fois que vous avez un superutilisateur). Chaque compte nécessite un nom d’utilisateur et un mot de passe ; un e-mail est optionnel (voir ci-dessous).

Clés API

Mon, 01 Jan 0001 00:00:00 +0000

Clés API#

Les utilisateurs accèdent à l’API publique avec des clés API par utilisateur. Les utilisateurs peuvent gérer leurs propres clés dans l’interface web (Paramètres → Clés API), et vous pouvez les gérer depuis la ligne de commande.

Comment les clés sont stockées#

Une clé ressemble à seurch_sk_<préfixe>.<secret> :

Le préfixe (8 caractères) est stocké en clair pour une recherche rapide.
Seul un hachage SHA-256 du secret est stocké, jamais le secret lui-même.

Ainsi, la valeur complète d’une clé est affichée exactement une fois, à la création, et ne peut pas être récupérée par la suite, uniquement révoquée.

Points de terminaison méta

Mon, 01 Jan 0001 00:00:00 +0000

Points de terminaison méta#

Assistants pour la complétion automatique, l’état de santé des fournisseurs, l’introspection de clé et la découverte de points de terminaison. La racine, status/ et key/ ne comptent pas dans votre usage mensuel de recherches (ils comptent quand même contre la limite de débit brute).

Suggestions#

Suggestions de complétion automatique de la barre de recherche pour une requête. (Compte comme une recherche.)

GET /api/v1/suggest/?q=...

curl -H "Authorization: Api-Key seurch_sk_<préfixe>.<secret>" \
 "https://search.example.com/api/v1/suggest/?q=clim"

{
 "query": "clim",
 "suggestions": ["climat", "changement climatique", "escalade"]
}

Statut des fournisseurs#

État actuel (opérationnel/hors service) de chaque fournisseur amont configuré, les données derrière la page /status. (Ne compte pas dans l’usage.)

Votre compte

Mon, 01 Jan 0001 00:00:00 +0000

Votre compte#

Se connecter#

Seurch nécessite une connexion ; toute recherche se fait sous votre compte, et il n’existe pas de formulaire d’inscription public. Sur le service hébergé, les comptes sont sur invitation pendant la phase alpha ; sur une instance auto-hébergée, c’est l’administrateur qui crée les comptes.

Votre compte peut être anonyme : il nécessite uniquement un nom d’utilisateur et un mot de passe, sans e-mail ni autre information personnelle. Il n’existe pas de recherche anonyme (vous êtes toujours connecté), mais le compte derrière n’a pas besoin de vous identifier.

Erreurs

Mon, 01 Jan 0001 00:00:00 +0000

Erreurs#

L’API utilise des codes de statut HTTP standard et renvoie un corps JSON décrivant le problème.

Codes de statut#

Code	Signification	Cause typique
`200`	OK	Requête réussie.
`400`	Mauvaise requête	Un paramètre incorrect, par ex. un `q` manquant, un `page` non entier, ou un `engine` inconnu.
`401`	Non autorisé	Aucune clé API envoyée (ou aucun en-tête d’authentification reconnu).
`403`	Interdit	La clé appartient à un compte désactivé.
`429`	Trop de requêtes	Une limite de débit a été dépassée.
`503`	Service indisponible	Un service dépendant n’est pas configuré, par ex. la traduction lorsque LibreTranslate n’est pas défini.

Corps d’erreur#

Erreurs de validation (`400`)#

Messages indexés par champ :

Maintenance

Mon, 01 Jan 0001 00:00:00 +0000

Maintenance#

Seurch nécessite peu de maintenance continue, mais quelques commandes de gestion permettent de le garder propre et à jour. Exécutez-les selon un planning (tâche cron, minuteur systemd ou fonctionnalité de tâche planifiée de votre orchestrateur). Exécutez chacune à l’intérieur du conteneur (docker exec <conteneur> python manage.py …) ou via make / uv run depuis les sources.

Tâches planifiées#

Commande	Ce qu’elle fait	Planning suggéré
`clear_expired_cache`	Supprime les lignes de cache de résultats de recherche expirées	Quotidien
`check_provider_health`	Sonde les fournisseurs avec un point de terminaison de santé gratuit afin que `/status` reste à jour, sans dépenser de quota payant	Toutes les ~10 minutes
`refresh_currency`	Rafraîchit les taux de change mis en cache et purge le cache de réponses instantanées	Quotidien (optionnel, se rafraîchit aussi à la demande)

Un exemple de cron :

Vie privée

Mon, 01 Jan 0001 00:00:00 +0000

Vie privée#

Seurch est conçu pour être une alternative privée aux moteurs de recherche financés par la surveillance. Voici ce que cela signifie en pratique.

Ce que Seurch ne fait pas#

Pas de traçage. Seurch ne vous suit pas sur le web ni d’une session à l’autre pour construire un profil.
Pas de publicité. Il n’y a pas de publicité, donc aucune incitation à vous profiler.
Pas de vente de données. Vos recherches ne sont pas un produit vendu à quiconque.

Comment vos requêtes sont traitées#

Les recherches s’exécutent côté serveur. Seurch parle aux fournisseurs amont (Brave, Mojeek, Marginalia et les autres) en votre nom, de sorte que ces fournisseurs ne voient pas votre navigateur ni votre IP, ils voient le serveur de Seurch.
Les clés API des fournisseurs n’atteignent jamais votre navigateur. Tous les appels amont se font sur le serveur.
Le proxy d’images (optionnel, dans Paramètres) achemine les miniatures via le serveur Seurch de sorte que les sites sources ne voient pas non plus votre navigateur.
Les résultats sont brièvement mis en cache sur le serveur pour rester rapides et réduire la charge sur les fournisseurs ; le cache est indexé sur la requête, pas sur vous.

Vos données#

Vos paramètres se synchronisent avec votre compte pour vous suivre sur tous vos appareils. Vous pouvez les exporter ou les supprimer.
Votre e-mail, si vous en ajoutez un, n’est utilisé que pour la réinitialisation du mot de passe ; voir Votre compte.

Où c’est hébergé#

Le service hébergé est exploité dans l’Union européenne sous le droit européen de la vie privée. Étant donné que le moteur de recherche est open source, n’importe qui peut auditer son fonctionnement, ou déployer sa propre copie et être le seul opérateur à jamais toucher ses données.

Configurer votre navigateur

Mon, 01 Jan 0001 00:00:00 +0000

Configurer votre navigateur#

Vous pouvez faire de Seurch le moteur de recherche qui se déclenche lorsque vous tapez dans la barre d’adresse ou le champ de recherche du navigateur. Cette page couvre tous les principaux navigateurs, notamment la façon de définir Seurch pour les fenêtres privées / incognito spécifiquement.

L’URL de recherche#

Lorsqu’un navigateur vous demande l’URL de votre moteur de recherche, utilisez :

https://seurch.eu/?q=%s

Remplacez seurch.eu par le nom d’hôte de votre propre instance si vous l’auto-hébergez.

Notes de production

Mon, 01 Jan 0001 00:00:00 +0000

Notes de production#

Quelques points importants à connaître lorsque vous déployez Seurch pour de vrais utilisateurs.

L’image#

Sert l’application avec gunicorn (2 workers) sur le port 8000.
Sert ses propres fichiers statiques via WhiteNoise, compressés et hachés ; vous n’avez donc pas besoin d’un serveur de fichiers statiques séparé ni d’un CDN.
Compile les catalogues de traduction et collecte les fichiers statiques au moment de la construction.
Applique les migrations de base de données au démarrage.

Proxy inverse et TLS#

Placez un proxy inverse avec terminaison TLS devant (Caddy, nginx, Traefik, …) et transmettez vers le port 8000. Définissez :