hhxg A-share Market Data
China A-share market data, stock screening and research tools over remote MCP. Paid subscription required. Research only, not investment advice.
Hosted MCP Server
npx add-mcp 'https://hhxg.top/mcp/rpc'Installs into Claude Code, Codex, Cursor and more
Documentation
能做什么
| 功能 | 一句话 | 可以这样问 |
|---|---|---|
数据目录 discover_data | 列出站内有哪些数据集、字段含义与取数方式。 | 「站里有哪些和龙虎榜有关的数据？」 |
通用取数 query_dataset | 按数据集取数：选列、按日期或区间回溯、按股票代码取。 | 「拉最近一个月的融资融券余额。」 |
研报 / 公告 / 新闻检索 search_documents | 研报、机构纪要、公告、新闻、董秘问答统一检索，最长回看 90 天。 | 「最近一周固态电池有哪些研报和公告？」 |
读单篇 get_document | 读检索结果里某一篇的摘要或分节内容（研报仅摘要）。 | 「把第 2 篇的要点讲一下。」 |
条件选股与策略预设 screen_stocks | 按指标条件筛全市场，支持两个指标互相比较，也可直接用策略预设。 | 「筛出收盘价站上 20 日线且放量的股票。」 |
个股诊断 diagnose_stock | 一只股票的行情、资金、异动与题材归属证据。 | 「诊断一下 600519。」 |
连板晋级预测 predict_lianban_promotion | 估计连板股次日晋级的概率。 | 「今天的 3 连板明天晋级概率多大？」 |
盘中实时 get_realtime | 交易时段约 1 分钟一帧：涨跌停池、个股最新价与指标、按盘中值筛选。 | 「现在涨停多少家？炸板率多少？」 |
另有只读资料（数据集说明、投资日历、知识库）与现成的提问套路（每日复盘 / 个股诊断 / 板块轮动），含参数的完整清单见 /mcp/info 。
Max 会员专属 AI 接入只对 Max 会员开放（Max 月付 ¥99/30 天起，含商用许可）。价格与各档权益对比见 会员页 。
三步接入
1. 选客户端
选你在用的 AI 客户端（已核对 15 个客户端的写法），后两步只显示所选客户端的做法。
推荐 国产 国际 其他
2. 生成 AI 接入 Token
登录 Max 会员后生成一个 AI 接入 Token，MCP 与 REST 数据 API 共用；支持授权登录的客户端可以跳过这一步，按第 3 步直接授权。
直接授权，免 Token ：这个客户端支持授权登录——按第 3 步连接时会跳到恢恢量化， 用会员码登录并授权（Max 权益），完成后自动回到客户端。每个授权占 1 个 Token 名额， 显示在下方列表里（ OAuth · 客户端名 ），可随时撤销；名额满时再授权会自动替换最早的一个授权 （手工 Token 不受影响）。
3. 复制配置并验证
把所选客户端的配置片段复制到它的配置位置（生成 Token 后会自动填进片段），再按下面的验证方法确认接通。
安装在 DSH 的插件安装入口输入这个 GitHub 地址
https://github.com/Niceck/dsh-hhxg-market
插件把 Token 写进 profile 的 cordis.patch.yml，保存后重启 DSH 生效
# ~/.dsh/profiles/<profile>/cordis.patch.yml
- update:
- id: hhxg-market
config:
mcpToken: "<您的Token>"
# 从终端启动 DSH 也可以不改文件：export HHXG_MCP_TOKEN="<您的Token>"
# 不装插件、原生 MCP 直连：https://hhxg.top/mcp/rpc，请求头 Authorization: Bearer <您的Token>
DSH 暂不提供本插件的设置界面，Token 只能写配置文件或环境变量（从图形界面启动的 DSH 不一定继承 shell 环境变量）。
命令行安装
npm
dsh plugin --profile web add @hhxg/dsh-hhxg-market
GitHub
dsh plugin --profile web add github:Niceck/dsh-hhxg-market
国内网络下载慢，可先执行 npm config set registry https://registry.npmmirror.com 切到 npmmirror 镜像（全局生效，改回官方源： npm config delete registry ）。
实测： 我把选股条件直接「说」给 AI，它不但筛完全市场，还自己设计了 5 套策略
验证：在客户端里问一句「今天涨停多少家？」，能返回带日期的数据即接通。
用命令行验证（MCP Inspector）
npx @modelcontextprotocol/inspector https://hhxg.top/mcp/rpc \
--header "Authorization: Bearer <您的Token>"
能列出工具清单即连接正常；完整清单见 /mcp/info 。
支持的客户端
下面每个 AI 客户端连的都是同一个 MCP server、用同一个 AI 接入 Token；标「直接授权」的可以不填 Token，按授权登录连接。
- DeepSeek Harness DeepSeek · 插件 · 用 Token怎么配：把 Token 写进 profile 的 cordis.patch.yml，保存后重启 DSH 生效 DeepSeek Harness 接入教程
- Kimi Code CLI 月之暗面 · CLI · 用 Token怎么配：~/.kimi-code/mcp.json（项目级.kimi-code/mcp.json） Kimi Code CLI：看配置
- CodeBuddy Code 腾讯 · CLI / IDE · 用 Token怎么配：~/.codebuddy/.mcp.json（或下面一条命令） CodeBuddy Code 接入教程
- WorkBuddy 腾讯 · 桌面智能体 · 用 Token怎么配：设置 → MCP → 添加 MCP Server WorkBuddy：看配置
- Trae 字节跳动 · IDE · 用 Token怎么配：AI 设置 → MCP → 添加 → 手动配置 Trae 接入教程
- Qoder / 通义灵码 阿里云 · IDE · 用 Token怎么配：MCP 面板 → 手动添加（Qoder CN 即新版通义灵码） Qoder / 通义灵码：看配置
- Qwen Code 阿里云 · CLI · 用 Token怎么配：~/.qwen/settings.json（或 qwen mcp add --transport http） Qwen Code：看配置
- iFlow CLI（心流） 阿里 · CLI · 用 Token怎么配：终端执行（写入 ~/.iflow/settings.json） iFlow CLI（心流）：看配置
- Comate 百度 · IDE · 用 Token怎么配：~/.comate/mcp.json（项目级.comate/mcp.json） Comate：看配置
- OpenClaw 开源 · 智能体网关 · 用 Token怎么配：终端执行，再到 Settings → MCP 给该 server 填请求头 OpenClaw：看配置
- claude.ai Anthropic · 网页 / 桌面 · 直接授权（免 Token）怎么配：设置 → 连接器 → 添加自定义连接器，地址填下面一行，点「连接」 claude.ai：看配置
- Claude Code Anthropic · CLI · Token 或直接授权怎么配：终端执行（写入 ~/.claude.json） Claude Code 接入教程
- Codex CLI OpenAI · CLI · 用 Token怎么配：~/.codex/config.toml + 环境变量 Codex CLI：看配置
- Cursor Anysphere · IDE · 用 Token怎么配：~/.cursor/mcp.json（项目级.cursor/mcp.json） Cursor 接入教程
- Gemini CLI Google · CLI · 用 Token怎么配：~/.gemini/settings.json Gemini CLI：看配置
- 其他 MCP 客户端 扣子 / MiniMax Agent / Cline / Windsurf 等 · 通用 · 用 Token怎么配：任何支持远程 Streamable HTTP 且可填自定义请求头的客户端 其他 MCP 客户端：看配置
脚本取数
REST 数据 API · 适合脚本批量取数与 CSV 直链
不经 AI 客户端、想用脚本直接拉 JSON 时用 REST 接口 GET /api/data/<scope> ：用的是上面同一个 AI 接入 Token，放在 Authorization: Bearer 请求头里。
curl -H "Authorization: Bearer <您的Token>" \
https://hhxg.top/api/data/snapshot
统一信封 { success, scope, description, fetched_at, data } ；带月度归档的 scope 加 ?month=YYYYMM 返回 CSV 直链； GET /api/data/index 列出全部 scope。完整契约见 OpenAPI 规范 。
通过授权登录（OAuth）连接的客户端令牌不能用于脚本取数，请生成 AI 接入 Token。
端点范围（共 23 个 scope）
| scope | 内容 | 月度归档 | 计划更新 |
|---|---|---|---|
snapshot | 日报快照：赚钱效应/题材/连板天梯/游资/行业/焦点新闻聚合 | — | 交易日 20:22 起重算，预计 20:30 前更新完成（北京时间） |
hotmoney | 近 7 日游资龙虎榜席位明细 | — | 交易日 20:22 起重算，预计 20:30 前更新完成（北京时间） |
news | 近 7 日财经快讯（含 AI 利好/利空分类，支持?sentiment=利好|利空|中性|未分类 过滤） | — | 每天 06:10–23:10 每小时采集，线上按发布窗口刷新（北京时间） |
dongmi | 近 30 日董秘问答全量（?month=YYYYMM 取月度归档 CSV） | 是 | 交易日 20:22 起重算，预计 20:30 前更新完成（北京时间） |
theme-concepts | 题材概念成分股映射（每交易日更新） | — | 交易日 20:22 起重算，预计 20:30 前更新完成（北京时间） |
margin | 近 7 日融资融券余额与净买入（?month=YYYYMM 取月度归档 CSV） | 是 | 交易日 09:05 采集上一交易日数据并发布（北京时间） |
sentiment | 近 7 日市场情绪指标 | — | 交易日 20:22 起重算，预计 20:30 前更新完成（北京时间） |
strategy | 最新量化策略选股结果 | — | 交易日 20:22 起重算，预计 20:30 前更新完成（北京时间） |
themes-ranking | 最新题材热度排名 | — | 交易日 20:22 起重算，预计 20:30 前更新完成（北京时间） |
northbound | 近 7 日北向资金流向 | — | 交易日 20:22 起重算，预计 20:30 前更新完成（北京时间） |
breadth | 近 7 日大盘宽度（涨跌家数/涨停/跌停/赚钱效应）时序 | — | 交易日 20:22 起重算，预计 20:30 前更新完成（北京时间） |
funds | 近 7 日行业/板块资金流（主力净流入/流出排名） | — | 交易日 20:22 起重算，预计 20:30 前更新完成（北京时间） |
etf | ETF 全景榜：规模 / 成交额 / 涨幅 / 行业 ETF 排名（?month=YYYYMM 取日线月度归档 CSV） | 是 | 交易日 20:22 起重算，预计 20:30 前更新完成（北京时间） |
chipwork | 筹码工程：筹码集中度排名、获利盘比例高/低、行业筹码概览 | — | 交易日 20:22 起重算，预计 20:30 前更新完成（北京时间） |
stock-indicators | 个股技术指标榜：MACD/KDJ/RSI 等多维度排序与共振信号 | — | 交易日 20:22 起重算，预计 20:30 前更新完成（北京时间） |
concept-chain | 题材概念链：每日热点概念的链式传导路径 + 龙头/分歧/补涨股映射 | — | 交易日 20:22 起重算，预计 20:30 前更新完成（北京时间） |
indicator-resonance | 多指标共振信号：MA / MACD / RSI / 量能多周期同向信号股 | — | 交易日 20:22 起重算，预计 20:30 前更新完成（北京时间） |
risk-alerts | 风险警报：暴跌 / 出货 / 九转见顶 / 高换手下跌 4 类预警 | — | 交易日 20:22 起重算，预计 20:30 前更新完成（北京时间） |
resonance | 跨 KB 共振信号：技术 / 资金 / 题材 / 情绪同时确认的标的 | — | 交易日 20:22 起重算，预计 20:30 前更新完成（北京时间） |
strategy-full | 策略历史全统计：胜率 / 月度分布 / TOP winners&losers（多策略对比） | — | 交易日 20:22 起重算，预计 20:30 前更新完成（北京时间） |
community-sentiment | 社区情绪：综合情绪指数（情绪周期 + 股吧文本 + 热股榜涨跌）+ 社区热议个股 + 股吧热帖 | — | 每天 09:00 / 12:00 / 21:00 采集，线上随发布窗口刷新（工作日 9 / 15 / 22 点、周末 9 / 15 / 21 点，北京时间） |
moneyflow | 个股资金流月度归档：无参返回可用月份索引，?month=YYYYMM 取当月 CSV | 是 | 交易日 20:22 起重算，预计 20:30 前更新完成（北京时间） |
blocktrade | 大宗交易月度归档：无参返回可用月份索引，?month=YYYYMM 取当月 CSV | 是 | 交易日 20:22 起重算，预计 20:30 前更新完成（北京时间） |
帮助
额度与限制 · Token 安全 · 插件升级 · 许可边界
有哪些额度与限制？
- REST 数据 API：Max 300 请求/分钟，按会员计、多个 Token 共享；超限返回 429 并带
retry_after_seconds。 - AI 客户端里的工具另有按工具计的额度，超限时工具会直接说明。
- Token：Max：只签发一种「AI 接入 Token」（MCP 与数据 API 共用），最多 5 个并存（可命名），有效期至会员到期，续费后重新生成即可延长；可单个撤销，数分钟内生效；此前生成的数据 API token 到期前仍有效。
- 历史数据：两融 / 董秘问答 / 个股资金流 / 大宗交易 / ETF 日线有月度归档，其余为最新快照或近 7–30 日窗口。
- 不提供策略回测与分钟 K 线。
Token 泄露怎么办？
在第 2 步的 Token 列表里点「撤销」，数分钟内生效，再生成一个新的换上。
直接授权和手工 Token 有什么区别？
权限完全相同，都占 Token 名额、都能在列表里撤销。直接授权（OAuth）的令牌到期后由客户端按标准流程刷新，不用复制粘贴；手工 Token 一次生成、有效期至会员到期，适合不支持授权登录的客户端，或服务器 / CI 上长期运行的场景。
以前的数据 API token 还能用吗？
能，到期前继续有效，可在「脚本取数」里查看和撤销。现在不再单独签发：AI 接入 Token 同样能调 REST 接口，一个 Token 两边通用。
旧版 DSH 插件怎么升级？
0.7.0 之前的插件有一部分工具直接调用已于 2026-11-08 下线的公开接口，会报「数据不存在」；0.2.x 用到的旧工具名也已于 2026-10-27 下线（按旧名调用返回 TOOL_NOT_FOUND 并附替代写法）。按第 3 步重新安装一次即可升级到最新版，Token 配置不用改。
数据什么时候更新？
交易日 20:22 起重算，预计 20:30 前更新完成（北京时间）；新闻 每天 06:10–23:10 每小时采集，线上按发布窗口刷新（北京时间）；社区情绪 每天 09:00 / 12:00 / 21:00 采集，线上随发布窗口刷新（工作日 9 / 15 / 22 点、周末 9 / 15 / 21 点，北京时间）；两融 交易日 09:05 采集上一交易日数据并发布（北京时间）。每个响应带 fetched_at ；不指定日期时返回最新一份数据，按日期取历史数据时指定非交易日会提示没有该日数据。
和 Tushare 这类原始数据接口有什么区别？
本站提供的是加工过的衍生数据：龙虎榜席位统计、连板天梯与晋级率、异动分层、题材热度、AI 分类新闻、日报快照等，可直接进 Agent 或看板；原始日线与财务数据请用上游接口。
AI 投研助手、自定义 API 和 AI 接入有什么区别？
三者都是 Max 权益。AI 投研助手用站方模型，在 AI 投研页 直接提问；自定义 API 自带模型令牌，在 AI 投研页驱动 Agent 调站内工具，不占站内次数；AI 接入把同一套工具接进你自己的 AI 客户端。
Pro 能用 AI 接入吗？
不能。盘后复盘数据（T 日收盘定版）、全部会员工具、CSV 导出与历史回看；不含盘中实时选股、AI 投研、自定义 API（自带模型令牌）与 MCP / 数据 API；仅限本人研究。各档权益对比见 会员页 。
许可边界
相关入口： AI 投研助手 · 数据目录 · OpenAPI 规范 · llms.txt