作者 stefanoamorelli · stefanoamorelli/sec-edgar-mcp
客服人員可以輕鬆處理美國申報事宜： CIK LOOKUP、10-K/10-Q/8-K、XBRL FINANCIALS、Form 3/4/5 INSIDER TRADES ，每個答案都可以連結到SEC來源。
sec-edgar-mcp允許客服人員以結構化方式存取SEC的EDGAR系統。它通過股票代碼或名稱將公司解析為CIK ，提取特定申報（ 10-K ， 10-Q ， 8-K ） ，提取部分，將XBRL解析為資產負債表/收益表/現金流，並顯示內幕交易（表格3/4/5 ）。每個回覆都包含SEC網址，方便你自行驗證號碼。僅限公開資料—除了符合規範的使用者代理程式外，不需要API金鑰。
%APPDATA%\Claude\claude_desktop_config.json{
"mcpServers": {
"sec-edgar-mcp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"SEC_EDGAR_USER_AGENT=Your Name ([email protected])",
"stefanoamorelli/sec-edgar-mcp:latest"
]
}
}
}開啟 Claude Desktop → Settings → Developer → Edit Config。儲存後重啟應用。
{
"mcpServers": {
"sec-edgar-mcp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"SEC_EDGAR_USER_AGENT=Your Name ([email protected])",
"stefanoamorelli/sec-edgar-mcp:latest"
]
}
}
}Cursor 使用與 Claude Desktop 相同的 mcpServers 格式。專案級設定優先於全域。
{
"mcpServers": {
"sec-edgar-mcp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"SEC_EDGAR_USER_AGENT=Your Name ([email protected])",
"stefanoamorelli/sec-edgar-mcp:latest"
]
}
}
}點擊 Cline 側欄中的 MCP Servers 圖示，然後選 "Edit Configuration"。
{
"mcpServers": {
"sec-edgar-mcp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"SEC_EDGAR_USER_AGENT=Your Name ([email protected])",
"stefanoamorelli/sec-edgar-mcp:latest"
]
}
}
}格式與 Claude Desktop 相同。重啟 Windsurf 生效。
{
"mcpServers": [
{
"name": "sec-edgar-mcp",
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"SEC_EDGAR_USER_AGENT=Your Name ([email protected])",
"stefanoamorelli/sec-edgar-mcp:latest"
]
}
]
}Continue 使用伺服器物件陣列，而非映射。
{
"context_servers": {
"sec-edgar-mcp": {
"command": {
"path": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"SEC_EDGAR_USER_AGENT=Your Name ([email protected])",
"stefanoamorelli/sec-edgar-mcp:latest"
]
}
}
}
}加入 context_servers。Zed 儲存後熱重載。
claude mcp add sec-edgar-mcp -- docker run -i --rm -e 'SEC_EDGAR_USER_AGENT=Your Name ([email protected])' stefanoamorelli/sec-edgar-mcp:latest一行命令搞定。用 claude mcp list 驗證，claude mcp remove 移除。
何時使用： 您今天下午需要閱讀10-K ，而不是本週。
結果： 可消化的10-K閱讀，並帶有可驗證的連結回到EDGAR。
何時使用： 您希望每日為您的觀察清單提供有關表格4活動的簡報。
結果： 沒有手刮埃德加的清脆內幕簡報。
何時使用： 發生了一些重要的事情；您希望快速完成簡單的英文摘要。
結果： 您可以信任並連結的觀察清單摘要。
何時使用： 你需要一個快速的蘋果對蘋果的比較。
結果： 與確切的來源網址進行可防禦的比較。
| 工具 | 輸入參數 | 何時呼叫 | 成本 |
|---|---|---|---|
| lookup_cik | ticker_or_name: str | 任何公司查詢的第一步 | 1 SEC request |
| get_company_facts | cik: str | 瞭解報告的行項目 | 1 SEC request |
| get_filings | cik: str, form_type: str, limit?: int | 提取10-K/10-Q/8-K文件 | 1 SEC request |
| extract_section | accession_number: str, section: str | 閱讀特定章節（例如：風險因素、MD&A ） | 1 SEC request |
| get_financials | cik: str, period: str | 結構性財務報表（含單位） | 1 SEC request |
| get_insider_transactions | cik: str, days?: int | 表格3/4/5活動 | 1 SEC request |
403 from sec.gov您的User-Agent缺失或格式不正確。SEC需要'Name ([email protected])'格式。
echo $SEC_EDGAR_USER_AGENT限價(429)退回到10次/秒以下。按CIK批次處理，而不是發出許多並行呼叫。
Inspect headers on the failing response未找到XBRL概念公司不得報告該概念。使用get_company_facts查看存在哪些概念。
get_company_facts(cik) and grep for the concept| 替代方案 | 何時用它替代 | 權衡 |
|---|---|---|
| yahoo-finance | 您想要沒有SEC級別精度的報價+基本基礎 | 權威性較低；沒有直接申請 |
| alpaca | 您需要經紀市場數據和交易 | 無歸檔；不同的資料形狀 |