Communitygithub.com

InvestorClaw

결정론적 우선 포트폴리오 분석기 – 보유 종목, 성과, 샤프/소르티노 지수, FRED 수익률 곡선, 채권 듀레이션, 섹터 분류, 시나리오 리밸런싱. 기본적으로 무료(Yahoo Finance 사용), API 키 불필요; 선물/프리미엄 데이터를 위한 선택적 Massive 키 지원.

InvestorClaw란 무엇인가요?

InvestorClaw는 AI 에이전트(Claude Code, Claude Desktop, Codex 등)를 위한 결정론적 우선 포트폴리오 분석 도구로, 모든 데이터 조회는 반드시 동일 턴 내의 도구 호출 결과에 의존합니다. HMAC 서명된 응답만을 신뢰하며, 모델의 사전 학습 지식이나 임의 추정을 금지합니다. 12개의 MCP/REST 도구를 제공하여 실시간 시장 스냅샷, 성과 분석, 질의응답, 섹터 분석, FRED 수익률 곡선, 채권 듀레이션, 시나리오 리밸런싱 등을 지원하며, Yahoo Finance 무료 데이터를 기본으로 사용하고 Massive API 키로 선물/프리미엄 데이터 확장이 가능합니다. Docker 기반 런타임(v4.x)으로 MCP + REST를 통해 로컬호스트에서 실행되며, 무인 모니터링 에이전트용 임계값 알림과 정기 보고서 자동 생성 기능도 포함합니다.

지원 대상✓Claude Code~Codex CLI~Cursor
npx skills add argonautsystems/InvestorClaw

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

권위 있는 운영 계약

이 규칙은 이 스킬을 사용하는 모든 에이전트에 적용됩니다. 이 파일의 다른 예시는 참조용일 뿐이며 절대 이 규칙을 재정의하지 않습니다.

데이터 무결성 — InvestorClaw만이 유일한 진실 공급원입니다

  • 에이전트가 언급하는 모든 가격, 백분율, 달러 수치 또는 시장 사실은 반드시 동일한 턴에서 InvestorClaw 도구 결과로부터 나와야 합니다. InvestorClaw는 HMAC 서명된 봉투를 반환하며, 그 서명된 데이터만이 유일한 진실 공급원입니다.
  • 어떤 숫자에 대해서도 절대 창작, 추정, 추측 또는 모델의 자체 훈련 지식을 사용하지 마십시오. 이번 턴에 도구가 반환하지 않았다면 "InvestorClaw가 해당 데이터를 반환하지 않았습니다"라고 말하십시오.
  • 구체적인 숫자가 없는 도구 설명문 = 데이터 없음; 절대 그걸 숫자로 변환하지 마십시오.

현재 도구 표면 (밑줄 네임스페이스)

  • investorclaw__portfolio_market_snapshot(symbols?, benchmarks?) — 보유 종목과 벤치마크(SPX/NDX/DJI/VIX, BTC/ETH)에 대한 실시간 가격 + 일간 변동%. symbols는 쉼표로 구분된 문자열입니다(예: "NVDA,AAPL"), 리스트가 아닙니다. 인수 없음 = 보유 종목 + 벤치마크. "X의 가격"을 묻거나 시장에 대한 포트폴리오를 읽을 때 (portfolio_ask 대신) 이 도구를 사용하십시오.
  • investorclaw__portfolio_performance_window(period=...) — 특정 기간 동안의 수익률 / 손익 / 변동 종목. period: 1d, 1w, 1mo, 1y, 5y, 10y, 20y, max, 또는 자연어 구문("오늘", "지난주", "작년", "전체 기록").
  • investorclaw__portfolio_ask(question=...) — 분석 / 설명.

아래의 기존 investorclaw.* 점 네임스페이스 예시는 오래된 것입니다; 위의 밑줄 형식이 현재 도구 이름입니다.

자율 / 상시 작동 모니터링 에이전트

