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,再用三个问题验证取数链路。
查一下 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,或分批请求 |
Bearer <Key> 再试api.ashareapi.com,不是 ashareapi.comhttps://api.ashareapi.com/mcp/https://api.ashareapi.com/mcp?key=<KEY>count / limit / num,或分批请求兜底 URL 会把 Key 放进 URL,可能进入日志;能用 Bearer 就不要用 Query Key。
能问什么,不能问什么
- ✅ 行情、K 线、财务、资金流、龙虎榜、板块、ETF、可转债、宏观等数据查询
- ✅ 把查询结果整理成表格、摘要、对比
- ⛔ 不自动交易、不接券商、不承诺收益
- ⛔ 不构成投资建议;数据按接口返回的日期和口径解释
- ⛔ 不把缺少的字段补成 0,不把上一交易日的价说成实时价
用哪一档:免费先试,不够再升级
先用免费工具验证链路;财报、批量、选股和研究型调用再按档位升级。价格以 完整定价页 为准,下面只是按 Today 使用场景给出的选择建议。
| 档位 | 价格 | 额度 | 适合 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 环境。
认证方式选 Bearer token 后,Token 框通常只填 Key。若客户端提示格式错误,再试 Bearer <Key>。
先看返回的 date 是不是交易日。休市日、停牌或上游延迟时,最新一根可能不是“今天”;不要把上一交易日的收盘价说成实时价。
可以先接免费工具试用;财务/K 线等端点需要对应 Key 档位。具体额度和计费看 /pricing。
同一套远程 MCP 形态可以接支持自定义 MCP 的客户端;每个客户端的入口和认证字段不同,Today 这条已按实机界面验证。
最后更新: 2026-10-31
Today 入口按 2026-10-31 实机界面(设置 → 连接应用 → 添加自定义 MCP → 通过链接添加 → Bearer token);MCP 地址与 Bearer 鉴权以 ashareapi 线上 MCP 端点和 mcp_remote.py 为准;行情/财务/K线字段以接口实际返回为准。