agent-stock

核心功能概述

agent-stock 是一款面向量化交易的 CLI 工具，整合了实时股票数据获取与 AI 辅助决策工作流。核心能力分为三大模块：

1. 市场数据层

• 多市场支持：A股（ab）、港股（hk）、美股（us），涵盖主要指数、行业板块热力图、市场排序
• 智能选股：支持自然语言条件输入（如"MACD金叉；市盈率<100；市值>50亿"），降低量化门槛
• 板块分析：申万行业板块多维度排序（priceRatioD5/D20/D60/周52/年等）

2. 个股数据层

• 全维数据：实时行情、日K线、EMA/BOLL/KDJ/RSI技术指标、资金流向（主力/散户）、相关板块、新闻资讯
• 批量查询：支持多代码并发查询，格式统一（A股6位数字/港股5位数字/美股us.ticker）

3. 决策工作流

• 短线选股：基于技术指标+资金面的系统化筛选流程
• 交易决策：个股买卖时机判断框架
• 持仓分析：现有持仓的风险与优化建议

显著优点

| 维度 | 优势 |

|------|------|

| 易用性 | 自然语言选股替代复杂公式，CLI 即装即用 |

| 覆盖度 | 三市场统一接口，技术指标与资金面数据完整 |

| 扩展性 | 工作流文档化（screen/trade/holdings），可自定义策略 |

| 实时性 | 行情、资金、新闻等数据实时或准实时更新 |

潜在局限与风险

数据质量：依赖第三方数据源，极端行情下可能存在延迟或缺失；技术指标计算逻辑未开源验证，交叉验证必要性高。

策略有效性：内置"短线交易"工作流未披露回测业绩、夏普比率、最大回撤等核心指标，存在"过拟合历史数据"风险。

合规边界：作为"交易建议"输出工具，可能触及证券投资咨询监管灰色地带；用户需自行承担投资决策责任。

技术依赖：CLI 形态对非技术用户有门槛；Python/uv 环境依赖可能产生版本兼容问题。

适合人群

• 具备 Python 基础、希望快速搭建量化数据管道的个人投资者
• 需要多市场（A/港/美）统一数据接口的策略研究员
• 已有自主策略、仅需数据工具支撑的半自动交易者

不适合：完全无编程经验者、追求一键跟单的小白用户、需合规持牌投资顾问服务的机构投资者。

常规风险等级

• 市场风险：高（股市固有波动）
• 数据风险：中（第三方数据源不确定性）
• 合规风险：中（投资建议性质界定模糊）
• 技术风险：低（开源工具可审计）

核心用法

agent-stock 是一款面向量化交易的 AI Agent 技能包，通过命令行工具 stock 提供完整的股市数据获取与交易决策支持。用户可通过自然语言条件语句执行智能选股（如"MACD金叉；市盈率小于100；市值大于50亿"），也可获取大盘指数、行业热力图、个股详情、资金流向等实时数据。覆盖 A 股、港股、美股三大市场，支持批量查询与技术指标分析（KDJ、RSI、BOLL、EMA）。

显著优点

1. 多市场覆盖：同时支持 A 股（6位代码）、港股（5位代码）、美股（us.ticker格式），满足全球化投资需求。
2. 自然语言选股：stock query 支持用中文条件语句组合筛选，大幅降低量化选股的技术门槛。
3. 数据维度丰富：除基础行情外，集成日K数据、技术指标、资金流向、板块关联、最新资讯等，形成完整分析闭环。
4. 工作流封装：内置短线选股、交易决策、持仓分析三大工作流，可直接应用于实际投资场景。
5. 可信开发者：作者为 Apple 员工，GitHub 11 年开发历史，拥有多个高星开源项目，代码质量有保障。

潜在缺点与局限性

1. 功能依赖外部 CLI：Skill 本身为纯 Markdown 文档，实际数据获取依赖独立安装的 agent-stock Python 包，版本兼容性需自行维护。
2. 无内置回测机制：仅提供数据查询和决策建议，缺乏历史数据回测验证策略有效性。
3. 实时性受限：数据质量取决于底层 CLI 工具的数据源，未明确说明延迟和更新频率。
4. 投资合规风险：提供具体交易建议（"清仓"/"加仓"），但未在 Skill 文档中显式声明不构成专业投资建议。

适合人群

• 个人量化投资者：希望快速构建选股策略、获取多维度数据的中高级散户
• 技术分析爱好者：依赖 KDJ、MACD、RSI 等指标进行短线交易的用户
• 多市场交易者：同时关注 A 股、港股、美股的市场参与者
• AI Agent 开发者：需要集成股票数据能力的金融类 Agent 应用构建者

常规风险

• 投资风险：Skill 提供的选股和交易建议基于技术指标，不构成专业投资咨询，股市波动可能导致本金损失
• 数据准确性风险：依赖第三方数据源，存在延迟或错误可能，关键交易决策需交叉验证
• 依赖维护风险：外部 CLI 工具更新可能导致接口不兼容，需持续关注版本匹配
• 合规风险：部分市场（如美股）对投资咨询有严格监管，自动化交易建议可能涉及合规边界