Show GN: firma: Claude를 내 포트폴리오 AI 비서로 만드는 로컬 퍼스트 자산관리 CLI

해외 주식 투자하면서 포트폴리오 관리를 구글 스프레드시트로 하는 경우가 많음.
firma는 그 불편함을 해결하는 로컬 퍼스트 CLI 자산관리 도구임.

핵심 기능

• firma show portfolio: 보유 종목 P&L, 평단가, 시장가 한눈에 조회 (Finnhub 자동 가격 동기화)
• firma add txn: 매수/매도/배당/세금 기록
• firma report: 월별 순자산 추이, 현금흐름 차트
• firma show earnings/financials/news <ticker>: Finnhub 기반 실적/재무/뉴스 조회
• 모든 read 커맨드에 --json 지원, AI가 스크립터블하게 사용 가능

MCP 연동

firma mcp install 한 번으로 Claude Desktop에 MCP 서버로 등록됨. 이후 이런 대화가 가능해짐:

"TSLA 오늘 많이 빠졌는데 내 포트폴리오 비중이 어떻게 돼?"
→ Claude가 DB를 직접 조회해서 보유 수량, 현재 비중, 평단 대비 손익을 바로 답해줌

"이번 달 지출이 왜 이렇게 높지?"
→ 월별 현금흐름 데이터 분석해서 전월 대비 비교해줌

Claude가 단순히 대화만 하는 게 아니라 매매 기록, 잔고 입력까지 직접 처리함.

로컬 퍼스트

모든 데이터는 ~/.firma/firma.db (SQLite) 에만 저장됨. 외부 서버로 전송되는 것 없음. 가격 조회는 본인 Finnhub API 키로 직접 호출.

설치

$ npm install -g firma-app  
$ firma config set finnhub-key YOUR_KEY  
$ firma mcp install  # Claude Desktop  재시작하면 끝