무료 검색: 실시간 Google 검색 결과에 무료로 액세스할 수 있는 API 도구

9.5K 00

일반 소개

Free-Search는 한즐라 자바이드가 개발하여 깃허브에서 호스팅하는 오픈소스 API 도구입니다. 주요 기능은 사용자 지정 검색 엔진을 통해 실시간 Google 검색 결과를 제공하고 웹 콘텐츠를 크롤링하여 구조화된 데이터를 반환하는 것입니다. 이 도구는 인터넷 데이터의 접근성을 개선하는 데 도움이 되는 AI 에이전트 및 LLM(대규모 언어 모델링) 애플리케이션을 위해 설계되었습니다. 사용자는 코드를 다운로드하여 로컬에 배포하기만 하면 무료로 사용할 수 있습니다. 이 프로젝트는 Python으로 개발되었으며 사용자 정의 검색 매개변수를 지원하므로 개발자 및 기술팀에 적합합니다. 현재 쉽게 체험할 수 있도록 공개 데모 예제가 제공되고 있습니다.

기능 목록

실시간 Google 검색을 지원하며 키워드를 입력하면 최신 결과를 반환합니다.
검색 결과 페이지를 자동으로 크롤링하여 각 페이지의 핵심 콘텐츠를 추출합니다.
소스, 링크 및 콘텐츠 스니펫을 포함한 구조화된 데이터를 반환합니다.
결과 수(1~5개)와 각 콘텐츠의 길이(100-5000자)를 조정할 수 있습니다.
사용자가 자유롭게 수정하고 최적화할 수 있는 오픈 소스 코드입니다.
공개 데모 예제가 제공되며 설치 없이 사용해 볼 수 있습니다.

도움말 사용

무료 검색은 개발자를 위한 API 도구로, 설치 및 사용하려면 특정 기술 기반이 필요합니다. 다음은 시작하는 데 도움이 되는 자세한 가이드입니다.

설치 방법

무료 검색을 사용하려면 GitHub에서 소스 코드를 다운로드하고 런타임 환경을 구성해야 합니다. 단계는 다음과 같습니다:

클론 창고
브라우저를 열고 다음 사이트를 방문하세요. https://github.com/HanzlaJavaid/Free-Search녹색을 클릭합니다. Code 버튼을 클릭하고 Download ZIP zip 아카이브를 다운로드하세요. 또는 명령줄에 입력하세요:

git clone https://github.com/HanzlaJavaid/Free-Search.git

다운로드가 완료되면 프로젝트 폴더로 이동합니다.

종속성 설치
이 프로젝트에는 Python 3.7 이상과 몇 가지 주요 라이브러리가 필요합니다. 명령줄에서 실행하세요:

pip install fastapi uvicorn pydantic playwright beautifulsoup4

그러면 FastAPI(API 구축), Uvicorn(서버 실행), Pydantic(데이터 유효성 검사), Playwright(웹 크롤링), BeautifulSoup4(HTML 파싱)가 설치됩니다.

Playwright 브라우저 설치
이 프로젝트는 다음 명령을 실행하여 설치하는 Playwright의 Chromium 브라우저를 사용합니다:

playwright install chromium

설치가 완료되면 도구가 웹 페이지를 제대로 크롤링할 수 있습니다.

서비스 시작
프로젝트 폴더에서 실행합니다:

xvfb-run python main.py

Linux 시스템에 그래픽 인터페이스가 없는 경우에는xvfb-run 가 필요하며, 윈도우 또는 맥 사용자는 그냥 python main.pyAPI 서비스는 시작 후 로컬에서 실행됩니다. 시작되면 API 서비스는 기본 포트 11235에서 로컬로 실행됩니다.

주요 기능 사용 방법

무료 검색의 핵심은 HTTP 요청을 통해 결과를 얻기 위해 실행되는 검색 API입니다. 작동 방식은 다음과 같습니다:

API 엔드포인트에 액세스하기
서비스가 시작되면 브라우저 또는 명령줄 도구를 열고 다음과 같이 액세스합니다. http://localhost:11235/search. 키워드와 같은 검색 매개변수를 제공해야 합니다.
검색 요청 보내기
활용 curl 또는 기타 도구를 사용하여 요청을 보낼 수 있습니다. 예시:

curl "http://localhost:11235/search?query=fastapi+tutorial&max_results=2&max_content=1000"

query검색어, 필수(예: "fastapi 튜토리얼").
max_results반환할 결과 수, 선택 사항, 기본값 3, 범위 1~5.
max_content각 결과의 콘텐츠 길이(선택 사항, 기본값 2000자, 범위 100-5000).
반환 결과 보기
예를 들어 API는 JSON 형식의 구조화된 데이터를 반환합니다:

