Finnhub

Finnhub — 股票、加密货币、外汇数据

Finnhub 的 REST API。提供实时股票报价、基本面、财报、新闻、另类数据（内部人交易、情绪、ETF 持仓）、经济数据、加密货币和外汇数据。市场数据覆盖全面，免费套餐也很强大。

属于 Pipeworx — 一个将 AI Agent 连接到 1879+ 个实时数据源的 MCP 网关。这是一个独立的非官方集成，与上游提供商无关联、未获其认可，也并非由其发布。

这对 AI Agent 的意义

Alpha Vantage 在基本面和技术指标方面表现出色，而 Finnhub 在实时报价（免费套餐支持 1 分钟分辨率）、内部人交易、新闻/情绪和国际市场方面更强。对于需要同时获取价格数据、新闻动态和内部人活动信息的金融 Agent，Finnhub 非常合适。

常见工作流：

• 报价。 实时股票报价（免费套餐延迟 15 分钟）。
• 公司新闻。 某个代码对应的近期新闻，并带有情绪评分。
• 内部人交易。 包含时间和金额的 Form 4 文件（另见 insider-trading 套件，该套件直接从 SEC-EDGAR 获取数据）。
• 财报。 即将发布的财报日历、业绩意外历史和 EPS 估算。
• 国际股票代码。 欧洲、亚洲和新兴市场的股票代码（Alpha Vantage 在这些市场的覆盖较弱）。

身份验证

在 https://finnhub.io/dashboard 获取免费密钥。免费套餐：每分钟 60 次 API 调用。通过 _apiKey 传入。

更高级别的套餐（每月 50-200 美元）可解锁实时数据、更长的历史数据，以及适合生产环境的速率限制。免费套餐足以满足大多数 Agent 的研究需求。

何时使用 Finnhub，何时使用 Alpha Vantage

需求	更合适的数据源
报价	两者皆可；Finnhub 的免费套餐实时性更强
损益表 / 资产负债表	Alpha Vantage（架构更简洁）
内部人交易	Finnhub 或 insider-trading 套件
带有情绪信息的公司新闻	Finnhub
财报日历	Finnhub
国际市场覆盖	Finnhub
技术指标	Alpha Vantage
ETF 持仓	Finnhub

为了获得最全面的覆盖，Pipeworx Agent 通常会同时挂载两者。

财报业绩意外与财报日历

两种不同的工具分别回答两类不同的财报问题，选错工具会导致数据悄然遗漏：

• “上一季度的实际业绩与分析师预期相比如何？” → get_earnings_surprises({ symbol })。按股票代码查询，而非按日期范围查询，因此无论该季度距今多久，都能追溯到公司的财报历史。每个季度均返回 EPS 实际值、EPS 预估值、业绩意外金额和业绩意外百分比（按时间从近到远排列）。仅包含 EPS — Finnhub 的财报业绩意外历史不包含营收，工具会明确说明这一点，而不是悄悄返回 null。
• “接下来有哪些财报要发布，或者最近几周发生了什么？” → get_earnings_calendar({ symbol, from, to })。接受日期范围，并包含营收预估值/实际值以及 EPS — 但根据实时测量结果（2026-10-21），此套餐的日历历史回溯范围较短：大约只能查到最近几周，而不是公司的完整财报历史。更早的季度会返回 found: false，即使公司确实发布过财报也是如此 — 如果不知道日期范围已被截断，这会被误解为“没有财报”。查询几周以前的数据时，请改用 get_earnings_surprises。

常见注意事项

• 符号约定。 美国股票代码很简单（AAPL）；国际市场需要加上交易所后缀（瑞士交易所的 Nestlé 为 NESN.SW）。Finnhub 提供符号搜索功能。
• 免费套餐的实时延迟。 免费版的“实时”基本上是当前数据；付费版才是真正的实时数据。用于 Agent 研究时，免费版就够了；用于交易时，则需要付费版。
• 新闻情绪是启发式结果。 Finnhub 使用 NLP 计算情绪——方向上有参考价值，但存在噪声。不要将其视为事实依据；可用作信号。
• 内部人员交易数据有延迟。 SEC 要求在交易后 2 个工作日内提交 Form 4。Finnhub 会在提交后不久获取这些信息。要实现实时提醒，需要轮询或使用单独的 SEC 实时数据源。
• 预测值与实际值。 Finnhub 提供分析师一致预期；在图表中将其与实际值混用时，必须仔细标注。
• 免费套餐的覆盖缺口。 对于部分小盘股和 OTC 股票，Finnhub 免费版的覆盖有限。围绕目标股票代码设计工作流之前，请先确认是否有相关数据。

快速开始

添加到你的 MCP 客户端（Claude Desktop、Cursor、Windsurf 等）：

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

此端点实际提供的内容

https://gateway.pipeworx.io/finnhub/mcp 上的 tools/list 会返回上表中的工具，以及 Pipeworx 共享元工具——ask_pipeworx、discover_tools、search_within、remember/recall，以及网关级的其他工具。因此，你看到的工具数量会多于上表：目前，单个服务包端点除了列出该服务包自己的工具外，还会列出大约 30 个共享工具。连接的 initialize 响应会说明其确切范围，这是当天有效范围的权威依据。

这是有意为之，并非意外进行了多路复用。元工具可让限定范围的连接回答此服务包未涵盖的问题——通过 ask_pipeworx 在整个目录中进行路由——而无需添加第二个 MCP 服务。目前无法挂载不包含这些元工具的服务包端点；如果额外的架构定义占用的上下文超过路由功能带来的价值，请连接完整网关，而不是连接多个服务包端点。

或者，连接完整的 Pipeworx 网关，以便直接列出所有服务包的工具，而不只是此服务包的工具：

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

两个 URL 都会连接到同一个网关和相同的 1879+ 个数据源。唯一的区别是直接列出哪个服务包的工具；通过任一端点，ask_pipeworx 都可以访问所有工具。

没有 MCP 客户端？通过 HTTP 调用

我们的 finnhub 密钥仅供付费账户使用，因此匿名调用 POST https://gateway.pipeworx.io/v1/tools/get_quote 时，需要在参数中传入你自己的密钥作为 _apiKey。检查任意工具：GET https://gateway.pipeworx.io/v1/tools/get_quote。查找工具：使用 {"query":"..."} 调用 POST https://gateway.pipeworx.io/v1/tools/search_packs。

独立运行（无需网关账户）

此软件包也可以作为本地 stdio MCP 服务运行——无需 Pipeworx 账户，也无需经过网关：

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

或者直接运行，以确认服务已启动：

npx -y @pipeworx/mcp-finnhub

它通过 stdin/stdout 使用 MCP，并响应 initialize/tools/list/tools/call，仅提供此服务包的工具——不包含上述网关连接附带的任何共享元工具。代码源相同，工具相同，但没有 ask_pipeworx 路由功能。

使用 ask_pipeworx

你可以用通俗易懂的语言提问，而不必直接调用工具——此方法既适用于上面的服务包端点，也适用于完整网关：

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

网关会自动选择合适的工具并填入参数。

更多信息

• 文档和指南
• pipeworx.io

许可证

MIT