drasticstatic 작업 복사본 — Fortuna 트레이딩 시스템에서 사용됩니다. 이 저장소는 verygoodplugins/robinhood-mcp의 로컬 클론에서 생성된 독립적인 저장소입니다. 업스트림은 자발적인 비교를 위해 원격으로 추적되며, 변경 사항은 적용하기 전에 검토됩니다.

# Check for upstream updates (review before applying)
git fetch upstream && git log upstream/main --oneline

robinhood-mcp

Robinhood 포트폴리오 조사를 위한 읽기 전용 MCP 서버입니다. robin_stocks를 래핑하여 AI 어시스턴트가 분석을 위해 귀하의 포트폴리오 데이터에 접근할 수 있도록 합니다.

⚠️ 연구용 도구 전용 - 이 서버는 읽기 전용 액세스만 제공합니다. 트레이딩 기능은 노출되지 않습니다.

⚠️ 비공식 API - robin_stocks 비공식 API를 사용합니다. 예고 없이 작동이 중단될 수 있습니다. 사용 시 위험은 본인 책임입니다.

이 도구로 무엇을 할 수 있나요?

연결되면 Claude와 포트폴리오에 대해 자연스러운 대화를 나눌 수 있습니다:

포트폴리오 상태 점검

"내 포트폴리오 상태를 점검해 줘. 총 가치, 섹터 집중도, 그리고 크게 상승하거나 하락한 포지션이 있어?"

Claude가 귀하의 포지션을 가져와 섹터 노출도를 계산하고, 가장 성과가 좋거나 나쁜 종목을 식별하며, 집중 투자 위험을 경고합니다.

매수 전 조사

"NVDA 포지션을 추가할까 생각 중이야. 펀더멘털, 최근 뉴스, 애널리스트 등급, 그리고 지난 1년간의 성과를 보여줘."

가격 이력, P/E 비율, 실적 발표일, 애널리스트 의견을 종합한 포괄적인 조사 결과를 한 번에 확인하세요.

투자 비교

"내 포트폴리오에 있는 크루즈 라인 주식들을 비교해 줘 - CCL, RCL, NCLH를 P/E 비율, 시가총액, 연초 대비 성과와 함께 나란히 보여줘."

유사한 보유 종목을 빠르게 평가하여 상대적 가치를 파악하세요.

배당 분석

"올해 받은 배당금이 얼마지? 어떤 종목이 배당금을 지급하고 수익률은 어떻게 돼?"

수동적 소득을 추적하고 포트폴리오 내 배당 기회를 식별하세요.

위험 평가

"에너지 섹터에 대한 내 노출도는 어느 정도야? 상위 5개 종목에 얼마나 집중되어 있지?"

섹터 집중도를 분석하고 비중이 과도할 수 있는 포지션을 식별하세요.

실적 발표 캘린더

"앞으로 2주 안에 실적 발표가 예정된 보유 종목이 있어?"

개인화된 캘린더로 실적 발표 변동성에 미리 대비하세요.

성과 기여도 분석

"내 포트폴리오 수익률을 분석해 줘. 무엇이 수익과 손실을 주도하고 있지?"

어떤 포지션이 성과에 가장 크게 기여하고 있는지 파악하세요.

관심 종목 조사

"내 관심 종목(watchlist)에 있는 모든 종목의 시세와 펀더멘털을 가져와 줘. 지금 흥미로운 종목이 있어?"

추적 중인 주식들을 대량으로 조사하세요.

Related MCP server: Public.com MCP Server

설치

pip install robinhood-mcp

또는 uvx를 사용하여 직접 실행하세요:

uvx robinhood-mcp

설정

환경 변수

export ROBINHOOD_USERNAME="your_email"
export ROBINHOOD_PASSWORD="your_password"
export ROBINHOOD_TOTP_SECRET="your_2fa_secret"  # Only if you use authenticator app

참고: Robinhood에서 Face ID, Touch ID 또는 비밀번호 로그인을 사용하는 경우(인증 앱 미사용), ROBINHOOD_TOTP_SECRET은 필요하지 않습니다.

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json에 추가하세요:

{
  "mcpServers": {
    "robinhood": {
      "command": "uvx",
      "args": ["robinhood-mcp"],
      "env": {
        "ROBINHOOD_USERNAME": "your_email",
        "ROBINHOOD_PASSWORD": "your_password"
      }
    }
  }
}

Claude Code

claude mcp add robinhood -- uvx robinhood-mcp

사용 가능한 도구

대화 예시

간단한 질문:

• "지금 내 포트폴리오 가치가 얼마야?"

• "가치 기준 상위 5개 종목을 보여줘"

• "내가 이미 HIMS를 보유하고 있어? 현재 포지션은 어때?"

• "AAPL 시세를 알려줘"

단일 종목 포트폴리오 질문에는 robinhood_get_positions보다 robinhood_get_position을 사용하는 것이 좋습니다. 단일 종목 도구는 모든 보유 종목을 다시 불러오지 않으므로 "HIMS를 더 살까?"와 같은 질문에 훨씬 빠르게 응답합니다.

