이 회사는 최근 무엇을 공시했을까?

종목과 공식 공시·원문을 연결합니다.

이어갈 프로젝트 · ai-stock-briefing

9장의 시장·검색·종목·차트가 있습니다.

이번 장의 준비와 서비스

필요한 도구 · 기존 Next.js 프로젝트

이미 준비한 계정과 기능은 그대로 이어갑니다.

opendart 준비 안내 →data-go-kr 준비 안내 →

주가와 공시가 같은 시기에 있다는 이유로 원인이나 투자 판단을 단정하지 않습니다.

순서대로 입력하는 커맨드

현재 단계와 입력 위치를 확인한 뒤 하나씩 복사하세요.

01시작 전 확인

Claude Code·Codex에 입력튜터 요청

10장을 처음 시작하거나 현재 장의 시작 조건을 확인해 달라고 요청할 때

먼저 확인 · 9장의 시장·검색·종목·차트가 있습니다. 이미 확인된 장·프로젝트는 다시 묻지 않고 현재 기록과 실제 상태를 대조합니다.

10장 시작해.

2. OpenDART API Key를 준비합니다 선택·문제 발생 시

Claude Code·Codex에 입력선택·문제 발생 시

독자가 OpenDART 인증키 신청 화면에서 항목 도움을 요청할 때만

먼저 확인 · 독자가 공식 인증키 신청 화면을 열었는지 확인합니다. 이미 발급받았다면 재신청하지 않고 개인정보·비밀번호는 직접 입력합니다.

지금 OpenDART 인증키 신청 화면에 있어.

개인으로 이 책의 주식 공시 실습에 사용할 API Key를 신청하려고 해.

화면에서 내가 직접 입력하거나 선택해야 하는 항목을 하나씩 알려줘.

03OpenDART API Key를 준비합니다

Claude Code·Codex에 입력실습

OpenDART 인증키 발급 후 프로젝트의 안전한 입력 위치를 준비할 때

먼저 확인 · 독자가 신청을 마치고 인증키 신청/관리→오픈API 이용현황에서 API Key 발급을 확인했는지 봅니다. 현재 프로젝트는 ai-stock-briefing입니다.

OpenDART API Key를 발급받았어.

실제 키가 코드나 Git, 사용자의 브라우저에 노출되지 않게 안전하게 사용할
수 있도록 준비해줘.

실제 키 값은 내가 직접 입력할게. 어디에 입력하면 되는지만 알려줘.

04OpenDART API Key를 준비합니다

Claude Code·Codex에 입력실습

독자가 OpenDART 키를 직접 입력한 뒤 노출 여부를 확인할 때

먼저 확인 · 앞에서 안내한 위치에 실제 값을 직접 입력했는지 확인합니다. 값을 대화로 요청하지 않습니다.

방금 입력한 OpenDART API Key가 코드나 Git에 포함되지 않는지 확인해줘.

사용자의 브라우저에도 노출되지 않게 되어 있는지 확인해줘.

실제 키 값 자체는 화면에 출력하지 마.

05준비한 API Key로 공시를 연결합니다

Claude Code·Codex에 입력실습

9장의 SK하이닉스 상세 화면에 실제 공시를 처음 연결할 때

먼저 확인 · 9장의 시장·검색·종목·차트와 OpenDART 키 준비·노출 검사를 확인합니다.

지금 만든 SK하이닉스 상세 화면에 최근 공시를 연결해줘.

조회 기간은 앞에서 만든 주가 차트와 같은 최근 1년으로 맞춰줘.

금융감독원 OpenDART에서 회사가 실제로 제출한 자료를 가져오고, 접수일,
보고서명, 제출인과 DART 원문 링크를 보여줘.

공시가 주가 움직임의 원인이라고 해석하거나 투자 의견을 만들지는 마.

06같은 회사라도 서비스마다 번호가 다릅니다

Claude Code·Codex에 입력실습

종목과 OpenDART 회사의 연결 근거를 확인하고 일반화할 때

먼저 확인 · 실제 공시 연결과 현재 종목코드를 확인합니다. 회사 이름만 비슷하다고 선택하지 않습니다.

주식 화면의 여섯 자리 종목코드로 OpenDART 회사를 찾게 해줘.

OpenDART 회사 고유번호 자료를 기준으로 연결하고, 이름이 비슷하다는
이유로 임의의 회사를 선택하지 마.

SK하이닉스 `000660`이 어떤 고유번호로 연결되는지도 실제 자료로
확인해줘.

