SEC EDGAR 조회 항목 — 미국공시 수집기 기능설명

하는 일

미국 증권거래위원회(SEC)가 공개한 EDGAR 오픈 API 를 화면에서 골라 조회하고, 그 결과를 엑셀로 내보냅니다. 미국 상장사의 공시·재무·내부자거래·기관보유내역을 한자리에서 꺼내 씁니다.

실행 파일 하나로 동작하며 설치할 것이 없습니다. SEC는 API 키를 발급하지 않으므로 키도 필요 없고, 처음 한 번 이름과 이메일을 연락처로 넣습니다. 조회 결과는 이 PC 밖으로 나가지 않습니다.

화면 규칙은 자매품 공시 수집기와 같게 맞췄습니다. 좌측 목록, 요청 인자 카드, 결과 표, 내보내기 자리에 색과 첫 화면 배치까지 같으므로 두 도구를 번갈아 써도 다시 익힐 것이 없습니다. 첫 화면에서 데이터 출처·라이선스 및 고지 를 시작하기 전에 바로 열어 볼 수 있습니다.

넣는 것

왼쪽이 두 단으로 나뉩니다. 작업 탭은 업무 단위 12가지, 엔드포인트 탭은 SEC가 주는 것을 원본 그대로 22종입니다. 작업 탭이 가리는 것이 없도록 둘 다 두었습니다.

작업 12가지

작업별 쓰임

괄호 안은 쓰는 작업 번호입니다.

엔드포인트 22종

조건 입력

이름이 기억나지 않으면 검색창에 재무, 내부자, frames 처럼 치면 걸립니다. 작업을 고르면 그 작업이 쓰는 엔드포인트가 열리고 필요한 요청 인자만 화면에 나옵니다. 항목 옆 ⓘ 에 마우스를 올리면 그것이 무엇을 주는지 설명이 뜹니다. 요청 인자는 한글 이름 + SEC 인자명 + 필수·선택 으로 적고 (시작일 startdt), 뜻이 갈리는 칸에는 ! 를 달아 설명을 붙였습니다.

회사 · 제출물 지정

회사는 이름 두 글자만 쳐도 후보가 알약으로 뜨고, 담으면 CIK 로 풀어 줍니다. 하나 담아도 후보 목록이 남아 여러 곳을 이어 담을 수 있습니다. 제출물은 접수번호를 몰라도 됩니다 — 칸을 비워 두면 조회 가 제출물 고르기 가 되고, 넣은 회사가 낸 것을 서식별로 걸러 여러 건 담을 수 있습니다. 회사마다 최신 1건 담기 로 한 번에 채울 수도 있습니다.

접수번호로 시작하는 작업 (5·6·11·12)

작업 5·6·11·12 는 접수번호 하나로 시작해 그 안의 파일을 읽는다는 점이 같습니다. 그래서 창도 흐름도 하나로 두고, 담은 제출물의 서식으로 무엇으로 펼지 고릅니다 — 3·4·5 는 거래표로, 13F 는 보유내역표로, 그 밖은 제출서류 표로. 작업마다 서식이 미리 걸려 있어(6→10-K, 11→4, 12→13F-HR) 회사만 넣으면 곧바로 고를 수 있습니다.

결과

엑셀 내보내기 (.xlsx) 를 누르면 저장 위치를 고르는 대화상자가 뜨고 파일이 만들어집니다. 확장자만 바꾼 CSV 가 아닙니다.

결과 표

표에서 결과 내 검색으로 걸러 보고, 열 고르기로 필요한 열만 남깁니다 — 숨긴 열은 엑셀에도 나가지 않습니다. 화면에는 500행만 그리지만 엑셀에는 조회한 전체 행이 들어갑니다. accn 열이 있는 결과에는 edgar_url 열이 자동으로 붙어, 눌러서 EDGAR 원문을 바로 확인할 수 있습니다.

엑셀 파일

시트 이름 31자 제한