[
{
"source": "fastapi官方文档",
"link": "https://fastapi.tiangolo.com/tutorial/",
"context": "FastAPI 是一个现代、快速的 Web 框架..."
},
{
"source": "教程博客",
"link": "https://example.com/fastapi-guide",
"context": "本教程介绍如何使用 FastAPI 构建 API..."
}
]

각 결과에는 소스 이름, 링크 및 추출된 콘텐츠가 포함됩니다.

주요 기능 작동

실시간 Google 검색
무료 검색은 사용자 지정 검색 엔진을 통해 Google에 연결하여 최신 검색 결과를 가져옵니다. 자체 크롤러를 개발할 필요 없이 키워드를 입력하고 사용하기만 하면 됩니다.
콘텐츠 크롤링 및 구조화된 출력
이 도구는 각 검색 결과 페이지를 자동으로 방문하여 주요 콘텐츠를 추출한 후 읽기 쉬운 형식으로 정리합니다. 이 기능은 모델에 직접 공급하여 처리할 수 있는 AI 애플리케이션에 특히 유용합니다.
사용자 지정 매개변수
다음과 같이 조정할 수 있습니다. max_results 노래로 응답 max_content를 사용하여 반환되는 데이터의 양과 세부 수준을 제어할 수 있습니다. 예를 들어 더 많은 결과를 얻으려면 다음을 사용할 수 있습니다:

curl "http://localhost:11235/search?query=python+学习&max_results=5"

퍼블릭 인스턴스 사용
로컬에 설치하지 않으려면 제공된 공식 데모 예제를 직접 방문하면 됩니다:https://freesearch.replit.app/. 브라우저에 다음과 같이 입력하기만 하면 됩니다. https://freesearch.replit.app/search?query=测试 주소를 입력하면 사용해 볼 수 있습니다.

주의

로컬에서 실행할 때는 Google 및 기타 웹 페이지에 액세스해야 하므로 인터넷이 열려 있는지 확인하세요.
Playwright 오류가 발생하면 Chromium이 올바르게 설치되었는지 확인하세요.
이 프로젝트는 오픈 소스이며 다음과 같이 수정할 수 있습니다. main.py 또는 기타 파일에 다른 검색 엔진 지원과 같은 새로운 기능을 추가합니다.

이 단계를 통해 무료 검색을 쉽게 배포하고 사용하여 실시간 검색 데이터를 얻을 수 있습니다.

애플리케이션 시나리오

AI 에이전트 개발
개발자는 무료 검색을 사용하여 실시간 웹 데이터를 수집하여 AI 에이전트의 지식 기반을 학습시키거나 향상시킬 수 있습니다.

장면 설명예를 들어, 최신 기술 뉴스에 대한 질문에 답변해야 하는 챗봇을 개발하는 경우, Free-Search는 봇이 정확한 답변을 제공할 수 있도록 관련 웹 콘텐츠를 제공할 수 있습니다.

LLM 데이터 입력
대규모 언어 모델에는 많은 외부 데이터 지원이 필요하며, 무료 검색을 데이터 소스로 사용할 수 있습니다.

장면 설명논문을 분석하는 모델을 구축 중인 경우, '머신 러닝' 키워드를 입력하면 무료 검색이 모델이 처리할 최신 논문의 링크와 초록을 반환합니다.

개별 연구 도구
학생이나 연구자는 웹에서 정보를 빠르게 수집하는 데 이 기능을 사용할 수 있습니다.

장면 설명논문을 작성할 때 '기후 변화 영향'을 입력하면 여러 소스에서 실시간 데이터를 가져와 검색 시간을 절약할 수 있습니다.

QA

무료 검색과 Google 검색의 차이점은 무엇인가요?
무료 검색은 Google 검색 결과를 자동으로 크롤링하여 구조화된 데이터를 반환하는 API 도구인 반면, Google 검색은 웹 인터페이스만 제공합니다.
퍼블릭 인스턴스와 로컬 배포의 차이점은 무엇인가요?
퍼블릭 인스턴스는 설치 없이 사용할 수 있지만 액세스 제한이 있을 수 있으며, 로컬 배포는 완전히 제어할 수 있고 기능에 맞게 사용자 지정할 수도 있습니다.
중국어 검색을 지원하나요?
예, 중국어 키워드를 입력하기만 하면 Google에서 일치하는 검색어를 찾을 수 있는 경우 API가 관련 결과를 반환합니다.