07최근 공시부터 보여줍니다

Claude Code·Codex에 입력실습

종목 상세에서 최근 공시 5건과 전체 보기 길을 만들 때

먼저 확인 · 회사 매핑과 최근 1년 실제 공시 목록을 확인합니다.

SK하이닉스 상세 화면에는 최근 공시 5건만 먼저 보여줘.

영역 제목은 「이 회사 관련 공시」로 적어줘. 각 공시는 접수일, 보고서명,
제출인을 위에서 아래로 읽는 구분선 목록으로 만들고, 보고서명은 검정색으로
보여줘. 이 영역은 흰색 배경, 검정 보고서명, 회색 날짜·제출인·구분선으로
구성하고 다른 강조색은 쓰지 마.

이 기간의 전체 공시 건수와 조회 기간을 함께 적고, 전체 목록으로 들어갈
수 있는 길을 만들어줘.

공시가 없거나 OpenDART 요청이 실패한 경우를 구분해 알려줘. 공시 요청이
실패해도 기존 주가 화면은 그대로 볼 수 있게 해줘.

08수백 건은 나눠서 살펴봅니다

Claude Code·Codex에 입력실습

최근 공시에서 전체 공시 화면으로 이동하도록 만들 때

먼저 확인 · 최근 공시와 같은 회사·최근 1년 범위인지 확인합니다.

전체 공시 화면을 따로 만들어줘.

종목 상세의 「이 회사 관련 공시」와 같은 흰 카드, 검정 보고서명, 회색
구분선, 글자 간격을 유지해줘. 전체 화면에는 여기에 공시 유형 필터와 페이지
이동을 더해줘.

조회 기간은 최근 공시와 같은 최근 1년으로 맞추고, 그 기간의 공시는 하나도
빼지 말고 모두 보여줘.

한 화면에 수백 건을 모두 쌓지 말고 한 페이지에 100건씩, OpenDART가
제공하는 페이지 정보에 맞춰 나눠 보여줘.

접수일, 보고서명, 제출인, 비고를 표시하고, 보고서명을 누르면 실제 DART
원문이 새 창에서 열리게 해줘.

09공시 유형으로 좁혀 봅니다

Claude Code·Codex에 입력실습

전체 목록을 보존하면서 공식 공시 유형으로 좁혀볼 때

먼저 확인 · 전체 공시 페이지와 실제 목록을 확인합니다. 제목으로 임의 분류하지 않습니다.

최근 1년 공시는 목록에서 하나도 빼지 말고 모두 보존해줘.

공시를 좁혀 볼 때는 OpenDART의 공식 공시 유형을 사용하고, Claude가
제목을 보고 중요도를 판단하거나 새로운 분류를 만들지 마.

각 유형의 실제 건수를 함께 보여줘.

10차트에는 두 유형만 표시합니다

Claude Code·Codex에 입력실습

주가 차트 아래에 정기공시·주요사항보고 시점을 연결할 때

먼저 확인 · 최근 1년 가격 차트와 공식 공시 유형을 확인합니다.

최근 1년 주가 차트에 공시 시점을 표시해줘.

전체 공시는 목록에 모두 보존하고, 차트에는 OpenDART 공식 공시 유형
가운데 정기공시와 주요사항보고만 표시해줘.

AI가 중요도를 판단하거나 순위를 매기지 않았다는 기준도 화면에 밝혀줘.

가격 차트를 가리지 않도록 공시 시점은 차트 아래의 별도 띠에 표시해줘.
휴장일 공시는 그 뒤 첫 거래일 위치에 묶고, 표식을 누르면 접수일·공시
유형·제출인·보고서명과 DART 원문 링크를 글자로 확인할 수 있게 해줘.

11화면에서 DART 원문까지 확인합니다

Claude Code·Codex에 입력실습

최근·전체·차트의 공시에서 실제 DART 원문 접근을 확인할 때

먼저 확인 · 실제 공시 접수번호와 연결한 회사·날짜를 확인합니다.

모든 공시의 접수번호로 실제 DART 원문 주소를 만들어줘.

보고서명을 누르면 원문이 새 창에서 열리게 하고, 링크 모양만 확인하지
말고 실제로 접근되는지도 검사해줘.

12새로 붙인 공시 기능을 확인합니다

Claude Code·Codex에 입력실습

추가한 공시 전체 흐름과 기존 9장 기능을 검사할 때

먼저 확인 · 회사 매핑·최근/전체 목록·공식 유형·페이지·차트 표식·원문 연결을 확인합니다.

