simonlin1212/Vibe-Research

A주/미국주/홍콩주를 커버하는 개인 AI 투자 리서치 대시보드 — 데이터를 연결하고, AI는 당신이 직접 붙인다

완성 앱맘대로 써도 됨 · MITAI 에이전트TypeScript난이도
543+384이번 주0
104포크3이슈
데모·홈페이지 열기viberesearch.wiki

중간맛 분석

React 19 + FastAPI 풀스택 앱으로, 백엔드(:8900)와 프론트엔드(:5899)를 로컬에서 직접 실행합니다. A주 40개 엔드포인트(a-stock-data), 미국·홍콩주 18개 엔드포인트(global-stock-data), 12개 섹터 108개 RSS 뉴스 소스가 레포에 번들로 포함되어 있어 별도 데이터 계약 없이 바로 사용 가능합니다. 키 방식(OpenAI 호환 다중 모델), 구독 방식(Claude Code·Codex 등), MCP 서버 방식 세 가지로 AI를 연결할 수 있으며, 보유 종목·관심 종목· 키는 모두 로컬에만 저장됩니다. npm install && npm run devuvicorn 두 명령으로 즉시 실행 가능합니다.

이런 레포예요

이럴 때 쓰면 좋아요

  • 매일 아침 A주·미국주 시황을 한 화면에서 확인하고 내가 쓰는 AI로 자동 복기하고 싶을 때
  • 개인 보유 종목의 재무·수급·공시 데이터를 빠르게 조회하고 AI에게 5차원 분석을 맡기고 싶을 때
  • Claude Code 같은 에이전트를 MCP 서버로 연결해 데이터 툴을 직접 호출하는 자체 투자 리서치 에이전트를 구축할 때

핵심 기능

A주·미국주·홍콩주 다중 시장 데이터를 레포에 번들로 포함 — 별도 데이터 계약 없이 즉시 사용API·CLI 구독·MCP 세 가지 방식으로 사용자 자신의 AI 모델을 연결하는 플러그인형 AI 인터페이스보유 종목·관심 종목·API 키 등 민감 정보를 모두 로컬에만 저장하는 프라이버시 우선 설계

대안 대비 차별점

AI 분석 로직을 내장하지 않고 사용자가 직접 모델을 주입하는 구조로, MCP 서버를 통한 에이전트-퍼스트 설계와 세 가지 데이터 소스 번들을 동시에 제공하는 점이 유사 투자 대시보드와 다르다.

준비물

  • Python 3.10 이상
  • Node.js (npm 사용 가능)
  • 선택: Claude Code·Codex 등 AI CLI 또는 OpenAI 호환 API 키 (AI 연동 시)
  • 선택: pip install mootdx requests pandas stockstats (A주 전체 엔드포인트 사용 시)

바로 시작하기

  1. 레포 클론
git clone https://github.com/simonlin1212/Vibe-Research.git
cd Vibe-Research
  1. 백엔드 가상환경 생성 및 의존성 설치
cd backend && python3 -m venv .venv && .venv/bin/pip install -r requirements.txt
  1. 백엔드 서버 실행 (포트 8900)
.venv/bin/python -m uvicorn app:app --host 127.0.0.1 --port 8900
  1. 프론트엔드 의존성 설치 및 개발 서버 실행 (포트 5899)
cd ../frontend && npm install && npm run dev
  1. 브라우저에서 접속
# http://localhost:5899 열기

이 레포로 만든 것들

🖋 완주 인증하기

아직 이 레포로 만든 완주 인증이 없어요. 첫 밥도장을 찍어보세요!

별 추이 · 7일

543+384 / 7일

활용성 · 따라 만들기 좋은가

샘플 점수 34/100
  • 관대한 라이선스
  • 테스트 있음
  • 예제 디렉토리
  • 최근 활동
  • AGENTS.md
  • llms.txt
  • 템플릿

🟢 최근 활동 있음 · 2026년 생성

이 레포에 깃밥 배지 달기

[![깃밥](https://www.gitbap.com/badge/simonlin1212/Vibe-Research.svg)](https://www.gitbap.com/r/simonlin1212/Vibe-Research)

🔌 클로드에서 바로 써보기

깃밥을 클로드에 연결하면 이런 레포를 클로드·커서·Codex에서 바로 찾고 체험할 수 있어요.

방법 ① 커넥터 URL

클로드 설정 → 커넥터에 이 주소를 붙여넣기.

https://www.gitbap.com/api/mcp
방법 ② 플러그인 (체험까지)

플러그인을 설치하면 /gitbap-trending·/gitbap-try 슬래시 커맨드로 레포를 그 자리에서 체험. Claude Code에서 아래 두 줄을 차례로 실행하세요.

/plugin marketplace add jakeparkcolde/gitbap-cowork
/plugin install gitbap-cowork@gitbap
연결 방법 자세히 →

AI가 README 기반으로 요약했습니다 · 원문 보기