trader-analyst은(는) 무엇을 하나요?
실적은 캘린더상 그 어떤 요소보다 주가를 움직이며, 보도자료는 가장 좋은 수치를 먼저 배치하도록 작성됩니다. 이 스킬은 기업이 SEC에 실제 제출한 수치를 읽어 분기별로 정리하고, 무엇이 변했는지 명확히 말해줍니다. 데이트레이더에게 이 스킬은 거래 전에 두 가지 질문에 답합니다: 마지막 보고서는 어땠고, 다음 보고서는 이 거래 기간 내에 있는가?
이 폴더에 있는 도구(표준 라이브러리 Python, 키 없음):
python3 "${CLAUDE_SKILL_DIR}/facts.py" --help
SEC User-Agent(trader/config.json의 sec_user_agent, 또는 SEC_USER_AGENT)가 필요합니다: "Your Name [email protected]" 형식으로 사용자의 실제 이름과 이메일을 입력합니다. User-Agent 없이는 SEC를 호출하지 않습니다.
읽고 쓰는 것
https://data.sec.gov/api/xbrl/companyfacts/CIK##########.json(기업이 공시에 태그한 모든 숫자), 기업의 제출 목록(가장 최신 10-Q 또는 10-K, 그리고 "영업 결과" 항목 2.02가 포함된 가장 최신 8-K) 및 해당 8-K의 폴더에서 보도자료(EX-99.1 첨부서류)를 찾습니다.--metrics사용 시trader/metrics.json에 기록: 기업별 한 행(TTM 매출, 순이익 및 희석 EPS, 최신 마진 및 성장률)으로, 메모나 스프레드시트에 사용합니다. 이 폴더의metrics.example.json은 2026-10-13에 AAPL, AXP, GOOGL, KO, BAC에 대해 실제 실행한 결과입니다.- 실적 발표: 이 도구는 스크립트를 가져오지 않습니다. 사용자가 스크립트를 붙여넣으면(또는 기업 IR 페이지에 있는 경우) 이를 읽고 경영진이 언급한 변경 사항(가이던스, 마진, 수요, 답변을 거부한 사항)을 요약합니다.
- 다음 보고서 날짜는 SEC 데이터에 없습니다.
/trader-news헤드라인이나 기업의 투자자 관계 페이지에서 찾아보고, 출처를 명시하세요.
규칙
- 제출된 수치가 먼저입니다. 표는 기업이 제출한 XBRL 팩트에서 가져옵니다. 보도자료는 맥락(가이던스, 부문별 설명)을 위해 사용하고, 어떤 수치가 어디서 왔는지 명시하세요.
- 동등한 것끼리 비교하세요. 성장률은 전년 동기 대비입니다. 분기 대비 변화도 표시되지만 많은 기업이 계절적 영향을 받습니다(애플의 12월 분기는 항상 가장 큽니다).
- 파생된 수치임을 명시하세요. 기업은 4분기 10-Q를 제출하지 않습니다. 4분기는 10-K 연간 수치에서 해당 연도의 세 분기 수치를 뺀 값이며 "파생"으로 표시됩니다. 파생 EPS는 근사치입니다.
- 데이터가 지연될 때를 알리세요. SEC의 팩트 API는 공시보다 늦을 수 있습니다. 가장 최신 10-Q가 팩트의 가장 최신 분기보다 나중일 경우, 도구는 링크와 함께 NOTE를 출력합니다. 요약하기 전에 10-Q 자체를 읽으세요.
- 일회성 요인을 표시하세요. 순이익이 영업이익보다 높을 경우, 영업 외 수익(투자 평가익, 세금 항목)이 포함된 것입니다. 도구가 이를 알려줍니다. 은행과 보험사는 총이익률이 없습니다: 공백으로 표시, 0이 아닙니다.
단계
-
해당 기업(또는
trader/watchlist.json의 티커)에 대해 실행합니다:python3 "${CLAUDE_SKILL_DIR}/facts.py" TSLA python3 "${CLAUDE_SKILL_DIR}/facts.py" TSLA NVDA AMD --metrics trader/metrics.json--quarters 8은 2년 치를 보여주고,--json은 모든 것을 기계 판독 가능하도록,--cik은 티커가 없는 기업에 사용합니다. -
최신 실적 보도자료(EX-99 링크)와 수치에 맥락이 필요할 때는 10-Q를 열어 읽습니다.
-
요약을 작성합니다: 분기에 관한 한 줄(매출, EPS, 성장률), 마진에 관한 한 줄, 특이 사항에 관한 한 줄(일회성 요인, 파생 분기, 데이터 지연), 그리고 링크. 평이한 언어, 실제 숫자, 숫자가 뒷받침하지 않는 형용사는 사용하지 않습니다.
-
다음 보고서가 계획된 거래 기간 내에 있을 경우(익일 보유, 또는 장 시작 전 보고서),
/trader-exit이 스탑로스를 설정하기 전에 이를 알리세요. 스탑로스는 갭에 대비해 보호해주지 않으며, 주식은 스탑 가격을 넘어서 개장할 수 있습니다.
예시: 실제 주식
facts.py TSLA (2026-10-20 실행): 2026-06-30 종료 분기(Q2 2026), 매출 $28.24B, 전년 동기 대비 +25.5%, 순이익 $1.11B(-4.9%), 희석 EPS $0.32(-3.0%); 총이익률 16.8%(전 분기 대비 -4.3%p), 영업이익률 1.4%; 최근 4분기 매출 $103.6B 및 EPS $1.08. 도구는 순이익이 영업이익보다 높음을 표시하므로, 영업 외 수익이 포함된 것입니다. 최신 10-Q 제출일 2026-07-23. 월요일 헤드라인에서 테슬라가 이번 주에 실적을 발표한다고 했으므로, 요약은 이렇게 끝납니다: "다음 보고서가 며칠 남지 않았습니다. 장 마감 전에 청산하는 데이트레이드는 영향을 받지 않습니다. 익일 보유하는 모든 포지션은 노출됩니다."
facts.py AAPL (2026-10-13): 매출 $109.42B, 전년 동기 대비 +16.4%, 희석 EPS $2.02(+28.7%). 코카콜라의 경우 도구는 SEC 팩트가 2026-04-03에서 중단된 반면 2026-07-03 종료 분기의 10-Q는 이미 제출되었음을 확인했으므로, 요약은 해당 10-Q를 직접 읽었습니다.
절대 하지 않는 일
- 주식이 싸다, 비싸다, 매수다, 매도다 라고 절대 말하지 않습니다. 기업이 제출한 것을 보고할 뿐입니다.
- 공시에 없는 숫자를 절대 만들어내지 않으며, 추정할 수 없는 분기를 절대 추정하지 않습니다.
- User-Agent 없이 SEC를 절대 호출하지 않으며, 초당 10개 요청을 훨씬 밑도는 수준을 유지합니다.
안전
교육 및 도구 제공일 뿐, 재정적 조언이 아닙니다. 이 스킬은 공시만 읽습니다. /trader-risk를 통과하고 사용자가 해당 주문에 대해 명시적으로 동의한 후에만 /trader-broker가 주문을 체결합니다.