关于 moomoo-quote
moomoo-quote 是通过本地 `moomoo` CLI 查询市场数据和行情的 Skill。它说明命令选择、代码格式、身份验证检查和分页处理,并区分单次查询与实时推送。
主要功能
- 01通过 `moomoo` CLI 查询市场数据
- 02规范市场和证券代码格式
- 03检查身份验证与网络连通性
- 04按分页令牌获取行情数据
- 05将实时推送请求指向 WebSocket
适用场景
- 01查询指定市场代码的行情
- 02获取分页的历史行情数据
- 03确定实时行情更新的适用方式
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ moomooopen/ moomoo-agent-hub --skill moomoo-quote安装后在 Claude Code 中输入/moomoo-quote确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
references/cli-parameters.mddictionaries.mdpagination.mdwebsocket-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