AI Agent 接入 A 股数据
MCP Server · Python SDK · REST — 结构化输出，Agent 读得懂注册即用：免费 500 次/天（日线全历史）—— 免费注册 · 想解锁全接口？¥9 = 专业版 7 天（首购专享）
一、为什么 Agent 用这份数据省心
- 响应即结构化：REST 全部返回 JSON 信封（rows 字段直出记录数组），SDK/MCP 直接给 DataFrame 或紧凑 JSON，无需解析网页或清洗脏字段；
- 代码自动归一：
600519.SH、sh600519、600519任意写法都认，响应统一回带市场前缀完整码——Agent 不用维护代码映射表； - 错误可自解释：429（当日配额用尽）、403（需更高档位）文案直接写明原因与出路，Agent 读错误信息即可自我纠正；
- 单位全局约定：成交量统一「股」、成交额统一「元」，跨接口无换算陷阱。
二、MCP Server（推荐：Claude Desktop / Cursor 即插即用）
官方 MCP Server 随 Python SDK 一起分发（stdio 模式，跑在你本机，数据请求带你的 API Key 直连平台）：
pip install 'top369[mcp]'
Claude Desktop — 编辑 claude_desktop_config.json：
{
"mcpServers": {
"top369": {
"command": "top369-mcp",
"env": { "TOP369_API_KEY": "sk-xxxxxxxxxxxx" }
}
}
}Cursor — ~/.cursor/mcp.json 同样结构（"command": "top369-mcp" + TOP369_API_KEY）。配置重启后，Agent 即可用下方 47 个工具直接查数据。
Windows 提示：若 Claude/Cursor 报「找不到 top369-mcp」（pip 脚本目录未进 PATH），把配置里的 "command": "top369-mcp" 换成 "command": "cmd"、"args": ["/c", "top369-mcp"] 即可。
三、MCP 工具清单（47 个，与 SDK 方法同名同参）
| 工具 | 说明 |
|---|---|
stock_list | 证券列表与关键字搜索（股票/ETF/可转债/指数；name 模糊 / code 精确） |
stock_info | 单个证券基本信息 |
day_kline | 日K线（全部历史 / 区间 / 前后复权；date= 全市场单日截面；codes= 批量≤100码） |
adjust_factor | 复权因子序列（可据因子本地复权） |
minute_kline | 多周期分钟 K 线（1/5/15/30/60 分钟；区间模式一键取历史） |
minute | 分时逐分钟快照（盘中走势/尾盘异动；逐笔用 tick） |
tick | 逐笔成交（大单方向/盘口节奏；日级统计用 tick_stats） |
period_kline | 周线/月线/年线（SDK 本地聚合，跨除权周期配 qfq） |
financial | 报告期财务快照（约400字段，建议 fields 挑列） |
report_calendar | 财报披露时间表（预约披露日前瞻） |
earnings_forecast | 业绩预告（预告类型/公告日） |
blocks | 个股所属板块（行业/概念） |
st_list | ST / 风险警示名单（每日快照，支持历史日期） |
name_history | 个股名称变更史（含 ST 戴摘帽时间线） |
special_list | 特殊名单三模式：无参=名单目录（沪深港通/融资融券/指数成分…+成员数）/ list_name=名单全量成员 / code=个股所属名单反查 |
hsgt | 沪深港通标的名单（sh/sz/hk/all） |
trade_calendar | 交易日历（区间内交易日升序） |
is_trading_day | 是否交易日（调度脚本「今天要不要跑」） |
last_trading_day | 最近交易日（盘后任务「拉哪天的数据」，节假日自动回退） |
f10 | F10 公司资料（股东研究/分红扩股/财务分析等17栏目；专业版） |
lhb | 龙虎榜每日明细（上榜原因/净买额；专业版） |
lhb_detail | 个股上榜营业部席位明细（专业版） |
lhb_history | 个股历次上榜记录（专业版） |
lhb_active | 活跃龙虎榜席位（上榜次数/连买连卖；专业版） |
lhb_yyb | 龙虎榜营业部明细（地区/买卖方；专业版） |
margin | 融资融券（市场序列 / 个股全历史 / 全市场单日截面；专业版） |
inst_holdings_rank | 私募机构持股榜（持股市值/占流通比） |
inst_holdings_chg | 机构增减持动静（持有数/买卖；日快照） |
holders_chg | 股东增减持动静（增持/减持/净增持市值） |
rating | 券商研报评级流（5买4增3中2减；专业版） |
zdt | 涨跌停打板：连板天梯 / 跌停名单 / 涨停揭秘（专业版） |
zdt_board_stat | 连板天梯·板块统计（涨停家数/高度/晋级率；专业版） |
zdt_board_height | 板块连板高度序列（880/881板块；专业版） |
themes | 主题题材→成分股映射（题材清单/成分股） |
quote_snapshot | 盘后五档快照（收盘/量额/买卖五档；基础版） |
tick_stats | 分笔日统计（内外盘主动买卖/大单；基础版） |
index_breadth | 每日复盘·指数涨跌家数（9指数；专业版） |
movers | 每日复盘·涨跌榜（个股/板块RS榜；专业版） |
bk_leaders | 板块轮动/异动快照（预计算榜单；专业版） |
block_trades | 大宗交易全量列表（成交价/额/量；专业版） |
ipo_audit | 新股审核/发行全队列（发行价/募资/过会） |
ah_premium | AH 溢价表（A/H 收盘价+溢价率；专业版） |
account | 账户档位与配额（遇 403 时先查它） |
usage | 当日用量与余量（遇 429 时先查它） |
工具输出默认紧凑 JSON 并做行数截断保护（大名单防撑爆上下文），错误统一为 {"error","status","hint"} 结构。分时（minute）/逐笔（tick）默认展示最新 100 行，全量请走 SDK。
四、不用 MCP？SDK 与 REST 同样三行起步
Python SDK（返回 pandas DataFrame，适合脚本与回测）：
import top369 as gp
pro = gp.pro_api("sk-xxxxxxxxxxxx") # 控制台复制你的 API Key
df = pro.day_kline(code="sz000001", start_date="2024-01-01", adjust="qfq")
print(df.tail())REST（任意语言，请求头 X-API-Key）：
curl -H "X-API-Key: sk-xxxxxxxxxxxx" "https://api.369.top/api/a/stock/day_kline?code=sz000001&limit=5"全部端点契约见 API 文档，机器可读描述见 OpenAPI 规范；本站另有 /llms.txt 站点导读供 LLM 爬取。