brave api Télécharger - brave api Téléchargement du code source

brave api

Autre code source

v.0.2.0

Télécharger

API de recherche courageuse

Aperçu

Wrapper Python pour l'API Brave Search.

Brave Search ne vous suit ni vous ni vos requêtes, c'est une alternative à la recherche Google qui préserve la confidentialité. Il offre de nombreux points de terminaison sur lesquels les développeurs peuvent s'appuyer. Ce module est un wrapper pour l'API Brave Search.

Ce référentiel est en cours de développement actif, les fonctionnalités peuvent changer. Si vous avez des suggestions ou des demandes, veuillez ouvrir un problème.

Installation

Pour commencer, installez le package en utilisant pip :

pip install brave-search

Usage

Le module prend en charge les requêtes synchrones et asynchrones. Votre clé API Brave peut être transmise en tant que variable d'environnement sous BRAVE_API_KEY ou en tant qu'argument à la classe Brave.

 from brave import Brave

brave = Brave ()

query = "cobalt mining"
num_results = 10

search_results = brave . search ( q = query , count = num_results )

L'objet search_results inclura toutes les données renvoyées par l'API Brave Search. Vous pouvez accéder aux résultats Web , News et Video à partir du point de terminaison de recherche Web comme suit :

 web_results = search_results . web_results
news_results = search_results . news_results
video_results = search_results . video_results

Le module prend également en charge les requêtes asynchrones :

 from brave import AsyncBrave

brave = AsyncBrave ()

query = "cobalt mining"
num_results = 10

search_results = await brave . search ( q = query , count = num_results )

Pour renvoyer la réponse JSON brute qui n'a pas été validée via le modèle pydantic, utilisez l'indicateur raw :

 from brave import Brave

query = "George Orwell, 1984"
num_results = 10

search_results = brave . search ( q = query , raw = True )

Caractéristiques

Télécharger les PDF :

Utilisez la méthode download_pdfs pour télécharger tous les PDF trouvés dans les résultats de recherche. Cette méthode renvoie une liste de chemins d'accès aux fichiers PDF téléchargés. Vous pouvez utiliser Goggles pour améliorer les PDF dans vos résultats de recherche.

 from brave import Brave

brave = Brave ()

query = "cobalt mining"
num_results = 10

search_results = brave . search ( q = query , count = num_results )

search_results . download_pdfs ()

Données sur les prix agrégés

Utilisez la méthode product_prices pour obtenir une liste de prix pour un ensemble de résultats de recherche. Cette méthode renvoie une liste de prix trouvés dans les résultats de recherche. Si aucun prix n'est trouvé, une liste vide est renvoyée. Cette méthode ne prend actuellement pas en charge la conversion des devises.

    from brave import Brave

    brave = Brave ()

    query = "Blue Tack"
    num_results = 10
    country = "US"
    search_results = brave . search ( q = query , count = num_results , country = country )
    print ( search_results . product_prices ())
    # >> [6.28, 5.98, 4.99, 13.18, 6.59, 7.8, 5.56, 10.79, 5.02, 10.56, 16.95, 9.99, 23.59, 16.31, 11.96]
    print ( search_results . product_price_ranges ())
    # >> (4.99, 23.59)

Données d'examen agrégées

Utilisez la méthode average_product_review_score pour obtenir la note moyenne des avis pour un ensemble de résultats de recherche. Cette méthode convertit toutes les notes des évaluations sur une échelle de 100 points.

 from brave import Brave

brave = Brave ()

query = "Blue Tack"
num_results = 10
search_results = brave . search ( q = query , count = num_results )
print ( search_results . average_product_review_score ())
# >> 88.13333333333333

Lunettes

Brave est un moteur de recherche puissant qui permet d'utiliser des goggles pour reclasser vos résultats de recherche en fonction de votre cas d'utilisation. Goggles permet à tout individu – ou communauté de personnes – de modifier le classement de Brave Search en utilisant un ensemble d'instructions (règles et filtres). N'importe qui peut créer, appliquer ou étendre un Goggle. Essentiellement, Goggles agit comme un reclassement personnalisé en haut de l'index de recherche Brave.

Ici, nous utilisons un masque qui donne la priorité aux sources académiques et archivistiques.

 from brave import Brave

query = "cobalt mining"
goggle_url = "https://raw.githubusercontent.com/CSamuelAnderson/Brave-goggles/main/academic-and-archival.goggle"
num_results = 10
result_filter = "web" # must be comma separated string

search_results = brave . search ( q = query , goggles_id = goggle_url , count = num_results , result_filter = result_filter )

Vous pouvez également utiliser les Goggles qui ont été directement contribués à ce package :

 from brave import Brave
from brave . goggles import thought_leadership

query = "cobalt mining"
num_results = 10

search_results = brave . search ( q = query , goggles_id = thought_leadership , count = num_results )