stock-analysis-lianghua

核心用法

stock-analysis 提供两条使用路径：

1. 快速独立分析：执行 analyze_stock.py 脚本，输入股票代码即可获取完整技术分析报告。支持自定义分析日期、回看天数、指标组合，数据源自动容灾切换（Stooq → Yahoo Chart → yfinance → 本地缓存）。

2. TradingAgents 集成：作为 LangGraph 多智能体系统的分析师节点开发模板，支持市场分析、基本面、新闻、社交媒体四大分析师类型，遵循统一的 create_xxx_analyst(llm, toolkit) 工厂模式。

显著优点

• 零配置开箱即用：独立脚本无需 API key，Stooq 免费数据源不限速
• 多源容灾机制：4 级 fallback 确保数据可用性，自动本地缓存
• 指标覆盖全面：10 个核心技术指标（SMA/EMA/MACD/RSI/布林带/ATR/VWMA）
• 智能分析逻辑：内置趋势判断、动量分析、波动率评估、短期信号生成
• 双市场支持：A 股（akshare）与美股（yfinance/Finnhub/SimFin）工具链完整
• 防死循环设计：工具调用上限 3 次，强制生成最终报告

潜在缺点与局限性

• 数据延迟：免费数据源（Stooq/Yahoo）存在 15-30 分钟延迟，不适合高频交易
• 指标上限：单次最多 8 个指标，复杂策略需多次调用
• A 股工具依赖：akshare 接口稳定性受东方财富等平台影响
• 离线数据局限：美股离线工具依赖 SimFin/Finnhub 历史数据，覆盖度有限
• 无实时行情：不支持 Level-2 盘口、逐笔成交等微观结构数据

适合人群

• 量化研究入门者：快速验证技术策略原型
• TradingAgents 开发者：扩展多智能体分析能力
• 个人投资者：非实时持仓分析与趋势跟踪
• 教育场景：技术指标教学与可视化演示

常规风险

• 数据准确性风险：免费数据源可能存在复权错误、停牌日异常值
• 过拟合风险：内置分析逻辑基于经典阈值（RSI 70/30、MACD 金叉死叉），未经过样本外验证
• 模型幻觉风险：LLM 生成的综合分析可能存在解释偏差，需人工复核
• 合规风险：A 股数据爬取需遵守 akshare 及源网站使用协议

股票分析 Skill 综合评估

核心用法

股票分析 Skill 是一个专为 LangGraph 多智能体架构设计的分析模块。它允许用户通过命令行独立分析任意股票，或将其无缝集成到 TradingAgentsV2 交易框架中，作为分析师节点使用。该 Skill 支持美股（如 META, AAPL）和港股（如 0700.HK），能够自动从 Stooq、Yahoo Finance 等多个公开金融数据源获取行情，并计算 RSI、MACD、布林带等超过 10 种经典技术指标。最终，它会生成一份包含近期行情、技术指标趋势、综合研判（趋势、动量、波动率）及汇总表格的专业分析报告。

显著优点

• 架构清晰，双重模式：既可作为独立脚本进行快速单股分析，又可作为标准的 LangGraph 分析师节点，灵活易用。
• 多源容灾，稳定可靠：内置从 Stooq 到 Yahoo Finance 再到本地缓存的四级数据获取容灾机制，确保在网络波动时仍能正常工作。
• 分析逻辑专业：模仿专业市场分析师思路，综合运用均线排列、RSI 阈值、MACD 交叉等经典策略进行趋势和动量判断，而非简单罗列数据。
• 安全合规，代码规范：经安全认证评获 S 级，代码结构符合规范，仅通过 HTTPS 获取公开金融数据，无任何数据外泄、后门或提示词投毒等风险。

潜在缺点或局限性

• 仅限技术分析：该 Skill 专注于价格和成交量派生出的技术指标，不包含基本面、新闻舆情或宏观数据的分析能力，需配合其他分析师节点才能构成完整的分析体系。
• 依赖外部数据源：分析质量高度依赖 Stooq、Yahoo Finance 等第三方 API 的可用性和数据准确性，尽管有容灾机制，但任何免费数据源都存在偶发服务中断或延迟的可能。
• 供应链透明度低：Skill 来源为内部注册表（T3 可信度），维护者信息不透明且无公开仓库，用户需自行评估长期维护和持续更新的可靠性。

适合的目标群体

• 量化交易初学者：适合希望通过命令行快速验证交易想法或学习技术指标应用的入门用户。
• 独立交易个人：需要一款轻量级、无需复杂配置且安全可靠的工具来辅助日常选股和盘后复盘的中小投资者。
• 算法交易开发者：正在基于 LangGraph 构建多智能体交易系统的开发者，可直接将该 Skill 作为市场分析节点集成，加速原型开发。

使用风险与注意事项

• 常规风险：分析结果基于历史数据，不代表未来表现，任何策略都存在过拟合和失效的可能。用户应将其作为决策参考，而非唯一的投资依据。
• 依赖和版本风险：当前未提供 requirements.txt 等依赖锁定文件，在不同环境下安装的 yfinance、stockstats 等包版本可能不一致，存在潜在的兼容性风险。
• 法律合规风险：Skill 未包含开源许可证，商业使用或二次分发可能面临版权不明的法律风险。建议要求维护者补充明确的开源协议。