분석 요청:

• "GOOGL과 META의 펀더멘털을 비교해 줘"

• "내 주식 중 52주 평균 가격보다 낮게 거래되는 종목은 뭐야?"

• "지난 1년간 TSLA 가격 차트를 보여줘"

• "내 포트폴리오에서 가장 성과가 좋은 종목은? 가장 나쁜 종목은?"

조사 워크플로우:

• "크루즈 산업을 이해하고 싶어. CCL, RCL, NCLH 데이터를 가져와서 펀더멘털과 최근 성과를 비교해 줘."

• "내 포트폴리오에서 P/E가 15 미만이고 실적 성장이 긍정적인 주식을 찾아줘"

• "몇몇 포지션에서 큰 손실을 보고 있어. 손절할지 보유할지 결정할 수 있게 가장 성과가 나쁜 종목들의 펀더멘털과 뉴스를 보여줘."

제한 사항

• 읽기 전용: 거래를 실행하거나, 관심 종목을 수정하거나, 계정 설정을 변경할 수 없습니다.

• 비공식 API: Robinhood가 언제든 API를 변경하여 기능이 중단될 수 있습니다.

• 실시간 스트리밍 없음: 시세는 실시간 피드가 아닌 특정 시점의 데이터입니다.

• 세션 만료: 주기적으로 재인증이 필요할 수 있습니다.

• 속도 제한: 과도하게 사용하면 Robinhood의 속도 제한이 발생할 수 있습니다.

보안 참고 사항

• 자격 증명은 Robinhood 인증을 위해 로컬에서만 사용됩니다.

• 세션 토큰은 robin_stocks에 의해 ~/.tokens/robinhood.pickle에 캐시됩니다.

• .env 파일을 커밋하거나 자격 증명을 노출하지 마십시오.

• 이 도구는 거래를 실행할 수 없으며, 설계상 읽기 전용입니다.

개발

git clone https://github.com/verygoodplugins/robinhood-mcp.git
cd robinhood-mcp
pip install -e ".[dev]"

# Lint
ruff check . && ruff format --check .

# Test
pytest

# Run locally
robinhood-mcp

문제 해결

"Not logged in" 오류:

• 사용자 이름과 비밀번호가 정확한지 확인하세요.

• 인증 앱을 사용하는 2FA를 설정했다면 ROBINHOOD_TOTP_SECRET이 필요합니다.

• 계정이 잠기지 않았는지 확인하기 위해 Robinhood 앱을 통해 로그인을 시도해 보세요.

"Non-base32 digit found" 오류:

• TOTP 시크릿에 유효하지 않은 문자가 포함되어 있습니다.

• 시크릿은 A-Z 문자 및 2-7 숫자만 포함해야 합니다.

• 인증 앱을 사용하지 않는 경우 ROBINHOOD_TOTP_SECRET을 완전히 제거하세요.

속도 제한:

• robin_stocks에는 내장된 속도 제한 기능이 없습니다.

• 속도 제한에 걸리면 몇 분 기다린 후 다시 시도하세요.

라이선스

MIT

면책 조항

이 도구는 교육 및 연구 목적으로만 제공됩니다. 언제든 중단될 수 있는 비공식 API를 사용합니다. 작성자는 계정 제한, 데이터 부정확성 또는 재정적 손실에 대해 책임을 지지 않습니다.

이 프로젝트는 Robinhood Markets, Inc.와 제휴, 보증 또는 연결되어 있지 않습니다.

자동화 예시

Claude Code를 사용한 일일 포트폴리오 검토

매일 포트폴리오 브리핑을 받기 위한 크론 작업을 설정하세요:

# ~/.claude/commands/portfolio-review.md
---
description: "Daily portfolio health check"
---
Using the robinhood MCP tools:
1. Get my current portfolio value and day change
2. Identify my top 3 gainers and top 3 losers today
3. Flag any positions that are down more than 20% from cost basis
4. Check if any holdings have earnings in the next 7 days
5. Give me a 2-3 sentence summary I can read with my morning coffee

매일 실행하세요:

# Add to crontab -e
0 7 * * 1-5 cd ~/Projects && claude -p "/portfolio-review" --dangerously-skip-permissions >> ~/portfolio-reports/$(date +\%Y-\%m-\%d).md

주간 연구 요약

# ~/.claude/commands/weekly-research.md
---
description: "Weekly deep dive on portfolio"
---
For each of my top 10 holdings by value:
1. Pull current fundamentals and compare to sector averages
2. Get recent news and analyst rating changes
3. Flag any significant changes from last week
4. Identify 2-3 stocks from my watchlist that might be worth adding

Format as a markdown report I can review on the weekend.

크레딧

Very Good Plugins의 Jack Arturo가 🧡를 담아 제작했습니다.

robin_stocks 및 FastMCP 기반으로 구동됩니다.

링크

• GitHub

• PyPI

• Very Good Plugins

• AutoMem - AI 메모리 인프라

• robin_stocks 문서

• Model Context Protocol