sec-ai: SEC EDGAR

sec-finance-ai MCP サーバー

AI を活用した SEC EDGAR 連携：公式 sec.gov API を利用する 23 個のツールを、1 つの Python ファイルにまとめています。

🚀 ClawHub と OpenWebUI で数千件のダウンロード

10-K、10-Q、8-K、20-F、委任状説明書、あらゆる提出書類の全文をページ単位で読み取る機能や検索機能、XBRL の企業データと企業間ランキング、Form 4 のインサイダー取引、13D/13G の保有状況、13F のファンドポートフォリオ、IPO、さらに 2001 年以降のすべての提出書類を対象とした全文検索に対応しています。

使用先	インストール	リポジトリ
Claude、Cursor、VS Code、LangChain、Google ADK、Strands Agents などの MCP クライアント	uvx sec-finance-ai@latest	sec-ai-mcp
OpenClaw 用 ClawHub スキル 🚀 数千件のダウンロード	openclaw skills install @lkcair/sec	sec-ai-skill
OpenWebUI ツール 🚀 数千件のダウンロード	openwebui.com で入手	sec-finance-ai
Python	from sec_finance_ai import Tools	sec-finance-ai

インストール

uv が必要です。API キーは不要です。

Claude Code：

claude mcp add sec-ai -e SEC_USER_AGENT="Your Name [email protected]" -- uvx sec-finance-ai@latest

VS Code：

code --add-mcp '{"name":"sec-ai","type":"stdio","command":"uvx","args":["sec-finance-ai@latest"],"env":{"SEC_USER_AGENT":"Your Name [email protected]"}}'

Claude Desktop、Cursor、Windsurf などのクライアントでは、クライアントの MCP 設定ファイルに記述します：

{
  "mcpServers": {
    "sec-ai": {
      "command": "uvx",
      "args": [
        "sec-finance-ai@latest"
      ],
      "env": {
        "SEC_USER_AGENT": "Your Name [email protected]"
      }
    }
  }
}

@latest を指定すると、クライアントの起動時に新しいリリースが適用されます。uv を使わない場合は、pip install sec-finance-ai を実行し、引数なしで "command": "sec-finance-ai" を使用します。

SEC_USER_AGENT は、SEC がプログラムに送信を求めている名前とメールアドレスです。設定されていない場合は、デフォルト値が送信されます。

MCP Registry に io.github.lkcair/sec-ai として登録されています。すべてのツールは読み取り専用です。

エージェントフレームワーク

このサーバーは uvx sec-finance-ai@latest を使って stdio 経由で動作するため、MCP をサポートするあらゆるフレームワークで、すべてのツールを読み込めます。

SEC_USER_AGENT の設定は任意です。MCP は最小限の環境変数でサーバーを起動するため、以下の例のように渡してください。**os.environ によって PATH が保持されるため、uvx が見つかります。

LangChain：pip install "langchain[mcp]" langchain-anthropic

import asyncio
import os
from langchain.agents import create_agent
from langchain.mcp import MCPAdapter

async def main():
    config = {"mcpServers": {"sec-ai": {
        "command": "uvx", "args": ["sec-finance-ai@latest"],
        "env": {**os.environ, "SEC_USER_AGENT": "Your Name [email protected]"},  # optional
    }}}
    async with MCPAdapter(config) as adapter:
        tools = await adapter.list_tools()
        agent = create_agent("claude-sonnet-5", tools)
        result = await agent.ainvoke({"messages": [{"role": "user", "content": "What does Apple's latest 10-K say about Greater China?"}]})
        print(result["messages"][-1].content)

asyncio.run(main())

Google ADK：pip install "google-adk[mcp]"

import os
from google.adk.agents import LlmAgent
from google.adk.tools.mcp_tool import McpToolset
from google.adk.tools.mcp_tool.mcp_session_manager import StdioConnectionParams
from mcp import StdioServerParameters

root_agent = LlmAgent(
    model="gemini-flash-latest",
    name="sec_ai",
    instruction="Answer with the sec-ai tools.",
    tools=[McpToolset(connection_params=StdioConnectionParams(
        server_params=StdioServerParameters(
            command="uvx", args=["sec-finance-ai@latest"],
            env={**os.environ, "SEC_USER_AGENT": "Your Name [email protected]"},  # optional
        ),
        timeout=60,
    ))],
)

