brave api

Brave Search-API

Überblick

Python-Wrapper für die Brave Search API.

Brave Search verfolgt weder Sie noch Ihre Suchanfragen, sondern ist eine datenschutzfreundliche Alternative zur Google-Suche. Es bietet viele Endpunkte, auf denen Entwickler aufbauen können. Dieses Modul ist ein Wrapper für die Brave Search API.

Dieses Repo befindet sich in der aktiven Entwicklung, die Funktionalität kann sich ändern. Wenn Sie Vorschläge oder Wünsche haben, öffnen Sie bitte ein Problem.

Installation

Installieren Sie zunächst das Paket mit pip:

pip install brave-search

Verwendung

Das Modul unterstützt sowohl synchrone als auch asynchrone Anfragen. Ihr Brave-API-Schlüssel kann entweder als Umgebungsvariable unter BRAVE_API_KEY oder als Argument an die Brave-Klasse übergeben werden.

 from brave import Brave

brave = Brave ()

query = "cobalt mining"
num_results = 10

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

Das search_results -Objekt enthält alle von der Brave Search API zurückgegebenen Daten. Sie können über den Websearch-Endpunkt wie folgt auf Web , News und Video zugreifen:

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

Das Modul unterstützt auch asynchrone Anfragen:

 from brave import AsyncBrave

brave = AsyncBrave ()

query = "cobalt mining"
num_results = 10

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

Um die rohe JSON-Antwort zurückzugeben, die nicht durch das pydantische Modell validiert wurde, verwenden Sie das raw -Flag:

 from brave import Brave

query = "George Orwell, 1984"
num_results = 10

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

Merkmale

PDFs herunterladen:

Verwenden Sie die Methode download_pdfs , um alle in den Suchergebnissen gefundenen PDFs herunterzuladen. Diese Methode gibt eine Liste der Dateipfade zu den heruntergeladenen PDFs zurück. Mit Goggles können Sie PDFs in Ihren Suchergebnissen hervorheben.

 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 ()

Aggregierte Preisdaten

Verwenden Sie die Methode product_prices um eine Preisliste für eine Reihe von Suchergebnissen abzurufen. Diese Methode gibt eine Liste der in den Suchergebnissen gefundenen Preise zurück. Wenn keine Preise gefunden werden, wird eine leere Liste zurückgegeben. Diese Methode unterstützt derzeit keine Währungsumrechnung.

    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)

Aggregierte Überprüfungsdaten

Verwenden Sie die Methode average_product_review_score um die durchschnittliche Bewertungspunktzahl für eine Reihe von Suchergebnissen zu ermitteln. Diese Methode wandelt alle Bewertungsergebnisse in eine 100-Punkte-Skala um.

 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

Brille

Brave ist eine leistungsstarke Suchmaschine, die die Verwendung von goggles ermöglicht, um Ihre Suchergebnisse entsprechend Ihrem Anwendungsfall neu zu ordnen. Goggles ermöglichen es jedem Einzelnen – oder jeder Personengemeinschaft –, das Ranking von Brave Search mithilfe einer Reihe von Anweisungen (Regeln und Filter) zu ändern. Jeder kann eine Goggle erstellen, anwenden oder erweitern. Im Wesentlichen fungieren Goggles als benutzerdefiniertes Neuranking an der Spitze des Brave-Suchindex.

Hier verwenden wir eine Brille, die akademische und archivierte Quellen priorisiert.

 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 )

Sie können auch Schutzbrillen nutzen, die direkt zu diesem Paket beigetragen haben:

 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 )

Lokale Installation

Dieses Paket verwendet Poetry für das Abhängigkeitsmanagement. Um hier mit der Entwicklung zu beginnen, müssen Sie Poetry installieren

• Befolgen Sie die Anweisungen in den offiziellen Dokumenten

Sobald Sie Poetry auf Ihrem System installiert haben, führen Sie einfach Folgendes aus:

make init

Entwicklung

Informationen zur Entwicklung dieses Projekts finden Sie unter CONTRIBUTING.md.