opencapital

OpenCapital MCP Server

每家美国上市公司的信息，均来自 SEC 文件——现在可供你的 AI 助手使用。

OpenCapital 是一个托管的 Model Context Protocol（MCP）服务，让 Claude、ChatGPT、Cursor、Codex 以及任何其他支持 MCP 的客户端能够只读访问每家美国上市公司实际报告的信息——数千家美国上市股票（普通股和 ADR）的基本面、分部明细、同业比较和财报，所有数据均直接取自 SEC 文件。

你无需运行任何东西。该服务托管在 OpenCapital 的基础设施上。只需在客户端添加一个 URL，登录一次，即可开始提问。

https://api.opencapital.sh/mcp

• **传输方式：**可流式传输的 HTTP（远程 MCP 服务）
• **身份验证：**OAuth 2.0——使用 Google 登录，并授予只读访问权限
• **免费套餐：**每天 100 次查询，无需信用卡。付费套餐不设上限。
• **数据：**来自美国 SEC 文件（10-K、10-Q、8-K）的基本面、分部和财报数据，实时读取

数据免费，工作流付费。每项指标、分部、季度和文件引用均可免费查询。OpenCapital 是一个独立项目，与 SEC 无关。

---

快速连接

选择下方的客户端，或查看完整的分步指南：opencapital.sh/connect-ai。

Claude（claude.ai / Claude Desktop）

1. 自定义 → 连接器 → 添加自定义连接器
2. 将其命名为 OpenCapital，粘贴 https://api.opencapital.sh/mcp
3. 点击连接并授权只读访问权限

完整指南：opencapital.sh/connect-ai/claude

Claude Code

claude mcp add --transport http opencapital https://api.opencapital.sh/mcp

添加 --scope user，即可在每个项目中使用。然后在会话中运行 /mcp，选择 opencapital，并选择验证身份。

完整指南：opencapital.sh/connect-ai/claude-code

ChatGPT（Plus / Team / Enterprise）

1. 设置 → 应用 → 高级设置 → 启用开发者模式
2. 创建应用，将其命名为 OpenCapital，粘贴 URL，并选择 OAuth
3. 授权只读访问权限

完整指南：opencapital.sh/connect-ai/chatgpt

Cursor

添加到 ~/.cursor/mcp.json（全局）或 .cursor/mcp.json（项目）：

{
  "mcpServers": {
    "opencapital": {
      "url": "https://api.opencapital.sh/mcp"
    }
  }
}

然后在 Cursor 设置 → 工具与 MCP → 连接下启用该服务。

完整指南：opencapital.sh/connect-ai/cursor

Codex / Codex CLI

codex mcp add opencapital --url https://api.opencapital.sh/mcp
codex mcp login opencapital

或添加到 ~/.codex/config.toml：

[mcp_servers.opencapital]
url = "https://api.opencapital.sh/mcp"

完整指南：codex · codex-cli

任何其他 MCP 客户端

通过可流式传输的 HTTP传输方式添加远程 / 自定义 MCP 服务，并将其指向 https://api.opencapital.sh/mcp。大多数客户端也接受上方 Cursor 部分所示的 mcpServers JSON 格式。首次调用时会打开浏览器，让你登录并批准只读访问权限。

完整指南：opencapital.sh/connect-ai/other

---

可以询问的内容

该服务提供 14 个只读工具。你很少需要直接按名称调用它们，只需用自然语言提问，客户端就会选择合适的工具。

工具	功能
stock_screener	查找和筛选公司（行业、市值、市盈率、增长、FCF 等）。每家公司一行。
stock_screener_filter_values	列出股票筛选字段的有效值（例如各行业的股票数量）。
metric_screener	跨公司搜索财务指标。每个（公司 × 指标）一行，包含最新值、同比／环比和 TTM 变化。
metric_screener_filter_values	列出指标筛选字段的有效值。
metric_detail	指标定义、通俗解释、信号解读、上级／标准指标，以及同业公司的类似指标。
metric_time_series	单个股票代码的一个或多个指标的完整季度／年度／TTM 历史数据。
peer_time_series	最多 10 个股票代码的同一指标数据，用于同业直接比较。
segment_time_series	按细分业务（产品、业务、地域）拆解某个报表项目，并提供各细分业务的历史数据。
business_overview	根据公司最新的 10-K 第 1 项介绍公司业务：细分业务、价值链、合作伙伴和具名竞争对手。
business_competitors	排名后的同业公司列表，包括申报文件中提及的竞争对手、反向提及的公司，以及嵌入相似的企业。
filing_text_search	对 SEC 申报文件的叙述性文本（MD&A、风险因素、脚注）进行语义和关键词搜索，返回按相关性排序的段落、EDGAR 链接及交叉引用的指标。
portfolio_holdings	你关联的券商账户持仓，按股票代码汇总并显示权重和盈亏。（需要登录并关联账户）
get_watchlist	你的关注列表，包含公司元数据和最近的财报事件。（需要登录）
update_watchlist	在你的关注列表中添加或移除股票代码。（需要登录）

提示词示例

• “Uber 过去 8 个季度的 Mobility 抽成率是多少？”
• “Airbnb 各地区的 ADR 有何差异？”
• “展示 DoorDash 自 IPO 以来每个季度的 Marketplace GOV。”
• “比较 AWS、Azure、GCP 和 Oracle 的云收入。”
• “帮我找出 10 家大型上市公司：营收增长超过 20%、自由现金流为正且市盈率低于 30。”
• “在 Nvidia 发布财报前，总结其供应商、超大规模云服务客户和竞争对手在最近的申报文件中说了什么。”

更多示例见 examples/prompts.md。

---

设计上仅支持只读操作

OpenCapital MCP 服务仅提供只读的股票研究数据，包括根据 SEC 公开申报文件整理的基本面、细分业务和财报信息。你的助手**无法下单交易或修改任何账户状态。**关注列表工具是唯一支持写入的功能，但它们只能编辑你自己的 OpenCapital 关注列表。

隐私与条款

OAuth 授权你的 AI 客户端只读访问 OpenCapital 的公开股票研究索引（如果你选择授权，也可访问你自己的关注列表和关联的券商账户持仓）。请参阅服务条款和隐私政策。

许可证

本仓库中的配置片段和文档采用 MIT 许可证。

它们连接的 OpenCapital MCP 服务是托管服务，受其服务条款约束——你对该服务的使用（包括免费层级）均须遵守这些条款，而非本许可证。本仓库不包含该服务的源代码。

链接

• 网站 — opencapital.sh
• 连接指南 — opencapital.sh/connect-ai
• Model Context Protocol — modelcontextprotocol.io