Pembungkus Python untuk Brave Search API.
Brave Search tidak melacak Anda atau kueri Anda, ini merupakan alternatif yang menjaga privasi selain Google Penelusuran. Ini menawarkan banyak titik akhir bagi pengembang untuk membangunnya. Modul ini adalah pembungkus untuk Brave Search API.
Repo ini sedang dalam pengembangan aktif, fungsinya dapat berubah. Jika Anda memiliki saran atau permintaan, silakan buka terbitan.
Untuk memulai, instal paket menggunakan pip:
pip install brave-search
Modul ini mendukung permintaan sinkron dan asinkron. Kunci API Brave Anda dapat diteruskan sebagai variabel lingkungan di bawah BRAVE_API_KEY
atau sebagai argumen ke kelas Brave.
from brave import Brave
brave = Brave ()
query = "cobalt mining"
num_results = 10
search_results = brave . search ( q = query , count = num_results )
Objek search_results
akan menyertakan semua data yang dikembalikan oleh Brave Search API. Anda dapat mengakses hasil Web
, News
, dan Video
dari titik akhir pencarian web sebagai berikut:
web_results = search_results . web_results
news_results = search_results . news_results
video_results = search_results . video_results
Modul ini juga mendukung permintaan asinkron:
from brave import AsyncBrave
brave = AsyncBrave ()
query = "cobalt mining"
num_results = 10
search_results = await brave . search ( q = query , count = num_results )
Untuk mengembalikan respons JSON mentah yang belum divalidasi melalui model pydantic, gunakan tanda raw
:
from brave import Brave
query = "George Orwell, 1984"
num_results = 10
search_results = brave . search ( q = query , raw = True )
Gunakan metode download_pdfs
untuk mengunduh semua PDF yang ditemukan di hasil pencarian. Metode ini mengembalikan daftar jalur file ke PDF yang diunduh. Anda dapat menggunakan Goggles untuk meningkatkan PDF dalam hasil pencarian Anda.
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 ()
Gunakan metode product_prices
untuk mendapatkan daftar harga serangkaian hasil pencarian. Metode ini mengembalikan daftar harga yang ditemukan di hasil pencarian. Jika tidak ada harga yang ditemukan, daftar kosong akan dikembalikan. Metode ini saat ini tidak mendukung konversi mata uang.
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)
Gunakan metode average_product_review_score
untuk mendapatkan skor ulasan rata-rata untuk serangkaian hasil penelusuran. Metode ini mengubah semua skor ulasan menjadi skala 100 poin.
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
Brave adalah mesin pencari canggih yang memungkinkan penggunaan goggles
untuk mengubah peringkat hasil pencarian agar sesuai dengan kasus penggunaan Anda. Goggles memungkinkan setiap individu—atau komunitas—untuk mengubah peringkat Brave Search dengan menggunakan serangkaian instruksi (aturan dan filter). Siapa pun dapat membuat, menerapkan, atau memperluas Goggle. Pada dasarnya Goggles bertindak sebagai pemeringkatan ulang khusus di atas indeks pencarian Brave.
Disini kami menggunakan goggle yang mengutamakan sumber akademis dan arsip.
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 )
Anda juga dapat menggunakan Goggles yang telah dikontribusikan secara langsung pada paket ini:
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 )
Paket ini menggunakan Puisi untuk manajemen ketergantungan. Untuk mulai mengembangkan di sini, Anda perlu menginstal Puisi
Setelah Anda menginstal Puisi di sistem Anda, jalankan saja:
make init
Periksa CONTRIBUTING.md untuk informasi tentang cara mengembangkan proyek ini.