5 minutes pour configurer l’API Brave Search et donner à Clawdbot des capacités de recherche web en temps réel

Vous souhaitez que votre assistant IA privé Clawdbot dispose de capacités de recherche en ligne en temps réel ? Configurer l'API Brave Search est actuellement la solution la plus recommandée. Cet article vous guidera pas à pas à travers tout le processus, de la demande de clé API à la configuration de Clawdbot.

Valeur ajoutée : En lisant cet article, vous apprendrez à configurer l'API Brave Search pour Clawdbot, permettant à votre assistant IA d'effectuer des recherches sur Internet en temps réel pour obtenir les informations les plus récentes, dépassant ainsi les limites des dates de coupure de ses connaissances.

Qu'est-ce que l'API Brave Search ?

L'API Brave Search est une interface de recherche web de niveau entreprise fournie par Brave Software. Elle s'appuie sur un index de recherche construit de manière totalement indépendante, couvrant plus de 35 milliards de pages web.

Caractéristiques principales de l'API Brave Search

Caractéristique	Description	Valeur pour les développeurs
Index indépendant	Ne dépend pas de Google ou Bing	Résultats plus diversifiés et neutres
Mise à jour en temps réel	Plus de 100M de pages mises à jour quotidiennement	Accès aux informations de dernière minute
Sans publicité	Résultats API propres, sans publicités parasites	Utilisable directement pour alimenter des applications IA
Confidentialité d'abord	Ne suit pas le comportement des utilisateurs	Conforme aux exigences strictes de confidentialité
Support multi-terminaux	Web, News, Images, Vidéos	Répond à une multitude de scénarios de recherche

Pourquoi l'API Brave Search est idéale pour les applications IA

Alors que Google restreint l'accès à ses API de recherche généraliste et que Bing a considérablement augmenté ses tarifs avant de mettre fin à certains services API, Brave Search API est devenue la seule option indépendante et commercialement viable pour une recherche web globale.

Moteur de recherche	Statut de l'API	Adapté aux applications IA
Google	Pas d'API de recherche générale ouverte	Non
Bing	Service API arrêté en 2024	Non
Brave Search	API active et performante	Oui
DuckDuckGo	Pas d'API officielle	Non

🎯 Note technique : L'API Brave Search est devenue l'outil de recherche de prédilection pour des applications comme Claude MCP ou les pipelines RAG. Grâce à la plateforme APIYI (apiyi.com), vous pouvez intégrer rapidement diverses API d'outils, y compris Brave Search, à vos projets.

Détails des forfaits de tarification de l'API Brave Search

L'API Brave Search propose plusieurs paliers de tarification, allant du gratuit au niveau entreprise, afin de répondre à des besoins de différentes envergures.

Forfait gratuit de l'API Brave Search

Le forfait gratuit est idéal pour les utilisateurs individuels et les petits projets :

Élément du quota	Allocation gratuite
Volume mensuel de requêtes	2 000 appels
Limite QPS	1 requête / seconde
Points de terminaison supportés	Web Search
Cas d'utilisation	Projets personnels, test et développement

Comparaison des forfaits payants de l'API Brave Search

Forfait	Prix	QPS	Requêtes / mois	Fonctionnalités clés
Free	0 $	1	2 000	Recherche Web de base
Base	3 $/1k	20	20M	Goggles, Actualités, Vidéo
Base AI	5 $/1k	20	20M	Licence pour applications IA
Pro AI	9 $/1k	50	Illimité	Fonctions complètes, support prioritaire
AI Grounding	4 $/1k + 5 $/M de Tokens	–	–	Recherche multi-tours, planification du raisonnement

💡 Conseil d'optimisation des coûts : Pour un usage personnel de Clawdbot, les 2 000 requêtes mensuelles du forfait gratuit sont généralement suffisantes. Si votre volume de recherche est plus important, vous pouvez opter pour des solutions de facturation plus flexibles via la plateforme APIYI (apiyi.com).

Qu'est-ce que Clawdbot ?

Clawdbot est un assistant IA personnel open-source qui s'exécute sur votre propre appareil et interagit avec vous via vos canaux de communication habituels.

Atouts majeurs de Clawdbot

Avantage	Description
Support multicanal	WhatsApp, Telegram, Discord, Slack, Signal, iMessage, etc.
Exécution locale	Vos données ne quittent jamais votre appareil, garantissant une confidentialité totale.
Hautement personnalisable	Supporte l'intégration de "Skills" (compétences) et d'outils personnalisés.
Open-source et gratuit	Code source complet disponible sur GitHub avec une communauté active.

Architecture de Clawdbot et intégration de Brave Search

