Wrapper Python สำหรับ Brave Search API
Brave Search จะไม่ติดตามคุณหรือคำถามของคุณ แต่เป็นทางเลือกในการรักษาความเป็นส่วนตัวแทน Google Search มันมีจุดสิ้นสุดมากมายสำหรับนักพัฒนาเพื่อสร้างต่อยอด โมดูลนี้เป็น wrapper สำหรับ 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 )
หากต้องการส่งคืนการตอบสนอง JSON แบบดิบที่ไม่ได้รับการตรวจสอบผ่านโมเดล pydantic ให้ใช้แฟล็ก raw
:
from brave import Brave
query = "George Orwell, 1984"
num_results = 10
search_results = brave . search ( q = query , raw = True )
ใช้วิธี 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 )
แพ็คเกจนี้ใช้บทกวีเพื่อการจัดการการพึ่งพา หากต้องการเริ่มพัฒนาที่นี่ คุณต้องติดตั้ง Poetry
เมื่อคุณติดตั้ง Poetry บนระบบของคุณแล้ว ให้รัน:
make init
ตรวจสอบ CONTRIBUTING.md เพื่อดูข้อมูลเกี่ยวกับวิธีการพัฒนาโครงการนี้