이번 장에서 추가한 공시 기능을 Test해줘.

SK하이닉스 종목코드와 OpenDART 고유번호 연결, 공시 응답 처리, 최근
공시와 전체 목록, 공식 유형 필터, 여러 페이지 이동을 확인해줘.

같은 날짜의 여러 공시가 사라지지 않는지, 공시가 없는 경우와 API 오류를
구분하는지도 확인해줘.

차트에는 정기공시와 주요사항보고만 표시되는지, DART 원문 링크가 실제로
열리는지, API Key가 브라우저에 노출되지 않는지도 검사해줘.

9장에서 만든 검사도 함께 다시 돌려줘. 공시가 붙으면서 기존 검사가 깨지지
않았는지 확인하고, 깨졌다면 원인을 찾아 고쳐줘.

13새로 붙인 공시 기능을 확인합니다

Claude Code·Codex에 입력실습

공시 기능과 기존 화면을 확인한 뒤 로컬 정상 기록을 남길 때

먼저 확인 · 실제 공시·원문·브라우저와 Test 결과를 구분합니다. 이번 정본은 GitHub 전송을 명시적으로 금지합니다.

이번 작업을 마무리해줘.

GitHub에 보내지는 말고 Git 기록까지만 해줘.

14이 장을 마쳤는지 확인합니다

Claude Code·Codex에 입력튜터 요청

10장의 실습 결과를 장별 완료 조건과 대조할 때

먼저 확인 · 앞 단계 실행 결과와 사람이 직접 확인할 항목을 확인합니다. 요청문을 보여주거나 실행했다고 완료로 세지 않습니다.

장 완료 확인해줘.

이 장에서 막혔을 때

디버깅 → 내 정상 기록으로 복구 → 장별 Source로 재시작

Git 명령을 외우거나 직접 입력할 필요는 없습니다. 아래 요청문을 그대로 붙여넣으면 Claude Code가 확인하고 처리합니다.

1. 디버깅 --- 먼저 무엇이 어긋났는지 그대로 말하고 고쳐봅니다. 대부분 여기서 해결됩니다.

지금 작업이 책과 다르게 진행됐어.
현재 상태와 화면에 나온 문제를 확인하고 원인을 찾아서 고쳐줘.

공시 조회가 되지 않을 때는 인증키 문제와 조회 결과가 0건인 것을 먼저 갈라야 합니다. OpenDART는 이 둘을 서로 다른 상태 코드로 알려줍니다.

공시 조회가 안 돼.
OpenDART가 돌려준 상태 코드를 확인해서 결과가 0건인 경우와 실제 오류를 구분해줘.
실제 인증키 값은 출력하지 마.

주가 차트와 공시 목록의 기간이 어긋나면 같은 화면에서 두 자료를 나란히 읽을 수 없습니다.

주가 차트와 공시 목록의 조회 기간이 서로 달라.
두 화면이 같은 최근 1년을 조회하고 있는지 확인해서 맞춰줘.

종목코드로 회사를 찾지 못하는 경우도 있습니다. OpenDART는 주식 화면의 종목코드와 다른 고유번호를 사용합니다.

종목코드로 OpenDART 회사를 찾지 못해.
OpenDART 회사 고유번호 자료를 기준으로 종목코드와 고유번호가 연결되는지 확인해줘.

2. 내 정상 기록으로 복구 --- 해결되지 않으면 실습하면서 내 프로젝트에 남겨둔 정상 기록으로 돌아갑니다. 지금까지 한 작업은 먼저 따로 보존합니다.

현재 작업은 잃지 않도록 먼저 별도로 보존해줘.
이 프로젝트에서 마지막으로 정상 동작했던 상태를 찾아 안전하게 복구해줘.

3. 장별 Source로 재시작 --- 그래도 이어갈 수 없을 때 사용합니다. 10장의 남은 실습은 건너뛰게 되므로 마지막 수단입니다.

내 현재 작업을 먼저 안전하게 보존해줘.
아래 10장 완성 Source에서 다시 시작해줘.
https://github.com/buildyourownai-lab/develop-like-a-pro-with-ai/tree/main/chapters/ch10/source/ai-stock-briefing
내 인증키를 입력할 자리를 알려주고
준비가 끝나면 10장을 마친 상태인지 확인해줘.

방향부터 확인하고, 더 필요할 때 다음 힌트를 펼치세요.

종목은 있는데 공시 조회 실패

1단계 — 방향

