본문으로 건너뛰기

[오픈소스 사용법] FinanceToolkit — 재무 비율 500개를 계산식까지 보면서 쓰기

· 바이브코드 운영팀

목차

같은 회사의 PER인데 사이트마다 숫자가 다르게 나온 적 있나요? 만든 사람은 마이크로소프트의 PER이 어떤 날 28.93, 32.05, 33.80, 34.4처럼 사이트마다 달랐다고 README에서 예로 들어요. 계산 방식이 서로 다르기 때문이에요. FinanceToolkit은 재무 지표 500개 이상을 아주 단순한 코드로 풀어 써서, 계산식을 직접 확인하면서 쓰게 해 주는 오픈소스 파이썬 툴킷이에요.

FinanceToolkit으로 그린 엔비디아 수익성 비율 그래프 6개(매출총이익률, 영업이익률, 순이익률, ROE, ROA, ROIC) 출처: JerBouma/FinanceToolkit README의 수익성 비율 예시 (엔비디아 2017~2025 회계연도, 그림 속 숫자는 README에 실린 예시 시점의 값이에요)

이럴 때 쓰세요

  • 기업의 수익성, 유동성, 효율성 같은 비율을 직접 계산하고 계산식을 확인하고 싶을 때
  • 여러 회사를 같은 기준으로 비교하고 싶을 때
  • 샤프 지수나 최대 낙폭 같은 위험 지표를 계산해 보고 싶을 때

주식뿐 아니라 옵션, 통화, 암호화폐, ETF, 펀드, 지수, 원자재, 경제 지표까지 다뤄요. 재무제표 기반 비율은 효율성, 유동성, 수익성, 지급 능력, 가치평가 다섯 묶음의 80개 이상이 들어 있어요.

준비물

  • Python과 pip
  • Financial Modeling Prep(FMP) API 키. 30년 이상의 재무제표를 가져오는 데 쓰는 키예요. 무료 플랜은 하루 250번 요청, 최근 5년 데이터, 미국 거래소 상장 기업만 쓸 수 있어요. 키는 FMP 사이트에서 받아요.

설치

pip install financetoolkit -U

처음 실행해 보기

파이썬에서 회사 티커를 넣어 Toolkit을 만들어요. 키 자리에는 내 키를 넣고, 코드나 GitHub에 올리지 않게 조심하세요.

from financetoolkit import Toolkit

companies = Toolkit(
    tickers=["AAPL", "MSFT"],
    api_key="YOUR_FMP_API_KEY",
)

수익성 비율을 한꺼번에 계산해 보려면 이렇게 해요. 결과는 표로 나와요.

# 수익성 비율 전체
profitability_ratios = companies.ratios.collect_profitability_ratios()

# 모든 비율을 한 번에
companies.ratios.collect_all_ratios()

collect_로 시작하는 함수는 한 묶음을 한 번에 돌려주고, get_으로 시작하는 함수는 비율 하나만 돌려줘요. 데이터는 처음 한 번만 받아서 이후 계산에 다시 써요.

자주 쓰는 기능

  • Discovery: 티커를 모를 때 스크리너로 후보를 찾아요. README의 예는 나스닥의 시가총액 1000억 달러 이상 반도체 기업을 찾는 코드예요.
  • Ratios: 재무 비율 80개 이상. 계산식이 함수 하나에 그대로 적혀 있어요.
  • 위험과 수익: 샤프 지수, 최대 낙폭, 변동성 같은 지표를 계산해요.
  • 포트폴리오: 효율적 투자선, 포트폴리오 성과 추적 등을 다뤄요.

각 모듈 문서의 맨 앞에는 "시작하기"가 있어요. 직접 만든 비율이나 내 데이터를 쓰는 방법도 거기에 나와요. 문서는 Finance Toolkit 문서에서 볼 수 있어요.

AI에게 시키기: MCP 서버

코드를 쓰지 않고 Claude, Copilot, Cursor, Windsurf 같은 MCP 클라이언트에서 500개 이상의 방법을 바로 부를 수도 있어요. README에 두 가지 연결 방법이 있어요.

  • 호스팅 서버: https://financetoolkit.jeroenbouma.com/mcp에 연결해요. 처음 쓸 때 OAuth 로그인이 진행돼요.
  • 내 컴퓨터: 아래 명령이 클라이언트 설정과 키 등록을 도와줘요.
uvx --from "financetoolkit[mcp]" financetoolkit-mcp-setup

수동 설정이 필요하면 저장소의 MCP 서버 문서를 보세요.

알아둘 점

  • 데이터는 기본으로 FMP에서 받고, FMP에서 못 받으면 야후 파이낸스로 자동 전환돼요. FMP만 쓰려면 Toolkit을 만들 때 enforce_source="FinancialModelingPrep"를 넣으세요.
  • 이 툴킷은 데이터를 가져오는 길을 열어 줄 뿐이에요. 데이터가 정확한지는 데이터 제공처의 몫이라고 만든 사람이 밝히고 있어요.
  • 분기 재무제표는 FMP 유료 플랜이 필요해요.
  • 무료 플랜의 하루 250번 요청은 여러 회사를 한꺼번에 돌리면 금방 쓸 수 있어요.

투자 안내

이 글은 도구 사용법을 소개하는 글이고 특정 종목이나 투자 방법을 권하는 글이 아니에요. 계산 결과로 하는 투자 판단과 그 결과는 본인의 몫이에요.

더 보기

확인한 날짜 2026-11-18 · 라이선스 MIT · 별 약 5.5천 개

글이 도움이 되었다면 좋아요를 눌러 주세요.