name: us-earnings-digest
version: 1.0.0
description: 美股财报每日核心观点（SEC EDGAR + Finnhub + Yahoo 多源 + AI 3 段式观点）
author: wechat-ops-skills
license: MIT
platform: ['us-stock']
tags: ['美股', '财报', 'SEC', '投资', 'AI分析']
category: 量化交易
trigger: ["us-earnings-digest", "财报观点", "美股财报", "/earnings"]
inputs:
ticker:
type: string
required: false
description: 单只股票代码（如 AAPL）
tickers:
type: array
required: false
description: 多只股票列表
date:
type: string
required: false
default: 'today'
report_type:
type: string
required: false
enum: [10-Q, 10-K, 8-K, press_release, all]
default: all
data_source:
type: string
required: false
enum: [auto, sec_edgar, finnhub, yahoo, mock]
default: auto
lookback_days:
type: integer
required: false
default: 1
include_outlook:
type: boolean
required: false
default: true
language:
type: string
required: false
enum: [zh, en]
default: zh
proxy:
type: string
required: false
description: 代理 URL（覆盖 config/env）
finnhub_token:
type: string
required: false
description: Finnhub API token（财报日历）
outputs:
mode:
type: string
sources_used:
type: array
data:
type: object
ai_view:
type: object
description: AI 提炼的 3 段式核心观点
美股财报每日核心观点
适用场景
每天早上 5 分钟，看懂美股财报核心：抓 SEC EDGAR 一手财报 + AI 提炼 3 段式核心观点（核心结论 / 驱动因素 / 前瞻指引）。
- 📄 多源数据：SEC EDGAR（一手 10-Q/10-K/8-K）+ Finnhub（财报日历）+ Yahoo Finance（行情）
- 🌍 跨平台代理：自动读取
WOPS_PROXY/HTTPS_PROXY/ config - 🤖 AI 提炼：3 段式核心观点，标注 BEAT/MISS/IN_LINE
- ⚠️ 外网环境检测：连不上 SEC 时给出明确中文修复提示
- 🎯 降级链：SEC → Finnhub → Yahoo → Mock，永远能跑
触发
/us-earnings-digest
财报观点
美股财报
/earnings
平台
us-stock
标签
美股, 财报, SEC, 投资, AI分析
三种使用模式
1. 单只股票深度模式
skill.run({"ticker": "AAPL"})
# 输出：AAPL 财报原文 + AI 核心观点
2. 财报日历模式
skill.run({"tickers": ["NVDA", "AMD", "TSM"]})
# 输出：3 只股票今日/本周财报日历 + EPS/营收预期
3. 演示模式（无外网）
skill.run({"ticker": "AAPL", "data_source": "mock"})
输入参数
| 参数 | 必填 | 默认 | 说明 |
|---|---|---|---|
| ticker | 否 | — | 单只股票代码 |
| tickers | 否 | — | 多只股票列表 |
| date | 否 | 今日 | YYYY-MM-DD |
| report_type | 否 | all | 10-Q/10-K/8-K/all |
| data_source | 否 | auto | auto/sec_edgar/finnhub/yahoo/mock |
| lookback_days | 否 | 1 | 财报后分析天数 |
| include_outlook | 否 | true | 是否包含管理层指引 |
| language | 否 | zh | zh/en |
| proxy | 否 | — | 代理 URL |
| finnhub_token | 否 | — | Finnhub API token（可选） |
校验：ticker 或 tickers 至少传一个。
输出示例（节选）
{
"mode": "sec_edgar",
"sources_used": ["sec_edgar", "yahoo_finance"],
"data": {
"ticker": "AAPL",
"company_name": "Apple Inc.",
"reports": [
{"type": "10-Q", "filed_at": "2025-08-01", "url": "https://www.sec.gov/Archives/..."}
],
"fundamentals": {"regularMarketPrice": 220.5, "previousClose": 218.3}
},
"ai_view": {
"headline": "iPhone 营收超预期，服务业务创新高",
"verdict": "BEAT",
"confidence": "高",
"key_metrics": {
"营收": "$85.8B vs $84.5B 预期",
"EPS": "$1.40 vs $1.35 预期",
"毛利率": "46.3%（+1.2pp）"
},
"drivers": [
"iPhone 营收同比 +6%，新兴市场表现强劲",
"服务业务营收创历史新高，同比 +14%",
"毛利率提升主因服务业务占比上升"
],
"outlook": [
"管理层指引 Q4 营收同比中个位数增长",
"AI 功能推动换机周期",
"分析师普遍上调目标价"
],
"risks": [
"中国市场需求疲软",
"AI 功能货币化速度低于预期"
],
"market_reaction": {
"盘后股价": "+2.8%",
"市场情绪": "乐观"
},
"one_liner": "硬件稳健 + 服务高增，AI 周期启动在即。"
}
}
数据源说明
| 源 | URL | 提供内容 | 是否需要 key |
|---|---|---|---|
| SEC EDGAR | data.sec.gov | 10-Q/10-K/8-K 原文 | ❌（需 User-Agent 含邮箱） |
| Finnhub | finnhub.io/api | 财报日历 + 新闻 | ✅ 免费层 60 req/min |
| Yahoo Finance | query1.finance.yahoo.com | 行情 | ❌ |
| Mock | — | 演示数据 | ❌ |
降级链：用户传 data_source: auto 时，自动检测外网 → 通则用 SEC，不通则降级 Mock 并提示。
跨平台代理配置
macOS / Linux
export WOPS_PROXY=http://127.0.0.1:7890
export FINNHUB_TOKEN=your_token # 可选
Windows PowerShell
$env:WOPS_PROXY = "http://127.0.0.1:7890"
$env:FINNHUB_TOKEN = "your_token"
Windows CMD
set WOPS_PROXY=http://127.0.0.1:7890
set FINNHUB_TOKEN=your_token
Docker
docker run -e WOPS_PROXY=http://host.docker.internal:7890 \
-e FINNHUB_TOKEN=your_token \
your-image
config.yaml
llm:
provider: deepseek
...
options:
earnings:
proxy: http://127.0.0.1:7890
finnhub_token: your_token
sec_user_agent: "Your Name your@email.com" # SEC 合规要求
运行时
skill.run({"ticker": "AAPL", "proxy": "http://127.0.0.1:7890"})
外网环境检测（自动）
Skill 启动时自动 GET https://www.sec.gov：
- ✅ 可达：使用 SEC EDGAR 一手数据
- ❌ 不可达：自动降级 Mock，并在输出中给出中文修复提示：
⚠️ 抓取提示
- 无法连接 SEC EDGAR（需要外网环境）。
💡 解决方案：
1. 配置代理（推荐 Clash / V2Ray / Shadowsocks）：
macOS / Linux: export WOPS_PROXY=http://127.0.0.1:7890
Windows PowerShell: $env:WOPS_PROXY='http://127.0.0.1:7890'
2. 或在 config.yaml 设置 earnings.proxy
3. 或使用 mock 模式演示：data_source: mock
跟已有 Skill 协同
market-regime-detect（大盘环境判断）
↓
us-earnings-digest（本 Skill：财报聚合 + AI 观点）
↓
trade-tactics（个股战术：财报后股价反应 + 买卖点）
↓
trading-journal-ai（交易复盘：本次决策对错）
详细说明
本 Skill 由 wechat_ops_skills.skills.us_earnings_digest 提供实现。
数据获取层在 wechat_ops_skills.earnings_source。
详见 prompts/digest.md 与 config.example.yaml。
