Repolode
ranahaani

ranahaani/GNews

Google News 검색 결과를 JSON으로 반환하고, 전체 기사 추출도 지원하는 경량 Python 패키지입니다.

스타
1,018
포크
153
열린 이슈
0
마지막 커밋
11일 전

어떤 프로젝트인가요?

GNews는 Google News를 검색하는 Python 패키지입니다. 키워드, 주제, 위치 또는 사이트를 기준으로 Google News RSS 피드를 조회하고, 각 기사의 제목, 설명, 게시일, URL, 매체를 JSON으로 반환합니다. 언어, 국가, 기간, 날짜 범위, 제외할 웹사이트를 기준으로 검색 결과를 필터링할 수 있습니다.

검색 결과 외에도 선택적 fulltext extra를 통해 기사 전문을 가져올 수 있어, 개발자가 기사 본문을 직접 스크래핑할 필요가 없습니다. 또한 명령줄 인터페이스, JSON 및 CSV 내보내기, 검색 메서드의 비동기 버전도 제공합니다. 선택적 Playwright extra를 사용하면 Google News의 리디렉션 링크를 실제 기사 URL로 확인할 수 있습니다.

API 키를 전달해 활성화하는 선택적 SearchApi 백엔드는 ISO 날짜, 썸네일 등의 필드와 RSS 결과 제한을 넘는 페이지네이션을 제공합니다. GNews는 표준 requests 스타일의 프록시 설정을 사용해 트래픽을 라우팅할 수도 있습니다.

핵심 기능

  • 01키워드, 주제, 위치 또는 사이트로 Google News를 검색하고 결과를 JSON으로 반환합니다.
  • 02언어, 국가, 기간, 날짜 범위, 제외할 사이트를 기준으로 결과를 필터링합니다.
  • 03선택적 extra를 통해 기사 전문을 추출합니다.
  • 04JSON 출력을 지원하는 명령줄 인터페이스를 제공합니다.
  • 05결과를 JSON 및 CSV 파일로 내보냅니다.
  • 06모든 검색 메서드의 비동기 버전을 제공합니다.

활용 사례

  • 미디어 모니터링이나 분석을 위해 특정 주제의 뉴스 기사를 수집합니다.
  • Python으로 Google News 결과를 활용한 뉴스 피드나 대시보드를 구축합니다.
  • 감성 분석이나 NLP 실험에 사용할 뉴스 데이터셋을 준비합니다.
  • 명령줄에서 매일 주요 기사를 가져오는 스크립트를 작성합니다.

빠른 시작

  1. 1

    패키지를 설치합니다

    pip install gnews
  2. 2

    Python에서 키워드로 뉴스를 가져옵니다

    from gnews import GNews

사용 전 알아둘 점

  • 결과는 Google News RSS 피드에서 가져오므로 출력은 Google News의 동작에 따라 달라집니다.
  • 과도한 스크래핑은 IP 주소에 속도 제한을 초래할 수 있으며, README에서는 이를 위해 유료 프록시 서비스를 권장합니다.
  • 전체 기사 추출 및 URL 확인에는 선택적 extras(fulltext, playwright)와 Chromium 설치가 필요합니다.

토픽

자주 묻는 질문

GNews은(는) 무엇인가요?
Google News 검색 결과를 JSON으로 반환하고, 전체 기사 추출도 지원하는 경량 Python 패키지입니다. GNews는 Google News를 검색하는 Python 패키지입니다. 키워드, 주제, 위치 또는 사이트를 기준으로 Google News RSS 피드를 조회하고, 각 기사의 제목, 설명, 게시일, URL, 매체를 JSON으로 반환합니다. 언어, 국가, 기간, 날짜 범위, 제외할 웹사이트를 기준으로 검색 결과를 필터링할 수 있습니다.
GNews은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
GNews은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
GNews은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. GNews의 마지막 커밋은 2026년 10월 9일입니다.
GNews은(는) 어디에 사용할 수 있나요?
미디어 모니터링이나 분석을 위해 특정 주제의 뉴스 기사를 수집합니다. Python으로 Google News 결과를 활용한 뉴스 피드나 대시보드를 구축합니다. 감성 분석이나 NLP 실험에 사용할 뉴스 데이터셋을 준비합니다. 명령줄에서 매일 주요 기사를 가져오는 스크립트를 작성합니다.
GNews는 어떻게 설치하나요?
패키지를 설치합니다: pip install gnews Python에서 키워드로 뉴스를 가져옵니다: from gnews import GNews
GNews은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/ranahaani/GNews

요약은 프로젝트 README를 바탕으로 AI가 작성했습니다. GitHub 통계는 매일 갱신됩니다.

관련 프로젝트