Message utilisateur → Passerelle Clawdbot → Traitement par le grand modèle de langage
                ↓
        Besoin d'une recherche en ligne ?
                ↓
        Appel à l'API Brave Search
                ↓
        Retour des résultats → Intégration par le grand modèle de langage → Réponse à l'utilisateur

Clawdbot utilise Brave Search comme fournisseur web_search par défaut. Cela signifie qu'une fois la configuration terminée, l'assistant IA peut effectuer automatiquement des recherches sur Internet pour obtenir des informations actualisées si nécessaire.

Étapes pour obtenir une clé API Brave Search

Étape 1 : S'inscrire sur la plateforme API de Brave Search

Visitez le site officiel de l'API Brave Search : brave.com/search/api/

Cliquez sur les boutons « Get Started » ou « Try for free » et inscrivez-vous avec votre adresse e-mail.

Étape 2 : Accéder au tableau de bord (API Dashboard)

Une fois l'inscription terminée, connectez-vous au tableau de bord : api-dashboard.search.brave.com

Étape 3 : Choisir un forfait

Dans la page « Plans », choisissez le forfait qui vous convient :

Cas d'utilisation	Forfait recommandé	Pourquoi ?
Clawdbot personnel	Free	2 000 requêtes/mois suffisent pour un usage quotidien.
Collaboration d'équipe	Base AI	Supporte l'autorisation pour les applications IA.
Produit commercial	Pro AI	Requêtes illimitées et fonctionnalités complètes.

Remarque importante : Pour la fonction web_search de Clawdbot, vous devez choisir le forfait Data for Search, et non le forfait « Data for AI ».

Étape 4 : Générer la clé API

Dans le tableau de bord, trouvez la section « API Keys ».
Cliquez sur « Create API Key ».
Donnez un nom à votre clé (par exemple : clawdbot-search).
Copiez la clé API générée et conservez-la en lieu sûr.

sk-brave-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

⚠️ Rappel de sécurité : La clé API ne s'affiche qu'une seule fois. Veuillez la copier et la sauvegarder immédiatement. Si vous la perdez, vous devrez en générer une nouvelle.

Étapes détaillées pour configurer l'API Brave Search dans Clawdbot

Méthode 1 : Configuration interactive (recommandée)

C'est la méthode la plus simple : Clawdbot vous guidera à travers toutes les étapes du paramétrage.

clawdbot configure --section web

Une fois la commande exécutée, suivez les instructions :

Choisissez d'activer la fonction web_search.
Collez votre clé API Brave Search.
Confirmez la fin de la configuration.

Méthode 2 : Utilisation du fichier de configuration

Si vous êtes à l'aise avec la ligne de commande, vous pouvez éditer directement le fichier de configuration de Clawdbot.

Emplacement du fichier :

macOS/Linux : ~/.config/clawdbot/config.yaml
Windows : %APPDATA%\clawdbot\config.yaml

Ajouter la configuration Brave Search :

# Fichier de configuration Clawdbot
web_search:
  enabled: true
  provider: brave
  api_key: "sk-brave-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

  # Optionnel : paramètres de recherche
  options:
    country: "FR"        # Région des résultats de recherche
    search_lang: "fr"    # Langue de recherche
    count: 10            # Nombre de résultats retournés

Méthode 3 : Utilisation des variables d'environnement

Idéal pour un déploiement Docker ou un environnement CI/CD.

# Définir la variable d'environnement
export BRAVE_API_KEY="sk-brave-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

# Démarrer Clawdbot
clawdbot start

Exemple Docker Compose :

version: '3.8'
services:
  clawdbot:
    image: clawdbot/clawdbot:latest
    environment:
      - BRAVE_API_KEY=sk-brave-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
    volumes:
      - ./config:/app/config

🚀 Démarrage rapide : Une fois configuré, vous pouvez tester en envoyant une question nécessitant une recherche web à Clawdbot via n'importe quel canal connecté. Si vous devez également configurer des API de grands modèles de langage, nous vous recommandons d'utiliser la plateforme APIYI (apiyi.com) pour obtenir une interface unifiée.

Configuration avancée de l'API Brave Search dans Clawdbot

Détails des paramètres de recherche

Clawdbot permet de personnaliser plusieurs paramètres de Brave Search :

Paramètre	Type	Description	Valeur d'exemple
`country`	string	Préférence régionale pour les résultats	`FR`, `US`, `CA`, `BE`
`search_lang`	string	Langue de la requête de recherche	`fr`, `en`, `de`
`ui_lang`	string	Langue de l'interface	`fr-FR`, `en-US`
`count`	int	Nombre de résultats retournés	1-20
`offset`	int	Décalage des résultats (offset)	0-9
`safesearch`	string	Niveau de recherche sécurisée	`off`, `moderate`, `strict`
`freshness`	string	Filtre temporel	`pd` (24h), `pw` (semaine), `pm` (mois)

