AI 종목분석을 위한 Claude 커넥터 연결 가이드

---
name: opendart-company-one-pager
description: "상장 기업의 1-pager(기업 개요·재무·공시·이슈·리스크)를 작성한다. 국내 상장기업(코스피·코스닥·코넥스)은 OpenDART 공시 데이터를, 해외 상장기업은 FMP 데이터를 사용해 국내·해외 종목을 모두 다룬다. 사용자가 '1-pager', '기업 요약', '종목 분석', '기업 프로필', '원페이저', 'company overview'를 요청하거나 특정 종목에 대한 전반적 분석을 요청할 때 사용한다. 특히 국내 종목이 하나라도 포함된 요청(단일 국내 종목 분석, 또는 국내·해외 종목 비교)에는 이 스킬을 최우선으로 사용하고, 최대주주 현황·임원 현황·배당·증자감자·자기주식 등 DART 공시 기반 지배구조·자본 정보가 필요할 때도 트리거한다."
---

# 기업 1-Pager (국내·해외 통합)

상장 기업 1종(또는 국내·해외 비교 2종 이상)에 대해 개요·재무·공시·이슈·리스크를 1장으로 정리한다. **국내 종목은 OpenDART(PlayMCP 커넥터)를, 해외 종목은 FMP를 데이터 소스로 사용**한다. 두 소스는 성격이 달라(OpenDART는 공시 원문 기반, FMP는 시장 데이터 기반) 국내·해외를 같은 톤으로 다루려면 아래 라우팅을 먼저 정확히 거쳐야 한다.

## 입력 및 라우팅
사용자 프롬프트에서 기업명 또는 티커를 추출하고, 아래 기준으로 국내/해외 트랙을 정한다.

- **국내 트랙**: 6자리 숫자 종목코드(예: 005930), 한국 기업명(예: "삼성전자", "SK하이닉스"), 또는 "코스피"/"코스닥"/"코넥스"/"국내" 언급.
- **해외 트랙**: 알파벳 티커(NASDAQ/NYSE/기타 해외거래소), 해외 기업명.
- **혼합 요청** (예: "삼성전자와 마이크론 비교해줘"): 각 종목을 해당 트랙으로 개별 조사한 뒤 하나의 통합 리포트로 묶는다.

티커/종목코드가 명시되지 않았다면, 국내는 `opendart-find_company`로, 해외는 `FMP:search`(search-name/search-symbol)로 먼저 식별한다.

---

## A. 국내 종목 데이터 수집 — OpenDART (PlayMCP)
가능한 호출은 병렬로 실행해 응답 속도를 높인다. 자주 조회되는 기업은 아래 corp_code를 바로 사용해 `find_company` 호출을 생략할 수 있다: 삼성전자 00126380, SK하이닉스 00164779, LG전자 00401731, 현대자동차 00164742, 네이버 00266961, 카카오 00258801, 삼성SDI 00126371, LG화학 00356361, 셀트리온 00421045, 포스코홀딩스 00126186. 목록에 없으면 `opendart-find_company`로 검색해 corp_code(8자리)를 확보한다.

reprt_code는 기본적으로 최신 사업보고서(11011)를 쓰되, 사용자가 최근 분기 실적을 원하면 1분기(11013)/반기(11012)/3분기(11014)를 함께 조회한다. fs_div는 연결재무제표(CFS)를 우선 사용하고, 없으면 개별(OFS)로 대체했음을 표기한다.

### Step 1: 기업 기본 정보
```
PlayMCP:opendart-get_company_info(corp_code)
PlayMCP:opendart-get_employees(corp_code, bsns_year, reprt_code)
```
추출 항목: 대표자, 업종, 주소, 설립일, 결산월, 직원 수, 평균 근속연수, 평균급여.

### Step 2: 주가·밸류에이션 (웹 검색이 유일한 소스 — OpenDART는 시세·주가배수를 제공하지 않음)
```
web_search: "{기업명} 주가 시가총액 PER PBR {현재연도}"
```
네이버페이 증권, 다음 금융, Investing.com 등 국내 시세 소스를 인용한다. **주의**: `get_financial_index`(수익성지표, M210000)는 ROE·매출총이익률·순이익률 등 손익 기반 수익성 지표만 반환하며 PER·PBR 같은 시장 주가배수는 포함하지 않는다 — 시세 관련 지표는 이 단계의 웹검색으로만 확보한다.

국내 종목은 사이트마다 갱신 시점이 달라(같은 날짜에도 PER이 19배~23배로 갈리는 경우가 흔함) 하나의 수치를 단정적으로 제시하면 오해를 부른다. 최소 2개 출처를 검색해 ① 가장 최신 날짜의 종가·시가총액을 대표값으로 쓰고 ② PER/PBR처럼 출처별 편차가 있는 지표는 "약 X~Y배(출처·기준일 상이)" 형태로 범위와 함께 표기한다.

