使用说明
SEC EDGAR MCP服务器
访问所有美国上市公司的SEC文件和XBRL财务数据。
可用数据
- 公司文件 -10-K（年度）、10-Q（季度）、8-K（时事）、4（内幕交易）等。
- 财务数据 -收入、资产、负债、现金流和1000+其他XBRL指标
- 公司信息 -CIK、股票代码、SIC代码、公司名称
- 行业比较 -比较所有报告公司的财务指标
设置
不需要API密钥。添加到MCP配置中：
{
"sec-edgar": {
"command": "node",
"args": ["/path/to/sec-edgar/dist/index.js"],
"env": {}
}
}
工具
search_companies
按名称或股票代码搜索公司以查找其CIK。
| 参数 | 必填 | 说明 |
|---|---|---|
| query | Yes | 公司名称或股票代码（例如，“Apple”、“AAPL”） |
| limit | 否 | 最大结果（默认值20） |
例子： 查找Microsoft
query: "Microsoft"
get_company_filings
获取公司最近向美国证券交易委员会提交的文件。
| 参数 | 必填 | 说明 |
|---|---|---|
| 公司 | 是 | 股票代码（AAPL）、CIK（320193）或名称 |
| formType | 否 | 按类型筛选：“10-K”、“10-Q”、“8-K”、”4”等。 |
| 限制 | 否 | 最大提交量（默认值20） |
例子： 获取苹果的年度报告
company: "AAPL"
formType: "10-K"
limit: 5
退货： 提交日期、登录号和SEC文件的直接链接
get_company_facts
获取公司的所有可用XBRL财务指标。
| 参数 | 必填 | 说明 |
|---|---|---|
| 公司 | 是 | 票务、CIK或姓名 |
| 分类法 | 否 | “us-gaap”（默认）、“dei”、“ifrs full” |
退货： 具有最新值和数据点计数的可用指标列表
get_financial_metric
获取特定财务指标的历史数据。
| 参数 | 必填 | 说明 |
|---|---|---|
| 公司 | 是 | 票务、CIK或姓名 |
| 指标 | 是 | XBRL标签（例如，“收入”、“资产”） |
| 分类法 | 否 | “us-gaap”（默认）、“dei”、“ifrs full” |
例子： 获取苹果的收入历史
company: "AAPL"
metric: "Revenues"
get_industry_metric
获取一段时间内所有公司的指标（行业比较）。
| 参数 | 必填 | 说明 |
|---|---|---|
| 指标 | 是 | XBRL标签（例如，“收入”、“资产”） |
| 年份 | 是 | 日历年（例如2023年） |
| 季度 | 否 | “Q1”、“Q2”、“Q3”、“Q4”，或省略年度 |
| 单位 | 否 | “美元”（默认）、“股份”、“纯” |
| 限制 | 否 | 最大公司数（默认值50） |
例子： 获取所有公司2023年的收入
metric: "Revenues"
year: 2023
limit: 100
list_common_metrics
列出常用的XBRL财务指标及其标签。
| 参数 | 必填 | 说明 |
|---|---|---|
| 类别 | 否 | “收入”、“余额”、“现金”、“股票”或“全部” |
常见XBRL指标
利润表
| 标签 | 描述 |
|---|---|
| 收入 | 总收入 |
| CostOfRevenue | 销售成本 |
| 毛利 | 毛利 |
| 营业收入亏损 | 营业收入 |
| 净收入损失 | 净收入 |
| 基本每股收益 | 基本每股收益 |
| 每股摊薄收益 | 每股摊薄收益 |
资产负债表
| 标签 | 描述 |
|---|---|
| 资产 | 总资产 |
| 资产流动 | 流动资产 |
| 负债 | 负债总额 |
| 股东权益 | 股东权益 |
| 按账面价值计算的现金和现金等价物 | 现金 |
| 长期债务 | 长期债务 |
现金流
| 标签 | 描述 |
|---|---|
| 按使用量提供的净现金经营活动 | 经营现金流 |
| 按使用量提供的净现金投资活动 | 投资现金流 |
| 按用途提供的净现金用于融资活动 | 融资现金流 |
| 收购物业、厂房和设备的付款 | 资本支出 |
速率限制
- 每秒10个请求
- 必须包含User-Agent标头（内置于此服务器中）
文档
- EDGAR API：https://www.sec.gov/edgar/sec-api-documentation
- XBRL分类标准：https://xbrl.us/home/filers/sec-reporting/taxonomies/
- 公司搜索：https://www.sec.gov/cgi-bin/browse-edgar