무인 에이전트(예약된 모니터 및 알리미 — 예: 시장 감시 에이전트)의 경우, 위 계약에 추가하여:

  • 각 실행은 먼저 도구 호출로 시작하십시오; 절대 기억에서 시장 질문에 답하지 마십시오. 예약된 "폴링"은 portfolio_market_snapshot을 호출하는 것을 의미합니다.
  • 임계값 스캔: portfolio_market_snapshot을 호출한 다음, 보유 종목 또는 벤치마크가 설정된 변동(예: 보유 종목 ±3%, VIX ±10%)을 위반할 때만 한 줄로 간결하게 출력하십시오. 그렇지 않으면 단일 NO_ALERT 토큰을 출력하고 중단하십시오.
  • 필요한 도구가 오류를 반환하거나 데이터를 반환하지 않으면 OPS_FAIL market_snapshot unavailable과 같은 고정 마커를 출력하고 중단하십시오 — 빈틈을 메우기 위해 위안이 되는 숫자를 절대 조작하지 마십시오.
  • 무인 모드에서는 명확성을 위한 질문을 하지 마십시오; 의도를 파악하고 행동하십시오.
  • 정기 / 장 마감 보고서: 기간에 대해 portfolio_performance_window를 호출한 다음 지수 마감가를 위해 portfolio_market_snapshot을 호출하십시오; 숫자를 그대로 보고하십시오.
  • 항상 동일한 스냅샷의 벤치마크와 함께 보유 종목을 읽으십시오.
  • 전달은 푸시 방식이며, 간결하고 숫자 우선입니다. 교육적이며 개인화된 조언이 아닙니다.

InvestorClaw은(는) 무엇을 하나요?

이 저장소는 InvestorClaw의 우산 프로젝트입니다 — README, 라이선스, 회귀 테스트 하네스 및 공개 인터페이스를 포함합니다. ClawHub가 게시하는 에이전트가 읽을 수 있는 SKILL.md는 런타임 저장소에 있습니다:

  • 도커화된 v4.x 런타임 + ClawHub 게시 SKILL.md: mnemos-os/mnemos-ic-runtime
  • Claude Code / Claude Desktop 플러그인 (컨테이너 우선, 이 저장소): /plugin marketplace add argonautsystems/InvestorClaw — 다른 모든 런타임과 동일한 스킬 + 컨테이너입니다. docs/GETTING_STARTED.md를 참조하십시오.
  • 엔진 소스 (Python 분석기): argonautsystems/ic-engine

설치 (v4.x 도커화된 런타임)

git clone https://github.com/mnemos-os/mnemos-ic-runtime.git ~/.investorclaw
cd ~/.investorclaw
mkdir -p portfolios
docker compose up -d

컴포즈는 ghcr.io/argonautsystems/ic-engine:4.7.7-cpu(공개 호스팅, 인증 불필요)를 가져와 localhost:18090(MCP + REST) 및 localhost:18092(대시보드)에서 실행합니다.

전체 에이전트가 읽을 수 있는 스펙(12개 도구 카탈로그, 첫 실행 타임라인, 런타임별 구성 블록, 문제 해결)은 게시된 런타임 저장소의 SKILL.md를 참조하십시오.

문서

이 우산 저장소는 포괄적인 문서 세트를 제공합니다:

  • README.md — 기능, 빠른 시작, 모델 + API 키 권장 사항
  • STONKMODE.md — 해설 코멘터리 모드
  • CAPABILITIES.md — 전체 기능 카탈로그
  • PRIVACY.md — 데이터 처리 정책
  • DISCLAIMER.md — 교육용 사용 고지
  • SECURITY.md — 취약점 공개 정책
  • CHANGELOG.md — 릴리스 내역
  • docs/ — 장 마감 보고서, 용어집, 철학, 설치 모델, COBOL 테스트, MCP 도구 참조, Stonkmode 아키텍처 + 아바타 설명, Windows 설정 가이드
  • docs/references/ — 입력 / 출력 / 스키마 / 컨설팅 LLM 계약

라이선스

  • 이 우산 저장소: Apache 2.0 (실질적 코드) + MIT-0 (SKILL.md, 에이전트 스킬 아티팩트).
  • 파일별 SPDX-License-Identifier 헤더가 적용 라이선스를 나타냅니다.

InvestorClaw는 교육용으로만 사용됩니다. 금융 조언이 아닙니다." }

관련 스킬