finance-research-agent

金融研究 Agent

概述

此技能为自主金融研究提供完整框架。它可处理多个资产类别（股票、加密货币、大宗商品、宏观指标）的数据收集、分析和报告生成。Agent 可采用不同模式运行：快速概览、深入分析或持续监控。

主要功能：

• 多源市场数据（实时 + 历史）
• 新闻情绪分析
• 技术指标计算
• Polymarket 持仓跟踪
• 自动生成报告（markdown/PDF）
• 告警/自选列表管理

核心能力

1. 市场数据研究

获取任意股票代码/交易对的当前和历史价格数据。

示例请求：

• “获取 BTC 过去 30 天的价格数据”
• “AAPL 当前的市盈率是多少？”
• “显示 ETH 的 1 小时图表”

用法：

from .scripts.data_fetcher import fetch_historical, fetch_current
data = fetch_historical("AAPL", period="1mo", interval="1d")

支持的数据源：

• Yahoo Finance（股票、ETF、指数）
• CoinGecko（加密货币）
• FRED API（宏观指标）
• Polymarket（预测市场）

2. 新闻与情绪分析

扫描财经新闻并提取情绪/见解。

示例请求：

• “Nvidia 的最新消息是什么？”
• “扫描过去 24 小时内有关美联储政策的新闻”
• “总结围绕 Tesla 的市场情绪”

流程：

1. 查询新闻 API（Google News、RSS 源）
2. 按相关性筛选（股票代码、关键词、日期范围）
3. 提取情绪（正面/负面/中性）
4. 识别关键实体和事件
5. 总结调查结果

**输出：**包含文章、情绪评分和摘要的 JSON。

3. 技术分析

计算指标并识别形态。

包含的指标：

• 移动平均线（SMA、EMA、WMA）
• RSI、MACD、布林带
• 成交量分布
• 支撑位/阻力位
• 蜡烛图形态

示例：

Analyze NVDA technicals:
- RSI(14) = 67.3 (neutral)
- Price above 50-day SMA
- MACD bullish crossover

4. Polymarket 集成

跟踪你的活跃持仓和市场概率。

功能：

• 列出所有活跃持仓
• 查看市场价格与入场价格的对比
• 获取待处理的市场更新（美伊袭击日期等）
• 在概率大幅变动时发出告警

示例： “显示我在 2 月 28 日伊朗袭击市场中的 Polymarket 持仓”

5. 报告生成

以 markdown 或 PDF 格式创建专业研究报告。

报告类型：

• 快速概览（1-2 页）：股票代码的快速概览
• 深入分析（5-10 页）：包含图表的全面分析
• 每日简报：涨幅最大者、新闻摘要、自选列表更新
• 投资组合摘要：所有持仓 + Polymarket 的汇总视图

可用模板：

• assets/templates/report_snapshot.md
• assets/templates/report_deep_dive.md
• assets/templates/daily_briefing.md

自定义： 报告使用 Jinja2 模板。编辑 assets/templates/ 中的模板即可更改格式、添加章节或修改品牌元素。

6. 自选列表与告警

维护股票代码自选列表，并在满足条件时接收告警。

告警触发条件：

• 价格阈值（高于/低于）
• 成交量激增（> 平均值的 2 倍）
• 新闻情绪变化
• RSI 超买/超卖
• Polymarket 概率变化

示例设置：

watchlist:
  - symbol: BTC-USD
    alerts:
      - price_above: 100000
      - rsi_below: 30

工作流示例

快速概览（10 分钟）

用户：“快速分析一下 AMD”

Agent：

1. 获取当前价格和关键指标（市盈率、市值、52 周价格区间）
2. 获取最近 5 篇新闻并分析情绪
3. 计算 RSI(14)
4. 使用模板生成 snapshot_report.md
5. 输出报告和关键结论

深入分析（30-60 分钟）

用户：“全面分析 Tesla，包括竞争格局”

Agent：

1. 获取历史价格数据（1 年），并生成技术图表（移动平均线、RSI、成交量）
2. 获取基本面数据（营收增长、利润率、每股收益趋势）
3. 扫描过去 30 天的新闻并汇总情绪
4. 对比竞争对手（NIO、RIVN、传统汽车制造商）
5. 获取期权流向/机构持股（如有）
6. 生成包含图表的完整报告（matplotlib 图表保存到 assets/charts/）
7. 提供买入/卖出/持有建议及置信度级别

持续监控（定时）

用户：“每天中欧时间上午 8 点运行简报”

Agent：

1. 扫描关注列表中的标的，查看隔夜变化
2. 获取头条财经新闻（Bloomberg、Reuters、CNBC）
3. 检查 Polymarket 持仓的概率更新
4. 总结重要变动
5. 通过 Telegram 发送简报
6. 将完整报告保存到 memory/daily_briefings/YYYY-MM-DD.md

配置

在工作区中创建 config.yaml 以设置默认值：

data_sources:
  stocks: yahoo
  crypto: coingecko
  news: google_rss
  macro: fred

polymarket:
  enabled: true
  positions_file: memory/polymarket_positions.md

reports:
  output_dir: memory/reports/
  default_format: markdown
  include_charts: true

alerts:
  telegram_enabled: true
  check_interval_minutes: 60

脚本参考

脚本	用途	用法
scripts/finance_api.py	核心 API 模块	from finance_api import fetch_historical, calculate_rsi, generate_snapshot_report
scripts/demo.py	命令行演示	python scripts/demo.py snapshot AAPL

详细文档请参阅 references/data_sources.md 和 references/technical_indicators.md。

参考资料

• 数据源： references/data_sources.md — API 端点、速率限制、设置
• 指标： references/technical_indicators.md — 公式和解读
• 报告模板： assets/templates/ — Jinja2 模板和示例
• Polymarket 架构： references/polymarket_schema.md — 市场数据结构

与 OpenClaw 集成

此技能可集成以下工具：

• NewsClawd： 共享新闻源（避免重复）
• Clawd:Mail： 自动发送电子邮件报告
• Telegram： 通过消息工具发送提醒和简报
• Cron： 安排每日/每周运行

示例

示例 1：生成加密货币报告

Create a research report on Ethereum including:
- Last 90 days price action
- Dominance vs Bitcoin
- Recent ecosystem news (L2s, DeFi)
- Technical outlook (RSI, MACD, volume)

示例 2：监控关注列表

Check my watchlist (AAPL, NVDA, BTC) and alert if:
- Any price moved >5% in 24h
- RSI goes below 30 or above 70
- Major news breaks

示例 3：Polymarket 持仓审查

List all my Polymarket positions on US-Iran markets
Calculate current profit/loss
Alert if any market probability shifted >20% overnight

不包含的内容（范围之外）

• 自动交易/订单执行（仅限研究）
• 财务建议（需要免责声明）
• 投资组合优化（单独的技能）
• 税务报告
• ESG/可持续发展指标

更新日志

v0.1.0（2026-02-15）

• 首次发布
• 核心数据获取、新闻扫描、技术分析
• Polymarket 集成
• 使用模板生成报告