brave api下載 - brave api源碼下載

brave api

其他源碼

v.0.2.0

下載

勇敢的搜尋API

概述

Brave Search API 的 Python 包裝器。

Brave Search 不會追蹤您或您的查詢，它是 Google 搜尋的隱私保護替代方案。它為開發人員提供了許多可以在其上進行建置的端點。該模組是 Brave Search API 的包裝器。

該存儲庫正在積極開發中，功能可能會發生變化。如果您有任何建議或要求，請提出問題。

安裝

首先，使用 pip 安裝軟體包：

pip install brave-search

用法

此模組支援同步和非同步請求。您的 Brave API 金鑰可以作為BRAVE_API_KEY下的環境變數傳遞，也可以作為 Brave 類別的參數傳遞。

 from brave import Brave

brave = Brave ()

query = "cobalt mining"
num_results = 10

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

search_results物件將包含 Brave Search API 傳回的所有資料。您可以從網路搜尋端點存取Web 、 News和Video結果，如下所示：

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

該模組還支援非同步請求：

 from brave import AsyncBrave

brave = AsyncBrave ()

query = "cobalt mining"
num_results = 10

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

若要傳回尚未通過 pydantic 模型驗證的原始 JSON 回應，請使用raw標誌：

 from brave import Brave

query = "George Orwell, 1984"
num_results = 10

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

特徵

下載 PDF：

使用download_pdfs方法下載搜尋結果中找到的所有 PDF。此方法傳回已下載 PDF 的檔案路徑清單。您可以使用 Goggles 來增強搜尋結果中的 PDF。

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

綜合價格數據

使用product_prices方法取得一組搜尋結果的價格清單。此方法傳回在搜尋結果中找到的價格清單。如果未找到價格，則傳回空列表。該方法目前不支援貨幣兌換。

    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)

匯總評論數據

使用average_product_review_score方法取得一組搜尋結果的平均評論分數。此方法將所有評論分數轉換為 100 分制。

 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 是一個功能強大的搜尋引擎，允許使用goggles對搜尋結果重新排名以滿足您的用例。 Goggles 讓任何個人或社群能夠透過使用一組指示（規則和篩選器）來改變 Brave Search 的排名。任何人都可以創建、應用或擴展 Goggle。本質上，Goggles 充當 Brave 搜尋索引之上的自訂重新排名。

在這裡，我們使用優先考慮學術和檔案來源的護目鏡。

 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 )

您也可以使用直接貢獻給此套件的 Goggles：

 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 )