Repolode
akfamily

akfamily/aktools

AKShare 금융 데이터 인터페이스를 HTTP API와 MCP 서버로 제공해 모든 언어나 Claude, Cursor 같은 AI 어시스턴트에서 사용할 수 있습니다.

스타
1,558
포크
250
열린 이슈
0
마지막 커밋
어제

이 페이지는 오픈소스 프로젝트 소개이며 투자 조언이 아닙니다. 거래와 투자는 손실이 발생할 수 있으니, 사용 전에 위험을 직접 판단하고 거주 지역의 법규를 따르세요.

어떤 프로젝트인가요?

AKTools는 1,000개가 넘는 금융 데이터 인터페이스를 제공하는 AKShare Python 라이브러리를 감싸 HTTP로 서비스합니다. 각 AKShare 함수는 /api/public/<interface name> 같은 경로에서 사용할 수 있으며, 쿼리 문자열 매개변수를 그대로 전달하면 JSON을 반환합니다. 결과를 CSV나 Excel 파일로 내보낼 수도 있습니다.

같은 서비스에 MCP 서버도 포함되어 있어 Claude Desktop, Claude Code, Cursor 같은 AI 어시스턴트가 인터페이스를 검색하고 매개변수를 확인하거나 자연어 요청으로 데이터를 가져올 수 있습니다. pip 명령 한 번으로 설치한 뒤 python -m aktools로 실행하면 되며, MCP 설정은 별도로 서버를 시작하지 않고 uvx로 실행할 수 있습니다.

프로젝트에는 기본 60초 결과 캐시, 서비스 보호를 위한 토큰 옵션, Gunicorn 및 Uvicorn 배포용 Dockerfile, FastAPI에서 제공하는 인터랙티브 API 문서가 포함되어 있습니다.

핵심 기능

  • 01모든 AKShare 데이터 인터페이스를 JSON을 반환하는 일반 HTTP GET 엔드포인트로 제공합니다.
  • 02Claude, Cursor 및 기타 MCP 호환 어시스턴트용 MCP 서버를 제공합니다.
  • 03_format 매개변수로 결과를 CSV 또는 Excel 파일로 다운로드합니다.
  • 04인터페이스를 나열하고 검색하며 각 인터페이스의 매개변수와 기본값을 표시합니다.
  • 05상위 서비스의 부하를 줄이기 위해 동일한 요청을 기본 60초 동안 캐시합니다.
  • 06선택적 액세스 토큰, 프록시 설정, 배포용 Dockerfile을 지원합니다.

활용 사례

  • Python, R 또는 MATLAB 분석 스크립트에서 A주 과거 주가 데이터를 가져옵니다.
  • AI 어시스턴트가 실시간 데이터를 조회해 주식이나 채권 관련 질문에 답하도록 합니다.
  • 스크래핑 코드를 작성하지 않고 금융 표를 Excel로 내보내 보고서에 활용합니다.
  • 토큰과 Docker를 사용해 팀에서 공유하는 내부 데이터 서비스를 운영합니다.

빠른 시작

  1. 1

    PyPI에서 AKTools를 설치합니다

    pip install aktools
  2. 2

    HTTP 서비스를 시작합니다

    python -m aktools
  3. 3

    브라우저에서 테스트 URL을 열어 거래 캘린더 데이터가 로드되는지 확인합니다

사용 전 알아둘 점

  • 데이터는 공개된 상위 웹사이트에서 가져오므로, 해당 사이트가 변경되거나 접근을 차단하면 일부 인터페이스가 작동하지 않을 수 있습니다.
  • Python 3.11 이상(64비트)이 필요합니다.

포함된 컬렉션

토픽

자주 묻는 질문

aktools은(는) 무엇인가요?
AKShare 금융 데이터 인터페이스를 HTTP API와 MCP 서버로 제공해 모든 언어나 Claude, Cursor 같은 AI 어시스턴트에서 사용할 수 있습니다. AKTools는 1,000개가 넘는 금융 데이터 인터페이스를 제공하는 AKShare Python 라이브러리를 감싸 HTTP로 서비스합니다. 각 AKShare 함수는 /api/public/<interface name> 같은 경로에서 사용할 수 있으며, 쿼리 문자열 매개변수를 그대로 전달하면 JSON을 반환합니다. 결과를 CSV나 Excel 파일로 내보낼 수도 있습니다.
aktools은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?
aktools은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.
aktools은(는) 아직 유지보수되고 있나요?
활발히 유지보수 중. aktools의 마지막 커밋은 2026년 11월 6일입니다.
aktools은(는) 어디에 사용할 수 있나요?
Python, R 또는 MATLAB 분석 스크립트에서 A주 과거 주가 데이터를 가져옵니다. AI 어시스턴트가 실시간 데이터를 조회해 주식이나 채권 관련 질문에 답하도록 합니다. 스크래핑 코드를 작성하지 않고 금융 표를 Excel로 내보내 보고서에 활용합니다. 토큰과 Docker를 사용해 팀에서 공유하는 내부 데이터 서비스를 운영합니다.
aktools는 어떻게 설치하나요?
PyPI에서 AKTools를 설치합니다: pip install aktools HTTP 서비스를 시작합니다: python -m aktools 브라우저에서 테스트 URL을 열어 거래 캘린더 데이터가 로드되는지 확인합니다
aktools은(는) 어디서 받을 수 있나요?
소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/akfamily/aktools

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

관련 프로젝트