Alphavantage

Alpha Vantage — 股票和市场数据

Alpha Vantage 的 REST API，提供股票价格、基本面、技术指标、外汇、加密货币和经济指标。提供约 20 多年的历史股票数据、近实时行情（免费套餐延迟 15 分钟），以及从 SEC 文件中解析出的结构化基本面数据。

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

这对 AI Agent 有何意义

SEC EDGAR 提供原始文件，而 Alpha Vantage 提供清理后的结构化数据，可直接用于分析：损益表、资产负债表、现金流量表、关键比率、近期财报和技术指标。在交易时段获取近实时行情时，它就是数据源。

常见工作流：

• 行情。 “AAPL 的交易价格是多少？” → av_quote({symbol: "AAPL"}) → 最新价格、涨跌幅、成交量。
• 损益表。 “Apple 最近 4 个季度的收入/利润。” → av_income_statement({symbol: "AAPL"})。
• 财报。 “NVDA 下一次什么时候发布财报？” → av_earnings({symbol: "NVDA"})。
• 每日价格历史。 “AAPL 近 1 年的历史数据。” → av_daily({symbol: "AAPL"})。

fintech_company_deep_dive 复合工具会搭配 SEC EDGAR 使用此工具，获取行情和损益表数据。

身份验证 — 自带付费密钥（Pipeworx 不提供密钥）

截至 2026-09-02，此工具包仅支持自带密钥（Bruce 对 fleet #1117 的裁定）。Pipeworx 不提供密钥：网关条目不再指定 PLATFORM_ALPHAVANTAGE_KEY，因此 _apiKey 就是你传入的值，不会使用其他密钥。 不传密钥调用时会收到拒绝响应，说明此工具包需要 API 密钥，并列出两个可用的替代方案——不会因此向上游发起调用。

无论密钥属于谁，Alpha Vantage 免费密钥在这里都无法使用。 Alpha Vantage 按 SOURCE IP 对免费套餐进行限流，且根本不会验证密钥——我们于 2026-09-02 用 3 个真实密钥和虚构字符串 ZZZZINVALIDKEY99 进行了测量。它们都从网关收到相同的“每天 25 次请求”拒绝响应；而同一分钟内，在同一 台笔记本上，真实密钥却返回了真实的 IBM 数据（fleet #1070；完整测量结果见 src/index.ts 的文件头注释）。 由于实际消耗的是调用发出的 IP 地址额度，你的免费密钥通过网关调用时会因与我们的密钥相同的原因而被拒绝。这也意味着，在笔记本上测试无法证明此工具包可用：只要 IP 额度尚有剩余，任何字符串都能“奏效”。

可用的是付费密钥。 Premium（$50–250/mo）是 Alpha Vantage 真正会验证的唯一密钥类型——其高级端点会明确拒绝免费密钥。我们没有付费密钥，因此未能在此处测试；请将此结论视为推断，而非实测结果。通过 _apiKey 传入密钥。

如果你没有付费密钥，可以使用拒绝响应中列出的替代方案；这两种方案目前都能回答这些问题：

• get_company_financials（sec-xbrl 工具包）— 美国公司的损益表、资产负债表和现金流量表，无需密钥，没有每日调用上限。可覆盖 av_overview / av_income_statement / av_balance_sheet / av_earnings 为美国申报公司提供的所有功能。
• finnhub — 实时行情，免费密钥，每分钟 60 次调用且没有每日调用上限。可替代 av_quote，也支持非美国股票代码。

“demo”密钥：Alpha Vantage 宣称 demo 是无需注册的密钥，但它在大多数调用中都会返回错误；通过网关调用时，它也会像其他免费密钥一样受到相同的 IP 限流。此工具包会明确拒绝该密钥。

更新频率

• 行情：付费套餐提供实时数据，免费套餐延迟 15 分钟；仅限交易时段
• 每日 / 每周 / 每月历史数据：每日收盘后更新
• 基本面数据：SEC 文件更新后约 24 小时内刷新
• 财报：各公司发布财报后刷新

Pipeworx 使用与这些频率相匹配的 TTL 进行缓存。

常见误区

• 免费套餐每分钟限制 5 次。 突发调用会失败。请控制 Agent 调用频率或升级套餐。对 Pipeworx 来说，这个问题无关紧要，因为免费密钥根本不会触及每分钟限制。
• 每日额度用尽会报错，而不是返回空结果。 YOUR 密钥的每日 25 次上限用完后，此工具包中的每个工具都会返回 auth_required，并附带“此密钥的每日请求额度已用尽”这句话——这是刻意设计的，目的是让网关能够附加 credential 块，指出哪个密钥的额度用完了。以前它会返回 {found:false, reason:"quota_exceeded"}，对于任何不解析文本的调用方来说，这看起来像是调用成功，因此额度用尽的密钥数周都被报告为正常（fleet #1091）。短暂的限流——仅说明每分钟调用频率的通知——仍会返回软错误 {found:false, reason:"rate_limit"}，因为这种限制确实会自行解除。自 #1117 起，该块只能显示 caller：工具包移除了平台密钥探测轮换机制，也移除了平台密钥，因此 Pipeworx 已无可用额度。
• Symbol 与 ticker 的区别。 在 Alpha Vantage 上，两者大多相同，但一些非美国股票代码需要后缀（例如，BARC.LON）。默认端点假设股票在美国上市。
• “实时”的定义。 免费套餐提供延迟 15 分钟的日终风格快照。算法交易需要付费套餐；Agent 研究则用免费套餐就够了。
• 财报日历并非总是准确。 公司可能会调整报告日期；Alpha Vantage 最终会更新，但有时会延迟一两天。
• 调整后价格与未调整价格。 日调整收益使用经过拆股和股息调整的收盘价；日收益使用原始收盘价。进行长期分析时，几乎总是应该使用调整后价格。

快速开始

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

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

此端点实际提供的内容

https://gateway.pipeworx.io/alphavantage/mcp 上的 tools/list 会返回上表中的工具，以及 Pipeworx 共享元工具——ask_pipeworx、discover_tools、search_within、remember/recall 和网关范围内的其他工具。因此，你看到的工具数量会多于此表：目前，单工具包端点除了工具包自身的工具外，还会列出大约 30 个共享工具。连接的 initialize 响应会说明其确切范围，是了解某一天实际情况的权威依据。

这是有意为之，并非意外的多路复用。元工具能够让此连接回答本工具包未涵盖的问题——通过 ask_pipeworx 跨整个目录进行路由——而无需添加第二个 MCP 服务。目前无法挂载不含这些元工具的工具包端点；如果额外的 schema 带来的上下文开销超过了路由的价值，请连接一次完整网关，而不是连接多个工具包端点。

你也可以连接完整的 Pipeworx 网关，直接列出所有工具包的工具，而不仅仅是当前工具包的工具：

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

两个 URL 都会访问同一个网关和相同的 1872+ 个数据源。唯一的区别是直接列出哪个工具包的工具；无论使用哪个 URL，ask_pipeworx 都能访问所有工具。

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

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

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

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

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

也可以直接运行，以确认服务能够启动：

npx -y @pipeworx/mcp-alphavantage

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

与 ask_pipeworx 搭配使用

你可以用自然语言提问，而不是直接调用工具 —— 这适用于上面的工具包端点，也适用于完整网关：

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

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

更多

• 文档和指南
• pipeworx.io

许可证

MIT