教程

Today 接入 A 股数据

在 Today 里用自定义 MCP 接入 A 股数据:手机操作,不用开电脑,也不用装 SDK。配置一次,之后直接问行情、财务和 K 线。

先说结论:手机端就能接

Today 是 Today AI 的个人助理 App,跑在云端,支持自定义 MCP。

我们的 MCP 端点是远程 Streamable HTTP,不需要你在本地开服务、开端口或装 Python。

所以你只需要 Today App 和一个 ashareapi Key,不用打开电脑。

  • 协议:Streamable HTTP
  • 鉴权:Bearer Token
  • 地址:https://api.ashareapi.com/mcp
  • 不需要本地 MCP / localhost / 端口转发

接入前准备

  • 安装并登录 Today(iOS / Android / Mac 均可)
  • 准备一个 ashareapi API Key;建议单独建只读 Key,不要复用到其他产品
  • 确认 Key 可用:先调一次 GET /v1/quote?code=sh600519

四步接入 Today

入口:设置 → 连接应用 → + 添加自定义 MCP。在「通过链接添加」里填 MCP 链接,下一步再选认证方式和 Token。

  • 第一步:打开 Today 的设置,进入「连接应用」。
  • 第二步:点右上角 +,选择「添加自定义 MCP」。
  • 第三步:选「通过链接添加」,MCP 链接填 https://api.ashareapi.com/mcp,勾选风险确认后点「下一步」。
  • 第四步:名称填 ashareapi,认证方式选 Bearer token,Token 只填 API Key 本身,点「添加」。

注意:下拉已经选了 Bearer,Token 框不要再手写 Bearer,否则会变成 Bearer Bearer sk-...。

验证:先看工具,再问三个问题

添加成功后,Today 会读取 MCP 的工具列表。先确认能看到 ashare_quote、ashare_finance、ashare_kline,再用三个问题验证取数链路。

在 Today 里直接问
查一下 600519 最新行情

查一下 600519 2026Q3 营收

给我 600519 最近 30 天日 K
  • 行情失败:先确认代码带市场前缀,如 sh600519,不是裸 600519。
  • 财务失败:确认 Key 档位包含财务端点,且请求的是具体报告期。
  • K 线失败:确认 count 没有超过单次上限;需要更多就分批。

401 或看不到工具,怎么排查

401 Unauthorized
Token 是否填错、是否多了 Bearer
只填 Key;或改填 Bearer <Key> 再试
看不到工具
URL 是否走错域名
确认是 api.ashareapi.com,不是 ashareapi.com
连接失败
尾斜杠/网关
先试 https://api.ashareapi.com/mcp/
客户端不能填 Header
认证方式限制
用兜底 URL:https://api.ashareapi.com/mcp?key=<KEY>
工具调用超时
单次结果过大
减少 count / limit / num,或分批请求

兜底 URL 会把 Key 放进 URL,可能进入日志;能用 Bearer 就不要用 Query Key。

能问什么,不能问什么

  • ✅ 行情、K 线、财务、资金流、龙虎榜、板块、ETF、可转债、宏观等数据查询
  • ✅ 把查询结果整理成表格、摘要、对比
  • ⛔ 不自动交易、不接券商、不承诺收益
  • ⛔ 不构成投资建议;数据按接口返回的日期和口径解释
  • ⛔ 不把缺少的字段补成 0,不把上一交易日的价说成实时价

用哪一档:免费先试,不够再升级

先用免费工具验证链路;财报、批量、选股和研究型调用再按档位升级。价格以 完整定价页 为准,下面只是按 Today 使用场景给出的选择建议。

体验版
¥9.9 买断
1 万次 · 30 次/分 · 24 个端点
看财报、分红、板块,个人轻量研究
标准版
¥29.9 买断
10 万次 · 120 次/分 · 46 个端点
日常研究、公告/资金/更多数据
专业版
¥99 买断
50 万次 · 300 次/分 · 80 个端点
选股、批量财务、Agent 研究
机构版
¥199/月
10 万次/日 · 600 次/分 · 96 个端点
团队、多 IP、机构研究

先接免费工具试通链路;需要财报/K线批量/选股时再升级:

¥9.9 体验版 · ¥29.9 标准版 · ¥99 专业版 · 机构版 · 完整定价

Today 负责对话和任务编排;数据来自 ashareapi。回答里的每个数字都应能回到接口字段,而不是模型记忆。

常见问题

真的不用开电脑吗?

不用。Today 和我们的 MCP 都在云端,手机 App 里完成配置即可;不需要本地服务、端口或 Python 环境。

Token 填 Key 还是 Bearer Key?

认证方式选 Bearer token 后,Token 框通常只填 Key。若客户端提示格式错误,再试 Bearer <Key>。

为什么今天没有实时价?

先看返回的 date 是不是交易日。休市日、停牌或上游延迟时,最新一根可能不是“今天”;不要把上一交易日的收盘价说成实时价。

免费能用吗?

可以先接免费工具试用;财务/K 线等端点需要对应 Key 档位。具体额度和计费看 /pricing。

能接其他 Personal Agent 吗?

同一套远程 MCP 形态可以接支持自定义 MCP 的客户端;每个客户端的入口和认证字段不同,Today 这条已按实机界面验证。

最后更新: 2026-10-31

Today 入口按 2026-10-31 实机界面(设置 → 连接应用 → 添加自定义 MCP → 通过链接添加 → Bearer token);MCP 地址与 Bearer 鉴权以 ashareapi 线上 MCP 端点和 mcp_remote.py 为准;行情/财务/K线字段以接口实际返回为准。