두 서비스에서 회사를 부르는 코드가 다른지 봅니다.

2단계 — 범위

종목코드와 기업 고유코드의 대응을 확인합니다.

3단계 — 위치·원인 후보

매핑 결과와 요청 기간·공시 유형·오류 응답을 나눕니다.

정답을 요청했을 때

공식 매핑으로 확인한 코드만 쓰고 후보를 추측하지 않습니다. 응답 성공의 0건이면 정상 빈 목록으로 표시합니다.

검증 주의

이 설명만으로 원인이 확인됐거나 수정됐다고 말하지 않습니다. 현재 프로젝트의 근거를 먼저 대조합니다.

공시 이후 주가가 올랐음

1단계 — 방향

시간상의 인접과 원인 설명은 다릅니다.

2단계 — 범위

표시된 공시 날짜와 차트 기간부터 맞춥니다.

3단계 — 위치·원인 후보

원문이 실제로 어떤 사실을 공시했는지 확인합니다.

정답을 요청했을 때

확인된 시간과 내용까지만 설명하고 상승 원인·투자 추천으로 확장하지 않습니다.

검증 주의

이 설명만으로 원인이 확인됐거나 수정됐다고 말하지 않습니다. 현재 프로젝트의 근거를 먼저 대조합니다.

디버깅 → 정상 기록 복구 → 장별 소스로 재시작 →

이번 장의 완료 체크리스트

DART 준비OpenDART 인증키와 안전한 입력 위치 확인
기업 식별종목코드와 고유 기업코드 매핑 확인
공시 목록조회 기간·최근·전체 공시를 구분
유형 필터공식 공시 유형으로 범위를 선택
원문·마커같은 공시의 원문과 날짜를 연결
0건·회귀공시 없음과 조회 실패 및 기존 기능 확인

장 완료 확인해줘.

실제 프로젝트에서 튜터와 확인합니다. 사이트를 열어본 기록은 학습 완료가 아닙니다.

장별 소스와 저자 검증 기록

저자는 9장을 끝낸 상태에서 10장 요청문만으로 최근 공시와 전체 공시, 공식 유형, 차트의 공시 시점, DART 원문까지 갔습니다. 프로젝트 전체 Test 48개가 통과했고 그중 25개가 이 장에서 새로 생겼습니다. 실제 OpenDART 응답에서 SK하이닉스의 최근 1년 공시 477건을 확인하고, 이 건수가 100건씩 5페이지로 나뉘는 것과 공식 유형별 건수의 합이 전체 건수와 같은 것도 확인했습니다. 근거는 verification/chapter-10/에 있습니다.

10장 완성 소스 ↗저자 검증 상세 기록 ↗

장별 소스는 해당 장까지의 기준 상태입니다. 정상 실습은 내 프로젝트를 이어가고, 완성 소스는 비교·복구할 때 사용합니다.

자료 판본 1c784213

이 장의 개발 용어

API: 프로그램이 다른 서비스와 정해진 방식으로 요청·응답을 주고받는 연결 방법.
API Key: 서비스 사용 자격을 확인하는 값. 안전한 입력 위치에 직접 넣으며 값은 공개하지 않습니다.
Test: 정한 완료 조건을 반복 확인하는 검사. 검사하지 않은 전체 정확성을 보증하지 않습니다.

튜터 사용 안내 실습 자료 업데이트

지금 OpenDART 인증키 신청 화면에 있어. 개인으로 이 책의 주식 공시 실습에 사용할 API Key를 신청하려고 해. 화면에서 내가 직접 입력하거나 선택해야 하는 항목을 하나씩 알려줘.

OpenDART API Key를 발급받았어. 실제 키가 코드나 Git, 사용자의 브라우저에 노출되지 않게 안전하게 사용할 수 있도록 준비해줘. 실제 키 값은 내가 직접 입력할게. 어디에 입력하면 되는지만 알려줘.

방금 입력한 OpenDART API Key가 코드나 Git에 포함되지 않는지 확인해줘. 사용자의 브라우저에도 노출되지 않게 되어 있는지 확인해줘. 실제 키 값 자체는 화면에 출력하지 마.

지금 만든 SK하이닉스 상세 화면에 최근 공시를 연결해줘. 조회 기간은 앞에서 만든 주가 차트와 같은 최근 1년으로 맞춰줘. 금융감독원 OpenDART에서 회사가 실제로 제출한 자료를 가져오고, 접수일, 보고서명, 제출인과 DART 원문 링크를 보여줘. 공시가 주가 움직임의 원인이라고 해석하거나 투자 의견을 만들지는 마.