엑셀 파일 형식은 시트 이름을 31자까지만 받습니다. 넓힐 수 있는 값이 아닙니다. 잘린 이름끼리 서로 겹치기 쉽습니다 — SEC 의 표 이름은 앞머리가 길고 서로 같습니다.

시트 이름 짓는 순서

잘린 시트 이름과 1행 제목

줄임말과 … 로도 원래 이름이 다 담기지 않을 때가 있습니다. 그래서 시트 1행에 전체 이름을 적고, 표 제목에 단위 표기가 있으면 함께 붙입니다 — AAPL24 Consolidated Financial Statement Details — … $ in Millions. 머리글은 2행, 값은 3행부터 시작하고 틀고정과 자동 필터도 함께 내려갑니다.

한 권 안에서는 모양을 맞춥니다. 잘린 시트가 하나라도 있으면 모든 시트에 1행 제목이 붙습니다 — 시트마다 값이 몇 행부터인지 갈리면, 시트를 옮겨 다닐 때마다 그것을 다시 확인해야 합니다. 잘린 이름이 하나도 없으면 1행 제목도 붙지 않고 예전과 똑같이 머리글이 1행입니다.

세부 규칙

제출서류 표 뽑기 (작업 6)

XBRL API 에는 사업부문별·제품별 수치가 없습니다. 애플의 iPhone·Mac·서비스별 매출은 companyfacts 로 얻을 수 없습니다 — 차원(세그먼트) 정보가 실려 오지 않기 때문입니다. 제출서류에 든 표를 뽑아 엑셀 한 권으로 묶는 이 기능이 그것을 얻는 경로입니다.

제출본을 여러 건 걸 때

표는 첫 제출본에서 한 번만 고르고, 나머지 제출본에서는 같은 이름의 표를 찾아 함께 뽑습니다. 번호로 맞출 수 없기 때문입니다 — 애플의 세그먼트 상세는 2024년 10-K 에서 R58, 2025년에서는 R68 입니다.

같은 회사의 다른 해는 대부분 따라옵니다 — 애플 10-K 2025(71개)와 2024(74개)를 맞추면 68개. 회사가 다르면 이름이 겹치는 표만 따라옵니다(애플·알파벳은 20개). 여러 회사를 한 번에 걸면 연도 비교가 되지 않고 표를 단순히 한 권에 합칩니다.

표 값 읽기

SEC가 화면에 보여 주려고 만든 표라서 사람이 읽기 좋게 가공된 값이 들어 있습니다. 그대로 가져오면 숫자가 아니거나 자릿수가 틀립니다.

틀린 값이 나오기 쉬운 자리

아래는 SEC 자료의 성질입니다. 이 프로그램이 처리해 두었지만, 다른 도구로 같은 자료를 다룰 때도 그대로 해당됩니다.

중복 신고분

분기·연간 보고서는 전년 동기 비교치를 함께 신고합니다. 그래서 같은 기간의 같은 값이 여러 제출본에 실려 옵니다. 애플의 매출 태그는 117행이 오는데 실제 기간은 57개뿐입니다. 그대로 더하면 매출이 두 배가 됩니다. 이 프로그램은 (tag, unit, start, end) 가 같으면 하나로 줄입니다.

fy · fp 로 기간 거르기

이 두 열은 그 값이 실린 보고서의 회계연도·분기입니다. 값 자체의 기간이 아닙니다. 실제로 애플의 FY2025 3분기 매출에 fy=2026, fp=Q3 이 붙어 있습니다. 기간은 반드시 start·end 로 거르세요. 이 프로그램의 기간 입력도 그렇게 만들었습니다.

전종목 단면(frames)의 기준일

CY2024Q1I 로 조회하면 SEC가 캘린더에 가깝게 맞춰 주지만, 결산월이 다른 회사는 기준일이 다릅니다. 애플은 9월 결산이라 2024-03-30 으로 들어옵니다. 그래서 end 열을 항상 보여 줍니다. 그리고 4,605곳만 들어옵니다 — 티커 보유사 약 1만의 절반 이하입니다.

