deedy5/ddgs

어떤 프로젝트인가요?

핵심 기능

• 01Bing, Brave, Google, DuckDuckGo 등의 여러 백엔드에서 텍스트 검색 결과를 모읍니다.
• 02유형별 필터를 제공하는 이미지, 동영상, 뉴스, 도서 검색 메서드를 지원합니다.
• 03URL에서 페이지 콘텐츠를 가져와 Markdown, 일반 텍스트, 서식 있는 텍스트, HTML 또는 원시 바이트로 추출합니다.
• 04CLI, FastAPI API 서버, 도구 기반 클라이언트를 위한 MCP 서버를 포함합니다.
• 05HTTP, HTTPS, SOCKS5 프록시와 타임아웃 설정을 지원합니다.

활용 사례

• 유료 검색 API 없이 Python 애플리케이션이나 LLM 에이전트에 웹 검색 기능을 추가합니다.
• 검색 및 페이지 추출 기능을 MCP 호환 AI 어시스턴트용 도구로 제공합니다.
• Docker를 지원하는 API 서버를 통해 내부 서비스용 검색 엔드포인트를 자체 호스팅합니다.
• 스크립트에서 명령줄로 검색 결과나 페이지 텍스트를 수집합니다.

빠른 시작

1. 1

   pip으로 기본 패키지를 설치합니다

   pip install -U ddgs
2. 2

   Python에서 텍스트 검색을 실행합니다

   python3 -c "from ddgs import DDGS; print(DDGS().text('python programming', max_results=5))"

사용 전 알아둘 점

• !검색 결과는 타사 검색 백엔드에서 가져오므로, 이용 가능 여부와 결과 품질은 해당 서비스에 따라 달라집니다.

토픽

자주 묻는 질문

ddgs은(는) 무엇인가요?

여러 웹 검색 백엔드를 조회해 텍스트, 이미지, 동영상, 뉴스, 도서 결과를 통합된 형식으로 반환하는 Python 메타검색 라이브러리입니다. DDGS는 여러 웹 검색 서비스를 대상으로 한 번의 쿼리를 실행하고 결과를 공통 형식으로 반환하는 Python 메타검색 라이브러리입니다. text() 메서드는 Bing, Brave, DuckDuckGo, Google, Mojeek, Startpage, Yandex, Yahoo, Wikipedia 등의 백엔드를 사용할 수 있으며, 기본 백엔드는 auto로 설정되어 있습니다.

ddgs은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

ddgs은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

ddgs은(는) 아직 유지보수되고 있나요?

6개월 이내 업데이트. ddgs의 마지막 커밋은 2026년 8월 26일입니다.

ddgs은(는) 어디에 사용할 수 있나요?

유료 검색 API 없이 Python 애플리케이션이나 LLM 에이전트에 웹 검색 기능을 추가합니다. 검색 및 페이지 추출 기능을 MCP 호환 AI 어시스턴트용 도구로 제공합니다. Docker를 지원하는 API 서버를 통해 내부 서비스용 검색 엔드포인트를 자체 호스팅합니다. 스크립트에서 명령줄로 검색 결과나 페이지 텍스트를 수집합니다.

ddgs는 어떻게 설치하나요?

pip으로 기본 패키지를 설치합니다: pip install -U ddgs Python에서 텍스트 검색을 실행합니다: python3 -c "from ddgs import DDGS; print(DDGS().text('python programming', max_results=5))"

ddgs은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/deedy5/ddgs