SEC EDGAR — 공개 기업 공시

미국 증권거래위원회(SEC)의 공시 데이터베이스입니다. 미국의 모든 공개 기업이 여기에 공시하며, 모든 공시는 타임스탬프가 찍히고 변경 불가능하며, 모든 정보(수익, 부채, 위험 요인, 임원 보상, M&A 활동, 내부자 거래)는 기계가 읽을 수 있도록 구조화되어 있습니다. 무료이며 권위 있는 데이터입니다.

Pipeworx의 일부 — AI 에이전트를 1476개 이상의 실시간 데이터 소스에 연결하는 MCP 게이트웨이입니다.

AI 에이전트에게 중요한 이유

에이전트가 미국 공개 기업에 관한 어떤 질문(재무, 법적 노출, 지적 재산, 임원 교체, 최근 중요 사건)에 답해야 한다면, 그 답은 EDGAR에 있습니다. 데이터는 구조화되어 있으므로(XBRL) PDF를 파싱할 필요가 없습니다.

두 가지 핵심 흐름:

1. 공시 흐름. "애플의 최근 10-Q를 보여줘." → edgar_ticker_to_cik("AAPL") → edgar_company_filings(cik) → 접수번호, 양식 유형, 제출 날짜가 포함된 공시 목록.

2. 개념 흐름. "애플의 지난 4분기 수익 추세는 어땠나?" → edgar_company_concept(cik, "Revenues") → 기간별 XBRL 태그 값의 시계열.

둘 다 일반적으로 edgar_ticker_to_cik 또는 resolve_entity({type: "company", value: "AAPL"})로 표준 10자리 CIK를 얻는 것으로 시작합니다.

Related MCP server: SEC EDGAR MCP Server

인증

없음. SEC EDGAR는 무료, 공개, 인증 불필요 서비스입니다. Pipeworx는 SEC의 API 지침을 준수하기 위해 정중한 User-Agent 헤더를 전달합니다.

인용 가능한 URI

pipeworx://edgar/company/{cik}/filings
pipeworx://edgar/company/{cik}/facts

출력에 포함하세요. 조직 개편에도 안정적입니다 — 기업이 리브랜딩해도 CIK는 변하지 않습니다.

알아두면 유용한 양식 유형

내부자 거래에 대해서는 전용 insider-trading 팩을 참조하세요 — Form 4 / 13D / 13G 변경 사항을 더 깔끔한 스키마로 제공합니다.

흔한 함정

• 개념 이름 변경. SEC 제출자가 수익에 태그하는 XBRL 개념을 가끔 변경합니다. 기본 Revenues 개념은 최근 회계연도에 대해 오래되었을 수 있습니다. 대안으로 RevenueFromContractWithCustomerExcludingAssessedTax를 시도하세요.

• 기간 불일치. 회계연도 종료 시점은 기업마다 다릅니다(애플 = 9월, 마이크로소프트 = 6월, 구글 = 12월). 비교할 때는 항상 기간을 명시하세요.

• CIK 형식. 일부 엔드포인트는 10자리로 앞자리 0을 채운 형식(0000320193)을 원하고, 일부는 채우지 않은 형식(320193)을 원합니다. Pipeworx는 둘 다 허용합니다. edgar_ticker_to_cik의 cik_padded 필드는 리소스 URI의 표준 형식입니다.

• 실시간에 가깝지, 실시간은 아님. 공시는 제출 후 몇 분 내에 EDGAR에 나타나지만, Pipeworx는 결과를 캐시합니다. 속보 수준의 신속함이 필요하면 Cache-Control: no-cache를 설정하거나(익명 제한 적용) _meta.cache.fresh_until 필드를 확인하세요.

• 개념 가용성 차이. 소규모 제출자는 대기업보다 적은 XBRL 개념을 태그합니다. edgar_company_concept는 기업이 보고하지 않는 유효한 개념에 대해 빈 배열을 반환할 수 있습니다. 기업이 실제로 보고하는 개념을 보려면 edgar_company_facts를 사용하세요.

빠른 시작

MCP 클라이언트(Claude Desktop, Cursor, Windsurf 등)에 추가하세요:

{
  "mcpServers": {
    "edgar": {
      "url": "https://gateway.pipeworx.io/edgar/mcp"
    }
  }
}

이 엔드포인트가 실제로 제공하는 것

https://gateway.pipeworx.io/edgar/mcp의 tools/list는 위 표의 도구 및 공유 Pipeworx 메타 도구 — ask_pipeworx, discover_tools, search_within, remember/recall 및 게이트웨이 전체 세트의 나머지 — 를 반환합니다. 따라서 표시되는 도구 수는 이 표보다 많습니다. 단일 팩 엔드포인트는 현재 팩 자체 도구와 함께 약 30개의 공유 도구를 나열합니다. 연결의 initialize 응답은 정확한 범위를 명시하며, 특정 날짜의 권위 있는 답변입니다.

이는 우연한 멀티플렉싱이 아니라 의도된 것입니다. 메타 도구는 범위가 제한된 연결이 이 팩이 다루지 않는 질문에 답할 수 있게 해줍니다 — 전체 카탈로그를 라우팅하는 ask_pipeworx를 통해 — 두 번째 MCP 서버를 추가하지 않고도 말입니다. 현재 팩 엔드포인트를 메타 도구 없이 마운트할 방법은 없습니다. 추가 스키마가 라우팅 가치보다 더 많은 컨텍스트를 소비한다면, 여러 팩 엔드포인트에 연결하는 대신 전체 게이트웨이에 한 번 연결하세요.

또는 전체 Pipeworx 게이트웨이에 연결하여 이 팩의 도구만 직접 나열하는 대신 모든 팩의 도구를 직접 나열할 수 있습니다:

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

두 URL 모두 동일한 게이트웨이와 동일한 1476개 이상의 데이터 소스에 도달합니다. 유일한 차이점은 어떤 팩의 도구가 직접 나열되는지입니다. ask_pipeworx 는 어느 쪽에서든 모든 도구에 도달합니다.

ask_pipeworx와 함께 사용하기

도구를 직접 호출하는 대신 평문 영어로 질문할 수 있습니다 — 이는 위의 팩 엔드포인트와 전체 게이트웨이 모두에서 작동합니다:

ask_pipeworx({ question: "your question about Edgar data" })

게이트웨이가 적절한 도구를 선택하고 인수를 자동으로 채웁니다.

더 보기

• 문서 및 가이드

• pipeworx.io

라이선스

MIT