krx-news-client

CI Python License LinkedIn

한국 주식시장의 뉴스·공시를 4개 매체에서 모아 하나의 스키마로 내주는 Python 클라이언트 라이브러리 — DART, 한국경제, 더벨, 토스증권.

매체마다 HTML 구조도 갱신 주기도 제각각이라, 뉴스를 쓰려는 쪽이 매번 크롤러를 다시 짜게 된다. 그 일을 한 번만 하려고 만들었다. kiwoom-client와 같은 성격의 라이브러리다 — 서버를 띄우지 않고, 호출한 프로세스 안에서 그때그때 매체에 직접 요청해 정규화된 결과를 돌려준다.

설치

pip install krx-news-client

빠른 시작

import asyncio
from krx_news_client import TossScraper

async def main():
    scraper = TossScraper()
    try:
        articles = await scraper.scrape_news()
        for article in articles[:5]:
            print(article.title, article.published_at)
    finally:
        await scraper.close()

asyncio.run(main())

DART 공시는 API 키가 필요하다:

from krx_news_client import DartScraper

scraper = DartScraper(api_key="...")
disclosures = await scraper.scrape_disclosures()

더 많은 예제는 examples/ 참고.

수집 소스

소스 데이터 수집 방식
DART (dart.fss.or.kr) 공시 공식 Open API (키 필요)
한국경제 (hankyung.com) 뉴스 HTML 크롤링
더벨 (thebell.co.kr) 뉴스 HTML 크롤링
토스증권 (tossinvest.com) 뉴스 비공식 내부 API

수집한 기사는 매체와 무관하게 NewsArticle, 공시는 Disclosure 한 벌로 정규화한다. 소스가 늘어도 호출 코드는 그대로다.

응답 필드

NewsArticle

필드 설명
id 고유 ID ({source}:{url의 md5 12자})
source 소스 (dart/hankyung/thebell/toss)
category disclosure/market/stock/economy/analysis/breaking
title 제목
url 원문 링크
content 본문 (있는 경우)
summary 요약
tickers 관련 종목코드 목록 (e.g. 005930)
author 작성자·언론사
published_at 발행 시각
collected_at 수집 시각

Disclosure

필드 설명
id 고유 ID
source 소스
title 공시 제목
url 원문 링크
company 회사명
ticker 종목코드
disclosure_type 공시 유형
published_at 공시 시각
collected_at 수집 시각

구조

src/krx_news_client/
├── models/schemas.py   # NewsArticle · Disclosure · NewsCategory · NewsSource
└── scrapers/           # base(재시도·간격·UA 순환) + 소스 4개

httpx · BeautifulSoup4 · pydantic 만으로 돌아간다 — 상시 구동 서버, DB, 캐시 계층이 없다. 호출한 쪽이 원하는 만큼만 부르고, 저장이 필요하면 호출하는 쪽에서 알아서 한다 (예: quant-airflow가 이 라이브러리로 수집해 TimescaleDB에 적재).

라이선스

Apache License 2.0 — 전문은 LICENSE 참조.

⭐ 도움이 되셨다면

이 프로젝트가 유용했다면 우측 상단 ⭐ Star 를 눌러주세요. 검색·추천 노출이 올라가 더 많은 분들이 찾을 수 있습니다.

관련 프로젝트 — 오픈소스 퀀트 스택

한국·미국 주식과 암호화폐를 아우르는 오픈소스 스택입니다. 각 저장소는 독립적으로 쓸 수 있습니다.

축 프로젝트 설명
🇰🇷 한국 주식 kiwoom-client 키움증권 REST API Python 라이브러리 — 국내주식 엔드포인트 전수·실시간 WebSocket, sync + async (pip install kiwoom-client)
🇰🇷 한국 주식 krx-fundamentals-api 국내 기업 펀더멘탈 REST API — 재무제표·투자지표·배당·종목 스크리닝 (DART + KRX + 네이버)
🇰🇷 한국 주식 quant-airflow 시세·수급·실적을 TimescaleDB 로 수집하는 Airflow 파이프라인 — 상장폐지 종목까지 담아 생존편향을 막는다
🇰🇷 한국 주식 kr-quant 코스피·코스닥 알파 리서치 — walk-forward·랜덤 음성대조·purged CV·Deflated Sharpe 를 CI 가드레일로 강제
🇺🇸 미국 주식 portfolio-research 미국주식 팩터 엔진 — point-in-time·생존편향 보정 데이터 위에서 walk-forward 를 Deflated Sharpe·PBO 로 게이팅 (+ ETF 전술배분 TAA — 9개 사전등록, 채택 0)
🇺🇸 미국 주식 automated-stock-trading-systems Bensdorp 의 7개 비상관 트레이딩 시스템 백테스터 (교육용 재구현)
₿ 암호화폐 quantbox-engine 암호화폐 선물 백테스트·실행 엔진 — 룩어헤드 0, 백테스트↔실거래 일체화

만든 사람

채영환 (Younghwan Chae) · GitHub @younghwan91 · LinkedIn

전체 오픈소스 퀀트 스택은 프로필에서 한눈에 볼 수 있습니다.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Latest release

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for chyohw from gravatar.com chyohw

Credits

Author: Younghwan Chae

License

Apache-2.0

Requires

Python >=3.11

Provides Extra

dev

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

krx_news_client-0.1.0.tar.gz (47.2 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

krx_news_client-0.1.0-py3-none-any.whl (19.2 kB view details)

Uploaded Python 3

File details

Details for the file krx_news_client-0.1.0.tar.gz.

File metadata

  • Download URL: krx_news_client-0.1.0.tar.gz
  • Upload date:
  • Size: 47.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for krx_news_client-0.1.0.tar.gz
Algorithm Hash digest
SHA256 09b12d2e720a451dd71637422fb049429f8ffbd55fd3af8a022b644fe1128683
MD5 2a767d00fcade0fccf620d1ecc7eeaa8
BLAKE2b-256 b4425e2482bf3229b6ea02387083b215b6d45a7d6772195006c3e3903c153892

See more details on using hashes here.

Provenance

The following attestation bundles were made for krx_news_client-0.1.0.tar.gz:

Publisher: publish.yml on younghwan91/krx-news-client

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file krx_news_client-0.1.0-py3-none-any.whl.

File metadata

File hashes

Hashes for krx_news_client-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 a370bc1583f2fe6fb7fd79e9ef1695e0ed65a9a5fb91679ff17180f498132110
MD5 b098d4481e9925811abbf561b9975638
BLAKE2b-256 184a107f2d3384332df2ca634abd9f681d638d78c5277e00e3e565ba5283b039

See more details on using hashes here.

Provenance

The following attestation bundles were made for krx_news_client-0.1.0-py3-none-any.whl:

Publisher: publish.yml on younghwan91/krx-news-client

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page