Analyst Ratings

@pipeworx/analyst-ratings

今日美国股票的分析师评级上调、下调、首次覆盖和目标价变动，覆盖整个市场；还可查询任意美国股票当前的共识评级和覆盖该股票的券商列表。

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

工具

• analyst_upgrades_today(action?, symbol?, us_only?, limit?) — 汇总华尔街券商在本交易时段发布的所有评级操作：股票代码、公司、交易所、券商、分析师、旧评级和新评级、旧目标价和新目标价。可回答“今天哪些股票评级上调了”“今天分析师下调了哪些评级”“今天有哪些目标价变动”“分析师首次覆盖了哪些股票”。action 可选 all（默认）、upgrade、downgrade、initiated、price_target、reiterated。
• analyst_ratings_for_symbol(symbol) — 共识评级（Buy/Hold/Sell）、覆盖该股票的分析师数量，以及发布该股票评级的券商列表。可回答“分析师如何看待 NVDA”“哪些券商覆盖 Apple”。

身份验证

无需密钥。两个上游数据源均为公开数据源，无需凭据、注册或订阅方案即可访问。

数据源

• https://www.marketbeat.com/ratings/ — 每日评级汇总表（约 400 行，约 2 MB HTML）。此外还有 /ratings/upgrades/、/ratings/downgrades/、/ratings/initiations/，这些页面提供按单一操作筛选的同一张表，体积约小 10 倍。选择单一 action 时，该工具包会选用范围更窄的页面，因此常见查询无需加载 2 MB 数据。
• https://api.nasdaq.com/api/analyst/{SYMBOL}/ratings — 按股票代码提供共识数据：meanRatingType、ratingsSummary、brokerNames[]。

陷阱

• api.nasdaq.com 会对非浏览器 User-Agent 返回 520。 2026-09-10 从已部署的 Cloudflare Worker 测得：PipeworxBot/1.0 (+https://pipeworx.io) → 65 ms 内返回 520；Mozilla/5.0 (pipeworx.io) → 返回 200。520 是 Cloudflare 的通用源站错误，因此看起来像是服务中断，而不是请求被拒绝。该工具包使用目录中其他工具已采用的 Mozilla/5.0 (pipeworx.io) 形式。
• Nasdaq 端点上的 upgradesDowngrades[] 始终为空。 2026-09-10 检查了 AAPL、AMGN、NVDA、TSLA 和 AAL——每个都返回 []，包括当天早上确实被下调评级的股票。此字段已失效；不要将其呈现为当天的操作记录。相关数据位于 analyst_upgrades_today。
• 两个来源都没有日期选择器。 https://www.marketbeat.com/ratings/?date=... 会返回 200，并静默忽略该参数；/ratings/2026/09/09/ 和 /ratings/9/9/2026/ 会返回 404。表格中也没有逐行日期。因此，这两个工具都只提供当前交易时段的数据，而 as_of 是推算得出的——获取数据时的美国东部时区日期，遇到周末则回退到前一个工作日。负载通过 as_of_basis 说明了这一点，而不会呈现来源从未提供过的日期。不会针对市场假日进行调整。
• 合并后的 /ratings/ 数据流并非仅包含美国证券。 2026-09-10 测得：共 402 行，涵盖 NYSE 178 行、NASDAQ 177 行、TSE 14 行、OTCMKTS 13 行、LON 13 行、NYSEAMERICAN 3 行、CVE 3 行。us_only 默认为 true，会过滤掉多伦多和伦敦上市的证券，因为查询针对的是美国股票。
• 应从 data-clean 解析，而不是从单元格文本解析。 每个单元格都有一个 data-clean="old|new" 属性——AAPL|Apple、$445.00|$425.00、Buy|Hold——而渲染后的文本则被徽标、星级评分和升级销售链接包裹。操作类型位于第二个单元格的 data-sort-value 中。缺失的目标价为 0，而不是空字符串，因此必须显式映射为 null，否则会被读作 $0 目标价。
• 可通过 Cloudflare Worker 的出口访问 MarketBeat，使用真实的 Mozilla/5.0 (compatible; PipeworxBot/1.0; +https://pipeworx.io) UA（200，212 KB，187 ms；2026-09-10 从 wrangler dev --remote 测得）。它本身位于 Cloudflare 后面，因此在开始构建之前进行确认很有必要。

快速开始

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

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

此端点实际提供的内容

https://gateway.pipeworx.io/analyst-ratings/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+ 个数据源。唯一的区别是直接列出哪个工具包的工具；无论连接哪个端点，ask_pipeworx 都可以访问所有工具。

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

curl -X POST https://gateway.pipeworx.io/v1/tools/analyst_upgrades_today \
  -H 'Content-Type: application/json' \
  -d '{"action":"upgrade","limit":10}'

首次调用无需账户。检查任意工具：GET https://gateway.pipeworx.io/v1/tools/analyst_upgrades_today。查找工具：使用 {"query":"..."} 向 https://gateway.pipeworx.io/v1/tools/search_packs 发送 POST 请求。

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

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

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

也可以直接运行，确认它能正常启动：

npx -y @pipeworx/mcp-analyst-ratings

它通过 stdin/stdout 使用 MCP 通信，并针对仅限此软件包的工具响应 initialize/tools/list/tools/call——不包含上方网关连接所添加的任何共享元工具。相同的源代码，相同的工具，无需 ask_pipeworx 路由。

使用 ask_pipeworx

你也可以用通俗的英语提问，而不是直接调用工具——这既适用于上方的软件包端点，也适用于完整网关：

ask_pipeworx({ question: "your question about Analyst Ratings data" })

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

更多信息

• 文档和指南
• pipeworx.io

许可证

MIT