### Step 2-보조: 공시 기준 수익성 지표 (시장 밸류에이션과는 별개)
```
PlayMCP:opendart-get_financial_index(corp_code, bsns_year, reprt_code, idx_cl_code=M210000)  # ROE·매출총이익률·순이익률 등
```
이 값은 "공시 기준(사업연도 {YYYY} 연결)" 수익성 지표이며, 위 Step 2의 시장가 기준 밸류에이션과 혼동되지 않도록 표에서 별도 줄로 구분해 표기한다.

### Step 3: 재무 실적
```
PlayMCP:opendart-get_financial_account(corp_code, bsns_year, reprt_code, fs_div)
PlayMCP:opendart-get_financial_index(corp_code, bsns_year, reprt_code, idx_cl_code=M230000)  # 성장성
```
수익성 지표(M210000)는 Step 2-보조에서 이미 확보했으므로 재호출하지 않는다. 최소 직전 2개 연도(가능하면 최근 분기 포함) 매출·영업이익·OPM·순이익·ROE·부채비율을 수집한다. 계정과목이 불명확하거나 더 상세한 항목이 필요하면 `opendart-get_full_financial_statement`로 BS/IS/CF 전체를 확인한다.

### Step 4: 최근 공시
```
PlayMCP:opendart-search_disclosures(corp_code, bgn_de, end_de)
```
최근 3~5건을 일자·보고서명·핵심 내용으로 요약한다. 정기공시(사업/분기보고서)보다 수시공시(주요사항보고서, 공정공시, 계약체결 등)를 우선 배치한다.

### Step 5: 최근 이슈·뉴스
```
web_search: "{기업명} 뉴스 {현재 월 연도}"
web_search: "{기업명} {핵심 사업 키워드} {현재연도}"
```
선별 기준은 해외 트랙과 동일(아래 B-5 참고).

### Step 6: 지배구조·자본현황 (국내 종목 전용 — OpenDART가 강점을 갖는 영역)
기본으로 아래 3개를 조회한다:
```
PlayMCP:opendart-get_largest_shareholders(corp_code)
PlayMCP:opendart-get_executives(corp_code, bsns_year, reprt_code)
PlayMCP:opendart-get_dividend_info(corp_code)
```
최대주주·특수관계인 지분율, 등기임원 현황(대표이사 포함), 최근 배당(주당 배당금·배당성향)을 정리한다.

아래는 **특이사항이 있을 때만** 추가로 조회해 언급한다 — 매번 호출할 필요는 없다. 최대주주 지분에 큰 변동이 있었거나, 사용자가 지배구조 이슈(경영권 분쟁, 대량 매도 등)를 물었을 때만 사용한다:
```
PlayMCP:opendart-get_executive_stock(corp_code)                          # 임원·주요주주 지분 변동 (내부자 매매 시그널)
PlayMCP:opendart-get_major_stock(corp_code)                              # 5%룰 대량보유 상황보고
PlayMCP:opendart-get_capital_change(corp_code, bsns_year, reprt_code)    # 증자/감자 이력
PlayMCP:opendart-get_treasury_stock(corp_code)                           # 자기주식 취득/처분
```

---

## B. 해외 종목 데이터 수집 — FMP
국내 트랙과 병행하는 경우에도 이 로직을 그대로 적용한다.

### Step 1: 기업 프로필 (FMP)
```
FMP:company → endpoint: profile-symbol, symbol: {TICKER}
```
추출 항목: 기업명, 섹터/산업, 본사, CEO, 임직원 수, 시가총액, beta, 52주 레인지, IPO일, 사업 설명.

### Step 2: 주가·밸류에이션 (FMP → 웹 검색 폴백)
```
FMP:quote → endpoint: quote, symbol: {TICKER}
```
FMP 플랜 제한으로 실패 시 즉시 웹 검색으로 전환한다:
```
web_search: "{TICKER} stock price PE ratio PBR market cap {현재연도}"
```
필수 지표: 현재가, 시가총액, PER(TTM/Forward), PBR, 배당수익률, YTD 수익률. 해외 종목도 소스별로 PER이 소폭(예: 21~22배 사이)씩 갈리는 경우가 흔하므로, 국내 트랙과 마찬가지로 2개 이상 출처를 확인해 범위로 표기하거나 가장 최신 자료의 값을 대표값으로 명시한다.

### Step 3: 재무 실적 (웹 검색 + SEC Filing)
FMP 손익계산서·비율 엔드포인트가 플랜 제한일 수 있으므로 SEC 원문과 웹 검색을 병행한다:
```
web_search: "{기업명} {TICKER} revenue earnings financials {최근 회계연도}"
web_search: "{기업명} annual revenue operating income {직전 2개 회계연도}"
```
수집 항목(최소 직전 2개 분기 + 직전 2개 연도): 매출, 영업이익, OPM, 순이익, EPS(GAAP/Non-GAAP), 가능하면 OCF/FCF/CapEx/ROE/ROIC. 모든 수치에 출처와 기준 회계기간을 명기한다.