Exemple de configuration complète

web_search:
  enabled: true
  provider: brave
  api_key: "sk-brave-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

  options:
    # Paramètres de base
    country: "FR"
    search_lang: "fr"
    count: 10

    # Filtrage de contenu
    safesearch: "moderate"

    # Options avancées
    text_decorations: true    # Activer la mise en évidence du texte
    extra_snippets: true      # Obtenir des extraits de contexte supplémentaires

Règles de recherche personnalisées Goggles

La fonctionnalité Goggles, exclusive à Brave Search, vous permet de personnaliser les règles de tri et de filtrage des résultats de recherche.

web_search:
  provider: brave
  api_key: "votre-cle-api"
  options:
    goggles_id: "votre-id-goggles"  # Appliquer un Goggles personnalisé

Cas d'utilisation courants de Goggles :

Exclure des noms de domaine spécifiques.
Prioriser l'affichage des sites de documentation technique.
Filtrer les "fermes de contenus" de basse qualité.

Exemples d'utilisation réelle de Clawdbot Brave Search

Exemple 1 : Rechercher des informations récentes

Question de l'utilisateur :

Quelles sont les nouvelles annonces d'OpenAI aujourd'hui ?

Actions de Clawdbot :

Identifie la nécessité de se connecter au web pour obtenir les dernières informations.
Appelle l'API Brave Search pour rechercher les actualités pertinentes.
Synthétise les résultats de recherche pour générer une réponse.

Exemple 2 : Recherche de questions techniques

Question de l'utilisateur :

Quelles sont les nouvelles fonctionnalités de Python 3.12 ?

Actions de Clawdbot :

Recherche la documentation officielle et les articles techniques sur Python 3.12.
Extrait les informations clés sur les fonctionnalités.
Répond à l'utilisateur de manière structurée.

Exemple 3 : Scénario de recherche en plusieurs étapes

Grâce au mode AI Grounding, Clawdbot peut effectuer plusieurs cycles de recherche et de raisonnement :

Compare les performances de Claude 3.5 Sonnet et de GPT-4o en matière de génération de code.

Clawdbot va :

Rechercher les évaluations des capacités de codage de Claude 3.5 Sonnet.
Rechercher les évaluations des capacités de codage de GPT-4o.
Rechercher des articles comparant les deux modèles.
Fournir une conclusion après une analyse complète.

🎯 Conseil de modèle : Clawdbot prend en charge plusieurs backends de modèles d'IA. Si vous avez besoin d'utiliser simultanément plusieurs modèles comme Claude ou GPT-4o, vous pouvez passer par APIYI (apiyi.com) pour obtenir une interface API unifiée, facilitant ainsi le basculement flexible et le contrôle des coûts.

Surveillance et gestion des quotas de l'API Brave Search

Consulter l'utilisation de l'API

Connectez-vous au tableau de bord de l'API Brave Search : api-dashboard.search.brave.com

Sur la page "Usage", vous pouvez voir :

Le nombre de requêtes utilisées durant le mois en cours.
Le quota restant.
Les tendances historiques d'utilisation.

Consulter les statistiques de recherche dans Clawdbot

clawdbot stats --module web_search

Exemple de sortie :

Web Search Statistics (Last 30 days)
------------------------------------
Total searches:     1,247
Successful:         1,235 (99.0%)
Failed:             12 (1.0%)
Avg response time:  342ms

Configuration des alertes de quota

Dans le tableau de bord de l'API Brave, vous pouvez configurer :

Une alerte par e-mail lorsque l'utilisation atteint 80 %.
Un arrêt automatique lorsque le quota est épuisé (pour éviter la facturation excédentaire).

FAQ sur la configuration de Brave Search API pour Clawdbot

Q1 : Que faire si la fonction de recherche ne fonctionne pas après la configuration ?

Vérifiez les points suivants :

Confirmez la clé API : Copiez et collez à nouveau la clé en évitant les espaces superflus.
Vérifiez le type de forfait : Il doit s'agir du forfait « Data for Search » et non « Data for AI ».
Validez la connexion réseau : Assurez-vous que le serveur peut accéder à api.search.brave.com.
Consultez les logs : Exécutez clawdbot logs --module web_search pour voir les messages d'erreur.

Si le problème persiste, vous pouvez obtenir un support technique et des solutions alternatives via APIYI (apiyi.com).

Q2 : Que faire si le quota gratuit est épuisé ?

Plusieurs options s'offrent à vous :