Strands Agents：pip install strands-agents

import os
from mcp import stdio_client, StdioServerParameters
from strands import Agent
from strands.tools.mcp import MCPClient

sec_ai = MCPClient(lambda: stdio_client(StdioServerParameters(
    command="uvx", args=["sec-finance-ai@latest"],
    env={**os.environ, "SEC_USER_AGENT": "Your Name [email protected]"},  # optional
)))
agent = Agent(tools=[sec_ai])
agent("What does Apple's latest 10-K say about Greater China?")

質問例

• Apple の最新の 10-K には、大中華圏について何と書かれていますか？
• Berkshire Hathaway の最新の 13F における上位保有銘柄は何ですか？
• 今年、「継続企業の前提」に言及している 8-K をすべて探してください。
• 2024 年に売上高が最も高かった企業はどこですか？

MCP ツール（22 個）

提出書類

ツール	パラメーター	説明
get_company_filings	ticker, form_type=null, limit=10, start_date=null, end_date=null	ティッカーシンボルを指定して企業の SEC 提出書類を取得します
get_latest_10k	ticker	最新の 10-K と、その本文の短いプレビューを取得します
get_latest_10q	ticker	最新の 10-Q と、その本文の短いプレビューを取得します
get_recent_8k_filings	ticker, limit=5	最近の 8-K 提出書類と、それぞれの短いプレビューを取得します
analyze_8k_filing	ticker	企業の最新の 8-K 提出書類を取得し、要約します
get_proxy_statements	ticker, limit=3	企業の委任状説明書（DEF 14A）を取得します
get_recent_ipos	limit=20, days=30	EDGAR から最近の IPO の動向を取得します

提出書類の内容を読む

ツール	パラメーター	説明
get_filing_size	filing_url	ダウンロード前に提出書類の正確なサイズを確認します
download_filing_text	filing_url, max_length=50000, offset=0, search=null	提出書類を50,000文字ごとのページで読み込み、内部を検索するか、25 MBを超える場合はリンクを取得します
get_filing_documents	filing_url	提出書類内のすべての文書（メイン文書、添付資料、XBRL、XML）をサイズとリンクとともに一覧表示します
get_filing_content	ticker, filing_type=null, get_full_content=false, specific_metrics=null	XBRLから主要な財務数値を取得するか、提出書類の全文をページ単位で取得します

検索

ツール	パラメーター	説明
full_text_search	query, form_type=null, start_date=null, end_date=null, limit=20	2001年以降のすべてのEDGAR提出書類の全文を検索します（単語または「完全一致するフレーズ」）
search_filings	query, form_type=null, start_date=null, end_date=null, limit=20	企業名などの条件でSEC提出書類を検索します

所有権とインサイダー

ツール	パラメーター	説明
get_insider_transactions	ticker, limit=20	企業のインサイダー取引（フォーム3、4、5）を取得します
get_beneficial_ownership	ticker, limit=10, schedule="all"	企業の実質的所有権に関する報告書（13D、13G）を取得します
get_13f_holdings	ticker_or_cik, limit=25	機関投資運用会社の最新の13Fポートフォリオを取得します

財務データ（XBRL）

ツール	パラメーター	説明
get_company_facts	ticker	SECのXBRLデータから企業情報を取得します
get_company_concept	ticker, concept	企業の特定の財務概念データを取得します
get_available_metrics	ticker, search_term=null	SECのXBRLデータから企業で利用可能な財務指標を確認します
get_xbrl_frames	concept, period, unit="USD", taxonomy="us-gaap", limit=20	1つの期間について、すべての報告企業の財務概念を取得し、順位付けします

ユーティリティ

ツール	パラメーター	説明
get_sec_api_status		SEC APIのステータスと接続状況を確認します
run_self_test		すべてのSEC-AIツールの包括的なセルフテストを実行します

ライセンス

MIT。すべてのデータは、公開されているSEC EDGARデータベースから取得しています。米国証券取引委員会とは提携していません。