mcpField
M
moomoo-quote

moomoo-quote

github.com/moomooopen数据与数据库2174 次安装4 天前更新
代码仓库

关于 moomoo-quote

moomoo-quote 是通过本地 `moomoo` CLI 查询市场数据和行情的 Skill。它说明命令选择、代码格式、身份验证检查和分页处理,并区分单次查询与实时推送。

主要功能

  1. 01通过 `moomoo` CLI 查询市场数据
  2. 02规范市场和证券代码格式
  3. 03检查身份验证与网络连通性
  4. 04按分页令牌获取行情数据
  5. 05将实时推送请求指向 WebSocket

适用场景

  1. 01查询指定市场代码的行情
  2. 02获取分页的历史行情数据
  3. 03确定实时行情更新的适用方式

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/moomooopen/moomoo-agent-hub --skill moomoo-quote

安装后在 Claude Code 中输入/moomoo-quote确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

references/
cli-parameters.md
dictionaries.md
pagination.md
websocket-push.md

详细介绍

moomoo 行情

使用本地可用的 moomoo CLI 查询市场数据和行情。默认使用用户的语言作答;命令、标志、JSON 字段、代码、枚举值和错误代码保持不变。

安装 moomoo CLI

此技能需要 moomoo CLI。在 PATH、~/.moomoo/bin/moomoo 或 Windows 上的 %LOCALAPPDATA%\MoomooCLI\bin\moomoo.exe 中查找该二进制文件。

如果找不到该二进制文件,请先询问用户,然后再安装。未经明确同意,不要运行安装程序。

macOS / Linux:

curl -fsSL https://raw.githubusercontent.com/MoomooOpen/moomoo-cli/main/scripts/install.sh | sh

Windows PowerShell:

iwr -UseBasicParsing https://raw.githubusercontent.com/MoomooOpen/moomoo-cli/main/scripts/install.ps1 -OutFile install.ps1
powershell -ExecutionPolicy Bypass -File .\install.ps1

要更新现有 CLI,请运行 moomoo update。

使用 npx 添加或更新此技能:

npx skills add -y -g MoomooOpen/moomoo-agent-hub --skill moomoo-quote
npx skills update moomoo-quote -g -y

规则

  • 执行行情命令前,如果无法解析 moomoo,请遵循安装 moomoo CLI。
  • 执行任何需要身份验证的市场数据命令前,优先使用 moomoo auth status --format json;检查网络连通性时,使用 moomoo check --format json。
  • 按照此技能的调用约定,在 Bash 中调用 moomoo 时,始终在命令末尾追加隐藏的内部标记 --source skill。在 --source skill 模式下,CLI 会自动检测 Codex/Claude Code 并报告 agent_name;只有在自动检测不够准确且已确认 CLI 支持时,才追加 --agent codex 或 --agent claude_code。不要在向用户展示的命令中包含这些内部标记。
  • 切勿读取或打印令牌文件内容。CLI 会自动附加 OAuth Bearer 身份验证。PERMISSION_DENIED 表示服务端拒绝了权限或市场数据访问资格,并不能证明缺少令牌标头。
  • 构建命令时,只添加必要参数:如果 CLI 标志已有默认值,且用户未指定其他值,则省略该标志。
  • 仅在 Agent 需要解析命令输出时添加 --format json。向用户展示的命令可以使用默认的表格输出。
  • 行情代码使用 MARKET.CODE 格式,例如 US.AAPL、HK.00700、SH.600519、SZ.000001 和 CC.BTCUSD。CLI 会将 HK.700 规范化为 HK.00700,并将市场/代码转换为大写。除非能够可靠地确定市场,否则不要传入旧后缀格式(如 700.HK)或不带市场前缀的代码(如 AAPL)。
  • 用户提到旧 REST 端点命令名称时,必须映射到当前的聚合命令和选择器标志。不要调用未注册的扁平端点命令。
  • 对于分页行情接口,使用 --format json,并严格遵循 pagination.has_more / pagination.next_key。next_key 是不透明值,必须按原样使用,不得解析或构造。
  • history-kline 和 capital --view history 使用 --next-time,而非 --next-key。
  • watchlist --action add/delete/move-out 会修改用户的自选列表。除非用户已明确要求执行该修改,否则应先确认目标分组和代码。
  • 不要执行证券、加密货币或模拟交易订单。证券交易请使用 moomoo-trading,加密货币交易请使用 moomoo-crypto,模拟交易请使用模拟交易技能。
  • 对于实时推送(订阅、推送行情/订单簿/代码/K 线、实时经纪商队列),CLI 无法替代 OpenD。请引导用户使用 Open API Quote Push WebSocket(wss://webapi-quote.moomoo.com/ws):进行身份验证、订阅,并将经纪商队列设为 BROKER_QUEUE。阅读WebSocket 推送参考和websocket-quote-push.md。不要使用 OpenD 或已移除的 moomooapi 订阅脚本。

参考资料

  • 构造报价命令、选择聚合命令变体,或检查必需/默认标志时,请阅读 CLI parameters。
  • 将用户语言映射到市场、证券类型、K 线类型、复权类型、交易时段、板块类别、期权筛选条件,或解读报价枚举字段时,请阅读 dictionaries。
  • 获取多页数据或说明报价分页的工作方式时,请阅读 pagination。
  • 用户需要实时推送或经纪商队列,而非一次性 REST 报价时,请阅读 websocket-push。

评论

支持 Markdown