EDGAR Answers — AI 에이전트용 SEC 서류

에이전트에게 원시 API 응답이 아닌 SEC EDGAR의 답변을 제공합니다.

이 저장소는 호스팅형 MCP 서버에 대한 문서와 레지스트리 매니페스트를 담고 있습니다. 설치하거나 실행할 것은 없습니다. 아래 엔드포인트에 어떤 MCP 클라이언트에서든 연결하면 됩니다. 서버 자체는 관리형 서비스로 운영됩니다.

모든 미국 상장 기업은 재무제표를 SEC에 XBRL 형식으로 무료로 제출합니다. 문제는 "무료이고 공개적"이라는 것이 "바로 쓸 수 있다"는 의미는 아니라는 점입니다. 기업들은 같은 항목을 십여 가지 방식으로 태그하고, 연간 및 분기 수치가 같은 스트림에 섞여 있으며, 재작성(restatement)은 조용히 이력을 덮어쓰고, Form 4 내부자 거래 서류는 원시 XML로 도착합니다. 기존 EDGAR MCP 서버들은 에이전트에게 그 엉망을 그대로 넘기고 행운을 빕니다.

이 서버는 파싱을 먼저 수행합니다. 에이전트가 매출을 요청하면, 매출을 받습니다.

도구

get_financials — 표준화된 연간 재무제표

미국 상장 기업의 다년도 손익계산서, 대차대조표, 현금흐름표를 티커 또는 CIK로 제공합니다.

get_financials(company: "AAPL", years: 4)
→ revenue, grossProfit, operatingIncome, netIncome, epsDiluted,
  operatingCashFlow, capex, totalAssets, totalLiabilities,
  stockholdersEquity, cashAndEquivalents, longTermDebt, sharesDiluted
  — one clean row per fiscal year

그 뒤에는 항목별 정렬된 태그 폴백 체인(제출자마다 매출을 의미하는 us-gaap 태그가 다름), 연간 수치가 분기 누적치에 오염되지 않도록 하는 기간 필터링, 가장 최근에 제출된 값으로의 재작성 해결이 있습니다. 보고되지 않은 항목은 추측 대신 null로 반환됩니다.

filing_diff — 전년 대비 변경 사항

filing_diff(company: "NVDA", section: "risk_factors")
→ paragraphs added and removed between the two most recent 10-Ks

애널리스트가 실제로 묻는 질문 — 올해 무엇을 새로 말하기 시작했고, 무엇을 조용히 뺐는가? — 을 문단 수준에서 답하며, 단순히 줄바꿈만 바뀐 정형 문구는 걸러냅니다.

insider_activity — Form 4, 파싱 완료

insider_activity(company: "MSFT", filings: 10)
→ who, role, transaction type, shares, price, holdings after — tidy rows

공개 시장 매수는 세금 원천징수와 스톡옵션 행사와 분리되므로, 에이전트가 예정된 베스팅을 확신에 찬 매수로 오인하지 않습니다.

filing_section — 모든 섹션을 깨끗한 텍스트로

filing_section(company: "TSLA", section: "risk_factors" | "mdna" | "business" | "1A")

목차용 미끼 항목은 걸러지고, 실제 섹션 본문을 받을 수 있습니다.

search_filings — 2001년 이후 전문 검색

search_filings(query: "\"supply chain disruption\"", forms: "10-K", startDate: "2025-01-01")

Related MCP server: FinImpulse MCP Server

연결

Streamable HTTP 엔드포인트:

https://aion-org--edgar-answers-mcp.apify.actor/mcp

Apify API 토큰을 bearer 토큰으로 인증하세요. MCP 클라이언트 구성에서:

{
  "mcpServers": {
    "edgar-answers": {
      "url": "https://aion-org--edgar-answers-mcp.apify.actor/mcp",
      "headers": { "Authorization": "Bearer YOUR_APIFY_TOKEN" }
    }
  }
}

stdio만 지원하는 클라이언트는 npx mcp-remote <url> --header "Authorization: Bearer YOUR_APIFY_TOKEN"로 브리지하세요.

서버는 대기 모드로 실행됩니다. 유휴 시 0으로 스케일링되고 첫 요청에 깨어나므로, 한산한 시간 이후의 첫 호출은 몇 초가 걸립니다.

요금

성공한 호출 건당 과금 — 실패한 호출은 청구되지 않습니다.

데이터 및 규정 준수

원본 데이터는 SEC EDGAR — 미국 정부 서류, 퍼블릭 도메인입니다. 요청은 선언된 User-Agent로 이루어지며, SEC가 게시한 접근 가이드라인에 따라 공식 상한선을 크게 밑도는 수준으로 속도가 제한됩니다. 여기서 금지하는 사이트를 스크래핑하는 일은 없습니다.

한계 — 명확히

• US GAAP 제출 기업. IFRS로 보고하는 외국 민간 발행인은 표준화된 재무제표를 반환하지 않으며, get_financials는 추측 대신 그 사실을 알려줍니다.

• 범위는 EDGAR를 따름. 전문 검색은 2001년까지 거슬러 올라가며, XBRL 재무 데이터는 대략 2009년부터 존재합니다.

• 투자 조언이 아님. 충실히 파싱된 서류 데이터일 뿐입니다. 그로부터 내리는 결론은 여러분의 몫입니다.

• filing_diff는 동일한 폼의 최근 두 건을 비교합니다. 임의의 서류 쌍 비교는 아직 지원되지 않습니다.

원하는 도구가 없거나 버그를 발견하셨나요? Apify Store의 액터 또는 여기에 이슈를 남겨주세요 — 특정 티커에 대한 구체적인 보고에 신속히 대응합니다.

Apify Store에 등록되어 있습니다. 이 저장소의 문서는 Aion이 저작권을 소유하며, 서비스는 독점(proprietary)입니다.