TickerDB

TickerDB — 面向 Agent 的股票市场数据。

为 AI Agent 预先计算的股票市场数据。TickerDB 以命名状态的形式返回 trend_direction、support_level 和 analyst_consensus 等指标，还会说明发生了哪些变化以及接下来通常会发生什么。

10,000 多只美国股票、ETF 和加密货币交易对 · 涵盖趋势、动量、波动率、成交量、形态、支撑位/阻力位、基本面和行业背景的 182 项指标 · 7 年历史数据 · tickerdb.com

工具

工具	描述
get_summary	某个股票代码的技术面和基本面快照。支持历史查询、状态转换历史，以及后续通常会发生什么
get_ohlcv	每日或每周的 EOD K 线，用于计算收益、绘制图表和回测
get_search	按分类状态筛选资产，或按 market_cap、pe_ratio 等字段排序
get_schema	查看全部 182 个字段及其有效区间值
get_watchlist	获取已保存自选列表中每个股票代码的完整分析摘要
get_watchlist_changes	查看自选列表的变化 — 按日或按周比较
add_to_watchlist	将股票代码添加到自选列表
remove_from_watchlist	从自选列表中移除股票代码
get_account	账户详情、套餐等级和用量

所有套餐等级（Free、Plus、Pro）均可使用全部工具。各套餐等级在额度、历史数据深度、筛选器数量和自选列表容量上有所不同。请参阅 tickerdb.com/pricing。

快速开始

将 TickerDB 连接到 Claude、ChatGPT 或其他 MCP 客户端（请参阅下方的设置），然后试试：

“给我看看接近支撑位的超卖大盘股”

Agent 会使用 get_search，按 momentum_rsi_zone = oversold 和 market_cap_tier in [large, mega] 进行筛选，然后对单个结果调用 get_summary 进一步查询。无需处理原始数字 — Agent 读取分类状态并直接据此推理。

“AAPL 超卖时通常会发生什么？”

使用 field=momentum_rsi_zone、band=oversold、stats=true 调用 get_summary，即可返回后续情况的汇总分布：在 7 年历史数据中，每次进入超卖状态后的第 5、10、20、50 和 100 天，股票的表现如何。

“我的自选列表有什么变化？”

get_watchlist_changes 只会返回上次管线运行以来字段级别的状态转换 — 进入区间、退出区间和状态变化 — 这样 Agent 就能报告发生了什么变化，无需拉取每个股票代码的完整摘要。

为什么不直接传入原始 OHLCV？

模型可以根据原始 K 线计算 RSI。但如果提供原始 OHLCV 并询问“AAPL 看起来看涨吗？”，模型就会把上下文消耗在计算上 — 逐个计算指标 — 而不是完成你真正要求的分析：注意到 RSI 刚进入超卖区间，同时机构正在增持；回调幅度很大，但 200 日上升趋势依然完好；内部人士整个季度都在卖出。这才是分析。原始 K 线会让这些信息淹没在计算之中。

使用 TickerDB，模型会看到 "oversold"、"accumulation"、"strong_uptrend"，并立即将它们联系起来。

状态转换能提供更多信息。“BTC 上次达到这种超卖程度时发生了什么？”这需要根据 7 年的日线数据计算 RSI，找出每次进入超卖区间的情况，并计算此后发生了什么。使用 TickerDB，只需调用一次：使用 field=momentum_rsi_zone、band=oversold、stats=true 调用 get_summary。

设置

托管服务（推荐）

远程服务 https://mcp.tickerdb.com/mcp 支持 OAuth 2.1 和 Bearer 令牌身份验证。请使用 Streamable HTTP 传输（而非旧版 SSE）。

客户端	方法
Claude.ai	Settings → Connectors → Add → https://mcp.tickerdb.com/mcp → Authorize
Claude Code	claude mcp add --transport http --scope user tickerdb https://mcp.tickerdb.com/mcp
ChatGPT	Plugins → + → https://mcp.tickerdb.com/mcp → Create → Authorize
Cursor	.cursor/mcp.json → {"tickerdb": {"url": "https://mcp.tickerdb.com/mcp"}}
任意 MCP 客户端	使用 Authorization: Bearer tdb_...，通过 Streamable HTTP 连接 https://mcp.tickerdb.com/mcp

npm 包（本地 stdio）

适用于偏好本地进程的客户端（Claude Desktop 等）：

{
  "mcpServers": {
    "tickerdb": {
      "command": "npx",
      "args": ["tickerdb-mcp"],
      "env": {
        "TICKERDB_KEY": "tdb_your_api_key_here"
      }
    }
  }
}

请在 tickerdb.com/dashboard 获取 API 密钥。

结构

由三个包组成的 monorepo：

• shared/ — 工具定义、API 客户端和服务工厂（内部使用）
• remote/ — 部署在 mcp.tickerdb.com 的 Cloudflare Worker（Streamable HTTP + OAuth 2.1）
• local/ — 已发布的 npm 包 tickerdb-mcp（stdio）

两种传输方式使用相同的工具定义。MCP 服务只是一个轻量代理——访问控制、速率限制和字段筛选由 TickerDB API 处理。

身份验证

• Bearer 令牌 — Authorization: Bearer tdb_...
• OAuth 2.1 — 动态客户端注册、PKCE、令牌交换和撤销。/authorize 会重定向到 tickerdb.com 以征求授权。

允许未经身份验证的 initialize 和 tools/list 用于发现工具；tools/call 需要身份验证，并会返回带有 resource_metadata 的 401 Bearer 质询，以便顺利重新授权。

会话策略

远程 Worker 默认使用无状态传输——这是有意为之。所有工具均为无状态请求/响应，且 Cloudflare Worker 的内存仅限于各个 isolate。无状态模式可避免边缘会话丢失，从而防止连接器发现的命名空间失效。设置 MCP_SESSION_MODE=stateful 可进行显式会话调试。

开发

npm install                              # workspace dependencies
npm run build                            # type-check remote + shared
npx wrangler dev                         # remote dev server
cd local && npm install && npm run build  # npm package

部署

# Remote server
npx wrangler deploy

# npm + MCP Registry (recommended)
export MCP_PUBLISHER_KEY="your_saved_tickerdb_registry_private_key_hex"
./release.sh mcp patch

# npm only
cd local && npm version patch && npm run build && npm publish