Sec

@pipeworx/sec

米国の公開企業を対象としたSEC EDGARの企業検索、提出書類一覧、XBRL財務データです。認証キーは不要で、SEC独自のAPIから直接取得します。

Pipeworx の一部です。AIエージェントを1807以上の稼働中データソースにつなぐMCPゲートウェイです。これは独立した非公式の統合であり、上流プロバイダーとは提携しておらず、承認も受けておらず、公開もされていません。

ツール

• search_companies(query) — EDGARの全文検索で企業を検索し、CIK付きの一致する企業情報を返します。
• get_company_filings(cik, form_type?) — CIK、ティッカー、または企業名で指定した企業の最近の提出書類（10-K、10-Q、8-K、…）を返します。
• get_company_facts(cik) — XBRL companyfactsから年間財務スナップショットを取得します。latest_annual には、直近の会計年度の売上高、純利益、営業利益、売上総利益、資産、負債、資本、現金、EPS、株式数が含まれます。各項目は、提出者が現在報告に使用しているus-gaap概念に解決されます。key_financials には概念ごとの詳細が含まれ、現在の概念が先に並びます。提出者が廃止した概念も保持されます（過去の時系列データには引き続き必要です）が、stale: true と、置き換え後の概念名を示す stale_note が付与されます。

該当データが見つからない場合は、ステータスコードではなくメッセージで知らせます。EDGARがこれまで発行したことのないCIKについてはその旨を伝え、edgar_ticker_to_cik を案内します。CIKが存在するもののXBRLを提出していない場合（ファンド、信託、個人など）は、その対象を示して get_company_filings を案内します。ティッカーや企業名から何も見つからない場合は、有効な値の形式を説明します。EDGARの対象は米国で登録された提出者のみです。外国上場企業（603986.SS、NESN）は、その企業が米国でも提出を行っていない限り含まれません。

認証

認証キーは不要です。SECはすべてのリクエストに説明的な User-Agent を付けることを求めており、このパックではそれを付与します。

データソース

• https://efts.sec.gov/LATEST/search-index — 企業の全文検索。
• https://data.sec.gov/submissions/CIK##########.json — 提出書類の履歴。
• https://data.sec.gov/api/xbrl/companyfacts/CIK##########.json — XBRLデータ。

companyfactsには3つの落とし穴がありますが、すべて shared/src/xbrl.ts で対処しています（fleet #594、2026-08-28）。

• fy は対象期間の会計年度ではなく、提出書類の会計年度です。 10-Kには比較対象として過年度のデータも含まれますが、すべて提出書類の fy が付与されます。AmazonのFY2020の純利益は、FY2022の10-Kで修正再表示されたため、fy=2022 と表示されます。このパックでは period_end から year を導出し、fy で並べ替えることはありません。
• frame は、その期間で最後に提出されたデータに付与されます。 委任状説明書（DEF 14A）にXBRLが含まれるようになって以降、提出者の最近の年間フレームがすべて委任状説明書に含まれることがあります。そのため、「フレーム付きの10-K」を条件にすると、気付かないうちに対象年が早い時期で途切れます。このパックでは frame を無視し、年次報告書フォームのうち period_end が最も新しいものを選び、同じ場合は filed が最も新しいものを優先します（修正再表示された数値が優先されます）。
• 廃止された概念も、概念ごとに見ると現行のように見えます。 Microsoftの Revenues はFY2010で終了し（ASC 606によって RevenueFromContractWithCustomerExcludingAssessedTax に移行しました）、以降は使われていません。すべての数値に会計年度が付与され、古い概念にはフラグが付いて最後に並びます。また、latest_annual では常に、提出者が現在使用している概念が先頭に表示されます。

クイックスタート

MCPクライアント（Claude Desktop、Cursor、Windsurfなど）に追加します。

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

このエンドポイントが実際に提供するもの

https://gateway.pipeworx.io/sec/mcp の tools/list は、上の表に記載されたツールに加えて、共有 Pipeworx メタツール（ask_pipeworx、 discover_tools、search_within、remember／recall など、ゲートウェイ全体で使えるツール群）も返します。そのため、表示されるツール数はこの表の数より多くなります。現在、単一パックのエンドポイントでは、そのパック独自のツールに加えて、共有ツールが約 30 個表示されます。接続の initialize レスポンスには正確な範囲が示されており、その日の状況を確認するうえでの確実な情報源です。

これは意図的な設計であり、誤って多重化されているわけではありません。メタツールを使うと、このパックの対象外の質問にも対応できます。ask_pipeworx がカタログ全体を対象にルーティングするため、MCP サーバーをもう 1 つ追加する必要はありません。現在、メタツールなしでパックのエンドポイントをマウントする方法はありません。追加のスキーマによるコンテキスト消費が、ルーティングのメリットを上回る場合は、複数のパックエンドポイントではなく、フルゲートウェイに一度だけ接続してください。

または、フル Pipeworx ゲートウェイに接続すると、このパックのツールだけでなく、すべてのパックのツールを一覧で直接取得できます。

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

どちらの URL も同じゲートウェイと同じ 1807 以上のデータソースに接続します。違いは、どのパックのツールが直接一覧表示されるかだけです。ask_pipeworx を使えば、どちらからでもすべてのツールにアクセスできます。

MCP クライアントをお持ちでない場合は、HTTP で呼び出す

curl -X POST https://gateway.pipeworx.io/v1/tools/sec_search_companies \
  -H 'Content-Type: application/json' \
  -d '{"query":"Apple"}'

最初の呼び出しにアカウントは必要ありません。ツールを確認するには、GET https://gateway.pipeworx.io/v1/tools/sec_search_companies を実行します。ツールを探すには、{"query":"..."} を指定して POST https://gateway.pipeworx.io/v1/tools/search_packs を実行します。

スタンドアロン（ゲートウェイアカウント不要）

このパッケージはローカルの stdio MCP サーバーとしても実行できます。Pipeworx アカウントも、ゲートウェイへのラウンドトリップも不要です。

{
  "mcpServers": {
    "sec": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-sec"]
    }
  }
}

または、起動を確認するために直接実行します。

npx -y @pipeworx/mcp-sec

stdin/stdout 経由で MCP を使用し、このパックのツールのみを対象に initialize／tools/list／tools/call に応答します。上記のゲートウェイ接続で追加される共有メタツールは含まれません。同じソース、同じツールですが、ask_pipeworx によるルーティングはありません。

ask_pipeworx を使う

ツールを直接呼び出す代わりに、自然な英語で質問できます。これは上記のパックエンドポイントとフルゲートウェイの両方で利用できます。

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

ゲートウェイが適切なツールを選び、引数を自動的に設定します。

詳細情報

• ドキュメントとガイド
• pipeworx.io

ライセンス

MIT