mcpField
S
stock-analysis

stock-analysis

github.com/gracefullight其他4912.1k 次安装1 天前更新
代码仓库

关于 stock-analysis

使用 Yahoo Finance 数据分析美国股票和加密货币的命令行技能，也支持混合资产投资组合。它结合市场与风险背景，输出简明信号或结构化 JSON。

主要功能

  1. 01分析股票和支持的加密货币
  2. 02比较多个股票代码
  3. 03管理股票与加密货币组合
  4. 04评估基本面、动量和情绪
  5. 05标记时机、市场和行业风险
  6. 06输出文本摘要或 JSON

适用场景

  1. 01投资决策前查看某个代码的分析
  2. 02比较多只股票或加密货币
  3. 03跟踪组合价值、盈亏和周期回报

安装

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

$npx skills add https://github.com/gracefullight/stock-checker --skill stock-analysis

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

包含的文件

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

_meta.json
App-Plan.md
README.md
TODO.md
scripts/
analyze_stock.py
portfolio.py

详细介绍

股票分析（v5.0）

使用 Yahoo Finance 数据分析美国股票和加密货币。包含投资组合管理、加密货币支持和定期分析。

快速开始

重要： 仅将股票代码作为参数传入。命令中不要添加额外文本、标题或格式。

分析单个代码：

uv run {baseDir}/scripts/analyze_stock.py AAPL
uv run {baseDir}/scripts/analyze_stock.py MSFT --output json

比较多个代码：

uv run {baseDir}/scripts/analyze_stock.py AAPL MSFT GOOGL

加密货币分析（v5.0）

分析市值排名前 20 的加密货币：

uv run {baseDir}/scripts/analyze_stock.py BTC-USD
uv run {baseDir}/scripts/analyze_stock.py ETH-USD SOL-USD

支持的加密货币： BTC-USD、ETH-USD、BNB-USD、SOL-USD、XRP-USD、ADA-USD、DOGE-USD、AVAX-USD、DOT-USD、MATIC-USD、LINK-USD、ATOM-USD、UNI-USD、LTC-USD、BCH-USD、XLM-USD、ALGO-USD、VET-USD、FIL-USD、NEAR-USD

加密货币分析维度：

  • 市值（大盘／中盘／小盘分类）
  • 类别（智能合约 L1、DeFi、支付等）
  • 与 BTC 的相关性（30 天）
  • 动量（RSI、价格区间）
  • 市场背景（VIX、整体市场状态）

投资组合管理（v5.0）

创建和管理包含混合资产（股票 + 加密货币）的投资组合：

# Create portfolio
uv run {baseDir}/scripts/portfolio.py create "My Portfolio"

# Add assets
uv run {baseDir}/scripts/portfolio.py add AAPL --quantity 100 --cost 150.00
uv run {baseDir}/scripts/portfolio.py add BTC-USD --quantity 0.5 --cost 40000 --portfolio "My Portfolio"

# View holdings with current P&L
uv run {baseDir}/scripts/portfolio.py show

# Update/remove assets
uv run {baseDir}/scripts/portfolio.py update AAPL --quantity 150
uv run {baseDir}/scripts/portfolio.py remove BTC-USD

# List/delete portfolios
uv run {baseDir}/scripts/portfolio.py list
uv run {baseDir}/scripts/portfolio.py delete "My Portfolio"

投资组合存储位置： ~/.clawdbot/skills/stock-analysis/portfolios.json

投资组合分析（v5.0）

分析投资组合中的所有资产，并可选择性地查看特定时期的回报：

# Analyze portfolio
uv run {baseDir}/scripts/analyze_stock.py --portfolio "My Portfolio"

# With period returns (daily/weekly/monthly/quarterly/yearly)
uv run {baseDir}/scripts/analyze_stock.py --portfolio "My Portfolio" --period weekly
uv run {baseDir}/scripts/analyze_stock.py -p "My Portfolio" --period monthly

投资组合摘要包括：

  • 总成本、当前价值、盈亏
  • 特定时期回报（如有指定）
  • 集中度警告（单项资产占比 >30%）
  • 建议摘要（买入／持有／卖出数量）

示例：

  • ✅ 正确：uv run {baseDir}/scripts/analyze_stock.py BAC
  • ✅ 正确：uv run {baseDir}/scripts/analyze_stock.py BTC-USD
  • ❌ 错误：uv run {baseDir}/scripts/analyze_stock.py === BANK OF AMERICA (BAC) - Q4 2025 EARNINGS ===
  • ❌ 错误：uv run {baseDir}/scripts/analyze_stock.py "Bank of America"

仅使用股票代码（例如 BAC，而非 “Bank of America”）。加密货币请使用 -USD 后缀（例如 BTC-USD）。

分析组成部分