인덱스 세 가지의 열 순서

master·form·company 는 같은 제출 기록이고 정렬과 줄 모양만 다릅니다. 그런데 company 는 회사명이 서식보다 앞에 오므로, 그대로 읽으면 두 열이 뒤바뀝니다. 이 프로그램은 파일 첫 줄(Description: … by Company Name)을 읽어 가르므로 어느 것을 골라도 결과 표의 열 이름은 같습니다.

3표 조립의 범위

회사마다 같은 계정에 다른 태그를 씁니다. 애플에 Revenues 를 물으면 11행만 옵니다 — 애플이 쓰는 태그는 RevenueFromContractWithCustomerExcludingAssessedTax 입니다. 그래서 계정마다 후보 태그를 순서대로 두고 값이 있는 첫 태그를 씁니다. 회사가 중간에 태그를 바꿨으면 연도마다 값이 있는 태그로 채워, 과거 연도가 빈칸이 되지 않습니다. 연간 재무상태표에는 회계연도 말 잔액만 담고 분기말 잔액은 섞지 않습니다. 값마다 단위는 unit 열에 남습니다. 다만 세그먼트는 나오지 않습니다 — 그것은 작업 6 의 몫입니다.

속도와 캐시

SEC 상한은 초당 10건이고 “쓰는 기계 수와 무관한 합산 한도” 라서 초당 8건으로 여유를 두었습니다. 제한을 만나면(403·429) 돌고 있는 모든 요청이 함께 2→5→10→20→40→60초로 쉬며 다시 시도하고, 남은 시간을 화면에 보여 줍니다. SEC 가 기다릴 시간을 알려 주면 그것을 따릅니다. 끝내 풀리지 않으면 약 10분 뒤 다시 하라고 알립니다 — SEC 의 차단은 보통 그만큼 갑니다.

요청 로그

조회 중 오류가 나면 결과 아래 요청 로그 에 어떤 조건에서 무슨 코드가 났는지 남습니다.

하지 않는 것 · 한계

자료가 오가는 곳

조회는 data.sec.gov, www.sec.gov, efts.sec.gov 세 곳으로만 나갑니다. 중계 프록시·분석도구·외부 글꼴·CDN을 일절 쓰지 않습니다. 받아 온 결과와 엑셀 파일은 이 컴퓨터에서 만들어져 지정한 위치에 저장되며, 업로드되는 경로가 없습니다. 파일은 끝까지 쓴 뒤에 바꿔 넣으므로, 저장이 도중에 실패해도 원래 파일이 남습니다.

버전 확인

조회 말고 켤 때 한 번은 kongsist.com/version.json 으로 갑니다. 받아오는 것은 버전 번호뿐이고 연락처도 조회 결과도 실리지 않으며, 실패하면 조용히 넘어갑니다. 새 버전이 나와 있으면 버전 표시가 붉은 새 버전 있음 으로 바뀌고, 누르면 홈페이지가 기본 브라우저에서 열립니다. 최신이면 최신 버전입니다 로 적힙니다. 확인하지 못했으면 배지가 나오지 않습니다 — 확인하지 못한 것을 최신인 양 보여 주지 않습니다. 가는 주소는 받아온 내용을 믿지 않고 프로그램 안에 고정해 두었습니다 — 배포처가 남의 손에 넘어가도 링크가 엉뚱한 곳을 가리킬 수 없습니다.

자주 묻는 것

이 프로그램을 남에게 줘도 되나요?

됩니다. 고치지 않은 채로 그대로 넘겨주는 것은 자유입니다. 다만 어떤 보증도 하지 않습니다. exe 하나만 주면 됩니다 — 프로그램에 들어간 오픈소스 248개의 고지와 라이선스 원문이 프로그램 안에 들어 있습니다. 좌측 아래 라이선스 및 고지 에서 전체 목록·라이선스 원문 보기 를 누르면 볼 수 있습니다.