name: stock-deep-analysis
description: 美股/港股/A股深度财务分析报告生成工具。输入股票代码，自动从 Yahoo Finance（Tushare for A股）拉取财务报表、估值、行情数据，生成结构化 Markdown 分析报告。支持 PDD/KC/任意 ticker。
version: 1.0.0
tags:

• finance
• stock-analysis
• yfinance
• investment

dependency:
python:

• yfinance>=0.2.40

environment:
TUSHARE_TOKEN: A股专用（Tushare token），美股不需要
triggers:

• 分析股票
• 深度报告
• 股票分析
• PDD分析
• KC分析
• 持仓分析
• 美股分析
• 港股分析

Stock Deep Analysis（股票深度分析）

功能概述

输入股票代码，自动从 Yahoo Finance 拉取数据，生成结构化 Markdown 深度分析报告：

1. 公司概况 — 业务简介、行业、主营业务
2. 估值分析 — PE/PB/PS、52周高低、分析师目标价、EV/EBITDA
3. 盈利能力 — 营收/毛利/净利/ EPS 历史走势
4. 资产负债 — 资产质量、债务结构、流动比率
5. 成长能力 — 营收增速、利润增速、季度环比
6. 现金流 — FCF、经营现金流、资本支出
7. 持仓状态 — 用户成本、盈亏、距52周高低距离
8. 综合结论 — 多空逻辑 + 操作建议

前置准备

依赖安装

# 建议用 hermes-agent venv
cd ~/.hermes/hermes-agent/venv
uv pip install yfinance>=0.2.40 --python ./bin/python3

# 验证
~/.hermes/hermes-agent/venv/bin/python3 -c "import yfinance; print('OK:', yfinance.__version__)"

A 股额外依赖（Tushare）

cd ~/.hermes/hermes-agent/venv
uv pip install tushare>=1.2.80 --python ./bin/python3

使用方法

方式一：命令行直接生成（推荐）

PYTHON=~/.hermes/hermes-agent/venv/bin/python3

# 美股（Yahoo Finance）
$PYTHON ~/.hermes/skills/stock-deep-analysis/scripts/generate_report.py \
  --ticker PDD --market US

# 港股（Yahoo Finance， ticker 需加 .HK）
$PYTHON ~/.hermes/skills/stock-deep-analysis/scripts/generate_report.py \
  --ticker 0700.HK --market HK

# A股（Tushare，需配置 token）
export TUSHARE_TOKEN="your_token"
$PYTHON ~/.hermes/skills/stock-deep-analysis/scripts/generate_report.py \
  --ticker 600141.SH --market CN

方式二：传入持仓成本（计算盈亏）

PYTHON=~/.hermes/hermes-agent/venv/bin/python3

$PYTHON ~/.hermes/skills/stock-deep-analysis/scripts/generate_report.py \
  --ticker PDD --market US --cost 100.0

方式三：Python 调用

import sys
sys.path.insert(0, '~/.hermes/skills/stock-deep-analysis/scripts')
from generate_report import generate_stock_report

report = generate_stock_report(
    ticker='PDD',
    market='US',       # 'US' | 'HK' | 'CN'
    cost=None,         # 持仓成本（美元/港币/人民币，按市场货币单位）
    currency='USD'     # 'USD' | 'HKD' | 'CNY'（用于成本换算显示）
)
print(report)

支持的市场

| market | 数据源 | 示例 ticker |
|--------|--------|-----------|
| US | Yahoo Finance | PDD, AAPL, TSLA, KC |
| HK | Yahoo Finance | 0700.HK, 9988.HK, 1810.HK |
| CN | Tushare | 600141.SH, 000001.SZ |

持仓成本说明

• cost 参数按 --market 对应的货币单位填写
• 美股：美元；港股：港币；A股：人民币
• 不传 cost 则只输出分析报告，不计算盈亏

输出示例

# PDD Holdings（拼多多）深度分析报告

**报告日期：** 2026-05-29 | **当前价：** $82.02 | **成本价：** $100（-18%）

---

## 一、公司基本情况
## 二、估值分析
## 三、财务业绩（Annual）
## 四、资产负债质量
## 五、自由现金流
## 六、持仓状态
## 七、综合结论

已知问题（Pitfalls）

1. Yahoo Finance 限流：高频请求会触发 429 Too Many Requests，脚本内置 3 次重试 + 2 秒等待
2. 美股财报货币单位：yfinance 返回的 EPS/利润数据已是美元单位，无需额外换算
3. 港股 ticker 格式：必须在 ticker 后加 .HK，如 0700.HK
4. A股需配置 Tushare Token：免费账号 fina_indicator 接口限制 1次/分钟，需等待 65 秒以上
5. 信息过老：美股财报披露后 Yahoo Finance 更新可能延迟 1-2 天

文件结构

stock-deep-analysis/
├── SKILL.md                        ← 主技能说明
├── scripts/
│   ├── generate_report.py          ← 主脚本（调用 fetch + 生成报告）
│   └── fetch_stock_data.py         ← 数据拉取模块（yfinance/Tushare）
└── references/
    └── indicators-guide.md         ← 财务指标评价标准参考