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를 강화할 수 있습니다.
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
사용하여 사용 사례에 맞게 검색 결과의 순위를 다시 지정할 수 있는 강력한 검색 엔진입니다. 고글을 사용하면 모든 개인 또는 커뮤니티가 일련의 지침(규칙 및 필터)을 사용하여 Brave Search의 순위를 변경할 수 있습니다. 누구나 고글을 생성, 적용, 확장할 수 있습니다. 기본적으로 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를 설치해야 합니다.
시스템에 Poetry를 설치한 후 다음을 실행하세요.
make init
이 프로젝트를 개발하는 방법에 대한 정보는 CONTRIBUTING.md를 확인하세요.