Attendre la réinitialisation mensuelle : Le quota gratuit est réinitialisé le 1er de chaque mois.
Passer à un forfait payant : Le forfait Base AI commence à 5 $ pour 1 000 requêtes.
Optimiser la stratégie de recherche : Configurez Clawdbot pour qu'il n'appelle la recherche que lorsque c'est strictement nécessaire.
Utiliser le cache : Réutilisez les résultats précédents pour des requêtes identiques.

Vous pouvez passer par la plateforme APIYI (apiyi.com) pour obtenir des plans de facturation plus flexibles, avec un paiement à l'usage réel.

Q3 : Comment améliorer la qualité des résultats de recherche ?

Voici quelques astuces d'optimisation :

Spécifier la région et la langue : Définissez country et search_lang selon vos besoins.
Activer extra_snippets : Pour obtenir des résumés de contenu plus riches.
Utiliser Goggles : Personnalisez les règles de classement des résultats.
Régler la fraîcheur (freshness) : Utilisez des filtres temporels pour les contenus nécessitant une actualité immédiate.

Q4 : Quelle est la différence entre Brave Search API et les autres API de recherche ?

Comparaison	Brave Search	SerpAPI	Tavily
Source de l'index	Index indépendant	Scraping Google	Index indépendant
Quota gratuit	2 000 requêtes/mois	100 requêtes/mois	1 000 requêtes/mois
Optimisation IA	Mode AI Grounding	Aucune	Conçu pour l'IA
Prix	3-9 $ / 1k requêtes	À partir de 50 $ / mois	5 $ / 1k requêtes

Brave Search se distingue par son excellent rapport qualité-prix et son indépendance.

Meilleures pratiques pour l'intégration de Brave Search API avec Clawdbot

Suggestions d'optimisation des performances

Point d'optimisation	Suggestion	Effet
Nombre de résultats	Régler `count: 5-10`	Réduit le temps de réponse
Cache des requêtes	Activer le cache local	Économise le quota API
Contrôle de la concurrence	Respecter les limites QPS	Évite les rejets de requêtes
Tentatives d'erreur	Implémenter un backoff exponentiel	Améliore la stabilité

Conseils de sécurité

Ne codez jamais la clé API en dur : Utilisez des variables d'environnement ou des fichiers de configuration sécurisés.
Rotation régulière des clés : Changez de clé tous les 3 à 6 mois.
Surveillez l'utilisation anormale : Configurez des alertes de consommation.
Limitez la portée d'accès : N'autorisez que les services qui en ont réellement besoin.

Stratégie de contrôle des coûts

web_search:
  enabled: true
  provider: brave

  # Contrôle des coûts
  rate_limit:
    max_per_minute: 10      # Maximum 10 recherches par minute
    max_per_day: 100        # Maximum 100 recherches par jour

  cache:
    enabled: true
    ttl: 3600               # Cache pendant 1 heure

Résumé de la configuration de Brave Search API pour Clawdbot

Grâce à cet article, vous avez appris :

La valeur fondamentale de l'API Brave Search : indexation indépendante, absence de publicité et priorité à la vie privée.
Choix du forfait de tarification : le forfait gratuit est suffisant pour les utilisateurs individuels, avec une mise à niveau possible selon les besoins des projets commerciaux.
Trois méthodes de configuration : interactive, via un fichier de configuration ou par variables d'environnement.
Optimisation des paramètres avancés : région, langue et règles personnalisées Goggles.
Bonnes pratiques : optimisation des performances, conseils de sécurité et contrôle des coûts.

L'API Brave Search permet à Clawdbot de bénéficier d'une capacité de recherche en ligne en temps réel, dépassant ainsi les limites de la date de coupure des connaissances des modèles IA. En l'associant à des grands modèles de langage puissants comme Claude ou GPT-4o, votre assistant IA personnel devient bien plus utile au quotidien.

Nous vous recommandons d'utiliser APIYI (apiyi.com) pour obtenir rapidement les API de modèles IA et les API d'outils nécessaires. C'est une solution tout-en-un pour répondre à tous les besoins en interfaces de votre Clawdbot.

Références

Documentation officielle de l'API Brave Search : Spécifications de l'interface API et description des paramètres.
- Lien : brave.com/search/api/
Documentation officielle de Clawdbot : Guide de configuration de Brave Search.
- Lien : docs.clawd.bot/brave-search
GitHub de Clawdbot : Code source ouvert et tickets (Issues).
- Lien : github.com/clawdbot/clawdbot
Présentation de Brave AI Grounding : Explication des fonctionnalités de recherche IA avancées.
- Lien : brave.com/blog/ai-grounding/

📝 Auteur : Équipe APIYI
📅 Date de mise à jour : Janvier 2026
🔗 Échanges techniques : Visitez APIYI (apiyi.com) pour obtenir plus de ressources de développement IA.