주식 화면의 여섯 자리 종목코드로 OpenDART 회사를 찾게 해줘. OpenDART 회사 고유번호 자료를 기준으로 연결하고, 이름이 비슷하다는 이유로 임의의 회사를 선택하지 마. SK하이닉스 `000660`이 어떤 고유번호로 연결되는지도 실제 자료로 확인해줘.

SK하이닉스 상세 화면에는 최근 공시 5건만 먼저 보여줘. 영역 제목은 「이 회사 관련 공시」로 적어줘. 각 공시는 접수일, 보고서명, 제출인을 위에서 아래로 읽는 구분선 목록으로 만들고, 보고서명은 검정색으로 보여줘. 이 영역은 흰색 배경, 검정 보고서명, 회색 날짜·제출인·구분선으로 구성하고 다른 강조색은 쓰지 마. 이 기간의 전체 공시 건수와 조회 기간을 함께 적고, 전체 목록으로 들어갈 수 있는 길을 만들어줘. 공시가 없거나 OpenDART 요청이 실패한 경우를 구분해 알려줘. 공시 요청이 실패해도 기존 주가 화면은 그대로 볼 수 있게 해줘.

전체 공시 화면을 따로 만들어줘. 종목 상세의 「이 회사 관련 공시」와 같은 흰 카드, 검정 보고서명, 회색 구분선, 글자 간격을 유지해줘. 전체 화면에는 여기에 공시 유형 필터와 페이지 이동을 더해줘. 조회 기간은 최근 공시와 같은 최근 1년으로 맞추고, 그 기간의 공시는 하나도 빼지 말고 모두 보여줘. 한 화면에 수백 건을 모두 쌓지 말고 한 페이지에 100건씩, OpenDART가 제공하는 페이지 정보에 맞춰 나눠 보여줘. 접수일, 보고서명, 제출인, 비고를 표시하고, 보고서명을 누르면 실제 DART 원문이 새 창에서 열리게 해줘.

최근 1년 공시는 목록에서 하나도 빼지 말고 모두 보존해줘. 공시를 좁혀 볼 때는 OpenDART의 공식 공시 유형을 사용하고, Claude가 제목을 보고 중요도를 판단하거나 새로운 분류를 만들지 마. 각 유형의 실제 건수를 함께 보여줘.

최근 1년 주가 차트에 공시 시점을 표시해줘. 전체 공시는 목록에 모두 보존하고, 차트에는 OpenDART 공식 공시 유형 가운데 정기공시와 주요사항보고만 표시해줘. AI가 중요도를 판단하거나 순위를 매기지 않았다는 기준도 화면에 밝혀줘. 가격 차트를 가리지 않도록 공시 시점은 차트 아래의 별도 띠에 표시해줘. 휴장일 공시는 그 뒤 첫 거래일 위치에 묶고, 표식을 누르면 접수일·공시 유형·제출인·보고서명과 DART 원문 링크를 글자로 확인할 수 있게 해줘.

모든 공시의 접수번호로 실제 DART 원문 주소를 만들어줘. 보고서명을 누르면 원문이 새 창에서 열리게 하고, 링크 모양만 확인하지 말고 실제로 접근되는지도 검사해줘.

이번 장에서 추가한 공시 기능을 Test해줘. SK하이닉스 종목코드와 OpenDART 고유번호 연결, 공시 응답 처리, 최근 공시와 전체 목록, 공식 유형 필터, 여러 페이지 이동을 확인해줘. 같은 날짜의 여러 공시가 사라지지 않는지, 공시가 없는 경우와 API 오류를 구분하는지도 확인해줘. 차트에는 정기공시와 주요사항보고만 표시되는지, DART 원문 링크가 실제로 열리는지, API Key가 브라우저에 노출되지 않는지도 검사해줘. 9장에서 만든 검사도 함께 다시 돌려줘. 공시가 붙으면서 기존 검사가 깨지지 않았는지 확인하고, 깨졌다면 원인을 찾아 고쳐줘.

내 현재 작업을 먼저 안전하게 보존해줘. 아래 10장 완성 Source에서 다시 시작해줘. https://github.com/buildyourownai-lab/develop-like-a-pro-with-ai/tree/main/chapters/ch10/source/ai-stock-briefing 내 인증키를 입력할 자리를 알려주고 준비가 끝나면 10장을 마친 상태인지 확인해줘.