Jakeschincariol/trader-skill

11 Claude skills that copy the investors you trust, watch the news and Congress, size every trade to your budget, and never place an order without your yes.

개요

Trader‑skill은 순수 Python으로 작성된 Claude 스킬(플러그인) 모음으로, Claude가 종이 거래 포트폴리오를 구축하고 관리하는 데 도움을 줍니다. 각 스킬은 헤지 펀드의 13‑F 서류 복사, 뉴스 모니터링, 포지션 예산, 위험 확인, 브로커 티켓 생성, 의회 거래 추적 등 단일하고 명확하게 정의된 작업을 수행합니다. 도구는 공개 데이터 소스(SEC EDGAR, 하원 서기 PTR PDF, 뉴스 RSS, Yahoo Finance)만 읽으며 자동으로 주문을 하지 않습니다. 모든 거래는 인간이 확인해야 합니다.

얻는 방법

Claude에서 – GitHub URL을 붙여넣고 install skill을 실행합니다.
Claude Code 플러그인으로 – README에 표시된 마켓플레이스 명령을 사용합니다.
수동으로 – 저장소를 클론하고 trader‑* 폴더를 ~/.claude/skills/(또는 프로젝트의 .claude/skills/)에 복사합니다.

코드는 **Python 3.8+**에서 실행되며 외부 종속성이 없습니다. trader/config.json 또는 SEC_USER_AGENT를 통해 SEC 사용자 에이전트를 설정하기만 하면 됩니다.

핵심 기능(11개 명령)

명령	목적	기능
`/trader-copycat`	제출자 리버스 엔지니어링	13‑F‑HR을 다운로드하고, 보유 종목을 추출하고, 가중치 변화를 계산하고, `targets.json`을 작성합니다.
`/trader-news`	뉴스 모니터	보유한 각 티커에 대한 헤드라인과 8‑K 서류를 가져오고 관련 항목을 표시합니다.
`/trader-budget`	예산 관리자	각 목표에 금액을 할당하고, 현금 버퍼와 주식별 상한을 강제하며, `orders.json`을 출력합니다.
`/trader-pelosi`	의회 거래 추적기	하원 PTR PDF가 나타나는 즉시 가져와 행으로 파싱하고 새 서류에 대해 알립니다.
`/trader-analyst`	수익 데이터 추출기	XBRL 팩트(수익, EPS, 마진, 성장)와 최신 수익 발표를 검색합니다.
`/trader-screener`	맞춤 스크리너	사용자 정의 규칙(`rules.json`)을 지표(`metrics.json`)에 적용하고 통과 주식을 순위화합니다.
`/trader-risk`	위험 게이트	각 제안 주문을 사용자 제한(크기, 포지션, 현금, 차단 티커)에 대해 검증하고 PASS/BLOCK을 반환합니다.
`/trader-broker`	주문 실행기(수동)	브로커 호환 티켓을 포맷하고 사용자에게 표시한 후 "예" 후에 구성된 브로커 커넥터(기본 Alpaca MCP, 종이 계정)로 보냅니다.
`/trader-tax`	세금 손실 수확 도우미	비용 기준 로트를 추적하고, 손실 수확 후보를 식별하며, 워시 세일 기간을 존중합니다.
`/trader-alerts`	가격 알림 서비스	NYSE 달력을 사용하여 가격 목표, 스톱 또는 시장 개장/폐장 시 발동합니다.
`/trader-rebalance`	포트폴리오 리밸런서	목표 가중치에서의 이탈(사용자 정의 밴드 초과)을 감지하고 수정 거래를 제안합니다.

일반적인 워크플로우

펀드 복사 – /trader-copycat → targets.json.
포지션 크기 조정 – /trader-budget → orders.json.
위험 확인 – /trader-risk(위반 주문 차단).
확인 및 전송 – /trader-broker가 티켓을 표시; yes를 입력; Claude가 브로커를 호출합니다.
지속 – /trader-news, /trader-pelosi, /trader-alerts를 예약합니다.
분기별 – copycat을 반복하고 /trader-rebalance를 실행합니다.

코드 직접 실행

저장소에는 작은 오프라인 테스트 픽스처가 포함되어 있어 로컬에서 명령을 시도할 수 있습니다. 예:

python3 trader-copycat/edgar13f.py find buffett
python3 trader-news/news.py --tickers AAPL GOOGL --hours 24
python3 trader-pelosi/ptr.py index --member pelosi
python3 -m unittest discover -s tests -v

모든 스크립트는 Python 표준 라이브러리만 사용합니다.

제한 사항 및 안전 참고 사항

재정적 조언이 아님 – 도구는 데이터 검색과 산술만 수행합니다.
종이 우선 – 기본 구성은 Alpaca의 종이 거래 엔드포인트를 사용합니다. 실제 자금 키는 환경 변수를 통해 제공해야 합니다.
데이터 지연 – 13‑F 서류는 최대 45일 오래됨; 의회 PTR은 거래 후 45일 이내에 공개됩니다.
자동 실행 없음 – 주문은 Claude에서 사용자의 명시적 확인 후에만 전송됩니다.
공개 소스 취약성 – SEC EDGAR, 하원 서기 PDF, RSS 피드 및 비공식 Yahoo Finance 엔드포인트에 의존; 변경 시 스크립트가 깨질 수 있습니다.

라이선스 및 저자

MIT 라이선스, 저자 Jake Schincariol (https://opusjake.ai).