SEC EDGAR — Einreichungen öffentlicher Unternehmen

Die Einreichungsdatenbank der Securities and Exchange Commission. Jedes börsennotierte Unternehmen in den USA reicht hier ein, jede Einreichung ist mit Zeitstempel versehen und unveränderlich, und jede Offenlegung (Umsatz, Schulden, Risikofaktoren, Vergütung von Führungskräften, M&A-Aktivitäten, Insiderhandel) ist für den maschinellen Abruf strukturiert. Kostenlos und maßgeblich.

Teil von Pipeworx — einem MCP-Gateway, das KI-Agenten mit 1476+ Live-Datenquellen verbindet.

Warum das für KI-Agenten wichtig ist

Wenn Ihr Agent etwas über ein börsennotiertes US-Unternehmen beantwortet — Finanzdaten, rechtliche Risiken, geistiges Eigentum, Führungswechsel, aktuelle wesentliche Ereignisse — finden Sie die Antwort in EDGAR. Die Daten sind strukturiert (XBRL), sodass Sie keine PDFs parsen müssen.

Die zwei wichtigsten Abläufe:

1. Einreichungsablauf. „Zeig mir Apples letztes 10-Q." → edgar_ticker_to_cik("AAPL") → edgar_company_filings(cik) → Liste der Einreichungen mit Zugangsnummern, Formulartypen und Einreichungsdaten.

2. Konzeptablauf. „Wie war Apples Umsatztrend in den letzten 4 Quartalen?" → edgar_company_concept(cik, "Revenues") → Zeitreihe von XBRL-getaggten Werten über Zeiträume.

Beiden geht normalerweise edgar_ticker_to_cik oder resolve_entity({type: "company", value: "AAPL"}) voraus, um die kanonische 10-stellige CIK zu erhalten.

Related MCP server: SEC EDGAR MCP Server

Authentifizierung

Keine. SEC EDGAR ist ein kostenloser, öffentlicher Dienst ohne Authentifizierung. Pipeworx leitet einen höflichen User-Agent-Header weiter, um die API-Richtlinien der SEC einzuhalten.

Zitierbare URIs

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

Betten Sie diese in Ihre Ausgabe ein. Stabil über Umstrukturierungen hinweg — Unternehmen benennen sich um, aber ihre CIK ändert sich nicht.

Wissenswerte Formulartypen

Für Insiderhandel im Speziellen siehe das dedizierte insider-trading-Paket — es zeigt Form 4 / 13D / 13G-Änderungen mit saubereren Schemata an.

Häufige Fallstricke

• Konzeptnamensdrift. SEC-Einreicher ändern gelegentlich das XBRL-Konzept, das sie für Umsatz taggen. Das Standardkonzept Revenues kann für neuere Geschäftsjahre veraltet sein; versuchen Sie RevenueFromContractWithCustomerExcludingAssessedTax als Fallback.

• Zeitraumabweichungen. Geschäftsjahre enden bei verschiedenen Unternehmen zu unterschiedlichen Zeiten (Apple = Sept., Microsoft = Juni, Google = Dez.). Beim Vergleich immer den Zeitraum angeben.

• CIK-Formatierung. Einige Endpunkte erwarten eine mit Nullen aufgefüllte 10-stellige Zahl (0000320193), andere eine ohne Auffüllung (320193). Pipeworx akzeptiert beides; das Feld cik_padded in edgar_ticker_to_cik ist die kanonische Form für Ressourcen-URIs.

• Echtzeit-ähnlich, nicht Echtzeit. Einreichungen erscheinen innerhalb von Minuten nach der Übermittlung auf EDGAR, aber Pipeworx speichert Ergebnisse zwischen. Für Aktualität auf Nachrichtenniveau setzen Sie Cache-Control: no-cache (anonyme Begrenzung gilt) oder prüfen Sie das Feld _meta.cache.fresh_until.

• Verfügbarkeit von Konzepten unterscheidet sich. Kleinere Einreicher taggen weniger XBRL-Konzepte als große. edgar_company_concept kann leere Arrays für gültige Konzepte zurückgeben, die das Unternehmen einfach nicht meldet. Verwenden Sie edgar_company_facts, um zu sehen, welche Konzepte ein Unternehmen tatsächlich meldet.

Schnellstart

Fügen Sie zu Ihrem MCP-Client hinzu (Claude Desktop, Cursor, Windsurf usw.):

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

Was dieser Endpunkt tatsächlich bereitstellt

tools/list unter https://gateway.pipeworx.io/edgar/mcp gibt die Tools in der obigen Tabelle zurück plus die gemeinsamen Pipeworx-Meta-Tools — ask_pipeworx, discover_tools, search_within, remember/recall und den Rest des Gateway-weiten Satzes. Die Tool-Anzahl, die Sie sehen, ist also größer als diese Tabelle: Ein Einzelpaket-Endpunkt listet derzeit etwa 30 gemeinsame Tools neben den eigenen des Pakets auf. Die initialize-Antwort der Verbindung gibt den genauen Umfang an und ist die maßgebliche Antwort für einen bestimmten Tag.

Das ist beabsichtigt, kein versehentliches Multiplexing. Die Meta-Tools ermöglichen es einer eingeschränkten Verbindung, eine Frage zu beantworten, die dieses Paket nicht abdeckt — über ask_pipeworx, das über den gesamten Katalog routet — ohne dass Sie einen zweiten MCP-Server hinzufügen müssen. Es gibt derzeit keine Möglichkeit, einen Paket-Endpunkt ohne sie zu mounten; wenn die zusätzlichen Schemata mehr Kontext kosten, als das Routing wert ist, verbinden Sie sich einmal mit dem vollständigen Gateway, anstatt mit mehreren Paket-Endpunkten.

Oder verbinden Sie sich mit dem vollständigen Pipeworx-Gateway, um die Tools jedes Pakets direkt aufgelistet zu bekommen, anstatt nur die dieses einen:

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

Beide URLs erreichen dasselbe Gateway und dieselben 1476+ Datenquellen. Der einzige Unterschied besteht darin, welche Tools des Pakets direkt aufgelistet sind; ask_pipeworx erreicht alle von beiden aus.

Verwendung mit ask_pipeworx

Anstatt Tools direkt aufzurufen, können Sie Fragen in einfachem Englisch stellen — das funktioniert sowohl auf dem obigen Paket-Endpunkt als auch auf dem vollständigen Gateway:

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

Das Gateway wählt das richtige Tool aus und füllt die Argumente automatisch aus.

Mehr

• Dokumentation und Anleitungen

• pipeworx.io

Lizenz

MIT