### Step 4: 최근 공시 (FMP → 웹 검색 폴백)
```
FMP:secFilings → endpoint: search-by-symbol, symbol: {TICKER}, limit: 5
```
실패 시: `web_search: "{기업명} {TICKER} SEC filings {현재연도}"`. 최근 3~5건을 일자·유형·핵심 내용으로 요약하고, 8-K·10-Q/10-K를 내부자 거래(Form 3/4)보다 우선한다.

### Step 5: 최근 이슈·뉴스
```
web_search: "{기업명} {TICKER} stock news {현재 월 연도}"
web_search: "{기업명} {핵심 사업 키워드} {현재연도}"
```
선별 기준: 실적·가이던스, 제품/기술 이정표, 대규모 CapEx/M&A/구조조정, 업종 테마, 경영진/지배구조. 노이즈(단순 주가 예측·루머)는 제외한다.

---

## 출력 포맷

### 국내 종목 (6개 섹션)
```
## {기업명} ({거래소}:{종목코드}) — 기업 1-Pager
**기준일: {YYYY년 MM월 DD일} | 회계연도: {결산월} 결산 | 출처: OpenDART, {기타 출처}**

### 1. 기업 개요
{사업 설명 2~3문장 + 표: 대표자/업종/설립일/직원수/시가총액}

### 2. 재무 스냅샷
분기 실적 표 / 연간 실적 표 / 밸류에이션 표(시장가 기준 PER·PBR·시가총액 — 복수 출처 병기 / 공시 기준 ROE·수익성 지표는 별도 줄로 구분)

### 3. 최근 공시
| 일자 | 유형 | 내용 |

### 4. 이슈

### 5. 리스크·관전 포인트

### 6. 지배구조·자본현황
{최대주주 지분 표 / 등기임원 현황 / 최근 배당 / (특이사항 있을 시) 지분변동·증자감자·자기주식}
```

### 해외 종목 (5개 섹션 — 기존 company-one-pager와 동일한 구조)
```
## {기업명} ({거래소}:{티커}) — 기업 1-Pager
**기준일: ... | 회계연도: ... | 출처: {주요 출처}**

### 1. 기업 개요
### 2. 재무 스냅샷
### 3. 최근 공시
### 4. 이슈
### 5. 리스크·관전 포인트
```

### 국내·해외 비교 (혼합 요청)
각 종목의 1-pager를 순서대로 제시한 뒤, 마지막에 "### 비교 요약" 섹션을 추가해 밸류에이션·성장성·리스크 관점에서 간단히 대조한다. 국내는 원화, 해외는 현지 통화 기준임을 명시하고 임의로 환산하지 않는다(사용자가 요청할 때만 환산하고 환율 출처를 표기).

---

## 분석 원칙 (공통)
- **Top-Down 1차 필터**: 금리 방향성·크레딧 스프레드로 시장 국면을 판단하고, 기업의 현 위치를 언급한다.
- **Bottom-Up 핵심**: 내재가치 대비 현재가 괴리, 실적 모멘텀(earnings revision, 서프라이즈 이력).
- **멍거식 인버전**: "현재 투자 내러티브가 틀리려면 어떤 조건이 필요한가"를 강세론/약세론 양방향으로 제시.
- 국내 종목의 경우 지배구조(최대주주·특수관계인 지분, 경영권 안정성)를 리스크·관전 포인트 판단에 함께 반영한다.

## 제약·금지 (공통)
- 투자 권유·매수/매도 추천 금지. 분석 프레임워크와 팩트만 제공한다.
- 확인되지 않은 수치를 확정적으로 제시하지 않는다. 출처 불명 시 명시한다.
- 과도한 낙관/비관 금지. 객관적·중립적 톤. 서론·마무리 멘트 없이 바로 본론.
- 금융 전문 용어는 설명 없이 사용한다.

## 데이터 소스 제한 대응
- **OpenDART**: `find_company`로 기업을 찾지 못하면 비상장·최근 상장폐지·이름 표기 차이일 수 있음을 안내하고 웹 검색으로 대체한다. corp_code는 있으나 특정 연도 보고서가 없으면(신규 상장 등) 가장 최근 가용 연도로 대체하고 그 사실을 표기한다.
- **FMP**: 플랜 제한 에러(ACCESS DENIED) 발생 시 ① 에러를 사용자에게 노출하지 않는다 ② 해당 데이터를 웹 검색으로 즉시 대체한다 ③ 최종 출력에서 데이터 공백 없이 완성된 1-pager를 제공한다.