AI야, 그래서 뭐 사?

mwosa는 여러 금융 데이터 provider 를 하나의 명령어 인터페이스로 다루기 위한 투자 리서치 CLI입니다. 주식, ETF, 지수, 거시 지표, 뉴스, 포트폴리오 데이터를 수집, 조회, 계산하고, 사람과 AI 에이전트가 투자 리서치에 사용할 수 있는 형태로 제공합니다.

종목 추천이나 자동매매 도구가 아니라, 판단에 필요한 데이터를 일관된 CLI와 구조화 출력으로 제공하는 것을 목표로 합니다.

• 여러 provider API를 하나의 CLI로 사용
• 주식, ETF, 지수, 거시 지표, 뉴스, 포트폴리오 데이터 조회
• AI 에이전트가 읽기 좋은 JSON 출력 지원
• 리서치, 비교, 스크리닝, 계산, 기록을 하나의 명령 체계로 통합

mwosa 로 실제 시장 데이터를 조회하려면 최소 1개 이상의 provider 가 활성화되어 있어야 한다.

help, version, config, list providers 같은 로컬 명령은 provider 없이도 실행할 수 있다. 하지만 inspect, get, ensure, sync, screen, compare, calc 처럼 시장 데이터가 필요한 명령은 해당 capability 를 제공하는 provider 가 필요하다.

mwosa 는 장기적으로 아래와 같은 verb-first 명령 체계를 가진다.

mwosa <verb> [resource] [target] [flags]

예를 들어 inspect AAPL, get quote 005930, search instruments 반도체, compare symbols AAPL MSFT 처럼 먼저 동사를 쓰고, 그 다음에 대상을 적는다.

이 목록은 구현 순서가 아니라, 장기적으로 mwosa --help 에서 제공할 명령어 표면을 정리한 것이다.

mwosa 는 명령어 수를 무작정 늘리기보다, 적은 수의 verb 를 넓은 resource 에 적용하는 방식을 우선한다.

가장 중요한 축은 inspect 다. inspect 는 "이 대상이 지금 어떤 상태인지 자세히 보여줘" 라는 의미로 사용한다.

mwosa inspect <symbol...>
mwosa inspect --stdin
mwosa inspect instrument <symbol...>
mwosa inspect instrument --stdin
mwosa inspect portfolio <name>
mwosa inspect provider <name>
mwosa inspect tool <name>

mwosa inspect <symbol...> 은 짧은 기본형이고, mwosa inspect instrument <symbol...> 은 명시형이다. 두 명령은 같은 결과를 반환한다.

여러 종목을 한 번에 볼 때는 공백으로 symbol 을 나열한다. 다른 명령의 출력이나 AI agent 가 만든 symbol 목록을 넘길 때는 --stdin 을 사용한다.

list 는 "어떤 것들이 있는지"를 확인할 때 사용한다. 상세 정보가 필요하면 같은 대상을 inspect 로 본다.

get 은 현재가, OHLCV, 재무제표, 뉴스처럼 원천 데이터에 가까운 값을 조회한다. 조회 결과가 없을 때 자동 수집까지 보장해야 한다면 ensure 를 사용한다.

설정과 인증도 같은 원칙을 따른다. 현재 상태는 inspect, 변경은 set 또는 login/logout, 검사는 validate 로 처리한다.

포트폴리오, universe, 전략, 알림은 같은 CRUD 계열 verb 를 공유한다.