脚本会评估八个关键维度：

  1. 盈利超预期（权重 30%）：实际与预期 EPS、营收超预期／不及预期
  2. 基本面（权重 20%）：市盈率、利润率、营收增长、负债水平
  3. 分析师情绪（权重 20%）：评级共识、目标价与当前价格的对比
  4. 历史模式（权重 10%）：过去的财报后反应、波动率
  5. 市场背景（权重 10%）：VIX、SPY/QQQ 趋势、市场状态
  6. 行业表现（权重 15%）：股票与行业的对比、行业趋势
  7. 动量（权重 15%）：RSI、52 周价格区间、成交量、相对强度
  8. 情绪分析（权重 10%）：恐惧与贪婪指数、空头持仓、VIX 期限结构、内幕交易、看跌／看涨期权比率

情绪子指标：

  • 恐惧与贪婪指数（CNN）：反向指标（极度恐惧 = 买入机会，极度贪婪 = 谨慎）
  • 空头持仓：空头仓位高且有逼空潜力 = 看涨；空头仓位合理 = 看跌
  • VIX 期限结构：正向市场 = 自满／看涨；反向市场 = 紧张／看跌
  • 内幕人士活动：根据 SEC Form 4 文件统计 90 天内的净买入／卖出
  • 看跌／看涨期权比率：比率高 = 过度恐惧／看涨；比率低 = 自满／看跌

如果部分组成部分不可用，权重会自动归一化。

特殊时机检查：

  • 财报前警告（< 14 天）：建议持有，而非买入
  • 财报后暴涨检测（5 天内涨幅 > 15%）：提示“涨幅已计入价格”
  • 超买状况（RSI > 70 且接近 52 周高点）：降低置信度

时机警告与风险标记

脚本会检测高风险情形：

财报时机
  • 财报前阶段：如果距离财报发布不到 14 天，买入信号将变为持有
  • 财报后暴涨：如果财报发布后 5 天内股价上涨 > 15%，会警告“涨幅可能已计入价格”
技术风险
  • 超买状况：RSI > 70 且接近 52 周高点 = 高风险入场
市场风险
  • VIX 偏高：市场恐慌（VIX > 30）会降低对买入信号的信心
  • 避险模式（v4.0.0）：当避险资产（GLD、TLT、UUP）同时上涨时，买入信心会降低 30%
    • 检测黄金、美国国债和美元的避险行为
    • 当 GLD ≥ +2%、TLT ≥ +1%、UUP ≥ +1%（5 日涨幅）时触发
行业风险
  • 行业疲软：个股看起来可能表现不错，但资金可能正流出该行业
地缘政治风险（v4.0.0）

该脚本现在会扫描突发新闻（过去 24 小时），查找危机关键词，并自动标记受影响的股票：

  • 台海冲突：半导体（NVDA、AMD、TSM、INTC 等）→ 信心降低 30%
  • 中美紧张局势：科技/消费品（AAPL、QCOM、NKE、SBUX 等）→ 信心降低 30%
  • 俄乌冲突：能源/原材料（XOM、CVX、MOS、CF 等）→ 信心降低 30%
  • 中东局势：石油/国防（XOM、LMT、RTX 等）→ 信心降低 30%
  • 银行业危机：金融（JPM、BAC、WFC、C 等）→ 信心降低 30%

如果股票代码不在受影响列表中，但其所属行业受到影响，则信心降低 15%。

警报示例：

⚠️ SECTOR RISK: Tech supply chain and consumer market exposure (detected: china, tariff)
突发新闻警报（v4.0.0）
  • 扫描 Google News RSS，查找危机关键词（战争、衰退、制裁、灾难等）
  • 在注意事项中最多显示 2 条突发新闻警报（过去 24 小时）
  • 使用 1 小时缓存，避免过于频繁地调用 API

输出格式

默认（文本）：简明的买入/持有/卖出信号，包含 3-5 个要点和注意事项

JSON：包含评分、指标和原始数据的结构化数据，供进一步分析

局限性

  • 数据时效性：Yahoo Finance 的数据可能延迟 15-20 分钟
  • 情绪数据的时效性：
    • 空头仓位数据延迟约 2 周（FINRA 报告周期）
    • 内部人交易数据可能比备案延迟 2-3 天
    • VIX 期限结构仅在期货交易时段更新
  • 突发新闻的局限性（v4.0.0）：
    • Google News RSS 可能延迟 15-60 分钟
    • 关键词匹配可能产生误报或漏报
    • 不分析情绪，仅检测关键词
    • 1 小时缓存意味着警报可能略有延迟
  • 数据缺失：并非所有股票都有分析师覆盖、期权链或完整的基本面数据
  • 执行时间：使用异步并行抓取和缓存时，每只股票需 3-5 秒（共享指标缓存 1 小时）
  • 免责声明：所有输出均包含醒目的“非财务建议”警告
  • 仅限美国市场：非美国股票代码的数据可能不完整

错误处理

该脚本会妥善处理：

  • 无效的股票代码 → 显示明确的错误消息
  • 缺少分析师数据 → 仅根据可用指标生成信号
  • API 调用失败 → 使用指数退避策略重试，3 次尝试后失败

评论

支持 Markdown