미국공시 수집기 기능설명

「하고 싶은 일」로 들어가고, 필요하면 원본으로 내려갑니다

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

제출물에서 시작하는 넷은 한 흐름입니다

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

외워야 하는 번호가 없습니다

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

화면 규칙은 자매품 공시수집기와 같게 맞췄습니다. 좌측 목록, 요청 인자 카드, 결과 표, 내보내기 자리가 같으므로 두 도구를 번갈아 써도 다시 익힐 것이 없습니다.

제출서류에 든 표를 전부 뽑아 엑셀 한 권으로

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 입니다. 그래서 계정마다 후보 태그를 순서대로 두고 값이 있는 첫 태그를 씁니다. 다만 세그먼트는 나오지 않습니다 — 그것은 작업 6 의 몫입니다.

같은 것을 두 번 받지 않습니다

SEC 상한은 초당 10건이고 “쓰는 기계 수와 무관한 합산 한도” 라서 초당 8건으로 여유를 두었습니다. 제한을 만나면(403·429) 1→2→4→8→16초로 기다리며 다시 시도하고, 남은 시간을 화면에 보여 줍니다.

진짜 xlsx 로, 자릿수를 잃지 않고

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

시트 이름 — 31자 안에서 서로 구분되게

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

그래서 셋으로 나눠 처리합니다

잘린 시트에는 잘리지 않은 이름을 1행에 적습니다

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

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

무엇이 어디로 오가나

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

켤 때 한 번, 새 판이 나왔는지만 물어봅니다

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

무슨 일이 났는지 코드로 남깁니다

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

이 도구가 하지 못하는 것