MIT License

技术解读

以下内容由 GitRead 中文社区 编辑团队基于项目 README 与官方资料整理, 结合中文开发者的常见使用场景补充技术选型建议。具体以项目官方文档为准。

Claude Equity Research:把券商研究所塞进 Claude Code 里的一次尝试

项目背景与痛点

股票研究这件事,长期以来是一个“人力密集 + 信息不对称”的行业。卖方分析师写一份深度报告要花两周,买方研究员每天要跟十几份财报、几十条新闻和一堆技术指标缠斗。与此同时,个人投资者手里的工具要么是纯数据终端(Bloomberg、Wind,昂贵且不产生结论),要么是纯 LLM 聊天框(能聊,但缺乏结构化数据支撑,结论可信度堪忧)。

claude-equity-research 切中的正是这个断层:它不是一个“炒股 AI”,而是一个把机构级研究流程产品化的 Claude Code 插件。核心价值在于把“数据抓取 → 因子计算 → 风险评估 → 结论输出”这条链条固化成可复用的技能(Skill)与命令,让 LLM 不再是拍脑袋的嘴炮,而是流水线下游的推理引擎。

核心技术揭秘

从架构上看,这个项目走的是典型的 “插件即编排层,LLM 即推理层” 路线。Claude Code 的插件机制负责命令注册与上下文注入,真正的重活落在数据管道与因子计算上。可以合理推断其数据流大致如下:

graph TD A[用户指令 /equity-report] --> B[命令路由与参数解析] B --> C{"标的类型判定"} C -->|"美股/港股"| D[行情与财报抓取] C -->|"A股"| E[本地数据源适配] D --> F[基本面因子计算] D --> G[技术指标计算] E --> F E --> G F --> H[估值与质量打分] G --> I[趋势与动量打分] H --> J[风险敞口模块] I --> J J --> K[Claude 综合推理层] K --> L{"置信度门槛"} L -->|"达标"| M[生成评级与目标价] L -->|"不达标"| N[输出观察名单] M --> O[结构化研报输出] N --> O

这个设计里最值得玩味的有三点:

第一,确定性计算与概率性推理的隔离。 技术指标(MA、RSI、MACD)和财务比率(ROE、PEG、自由现金流折现)必须由代码算,不能交给 LLM“心算”。项目把这类计算下沉到工具层,LLM 只负责解释与权衡。这一刀切得非常关键,否则一个 0.1% 的误差会被放大成“市盈率算错了”的灾难级事故。

第二,风险模块独立于信号模块。 很多同类工具把风险当成结论的附注,而这里风险敞口是先于结论计算的独立节点,直接参与最终置信度判定。这符合机构研究的真实逻辑:风险预算决定仓位,仓位决定要不要买,而不是反过来。

第三,置信度门槛(Confidence Gate)。 这是最有工程味的一笔。数据缺口、财报滞后、流动性不足都会触发“不给结论,只给观察名单”。宁可空仓,不可乱推——这个负向设计比任何花哨的因子都更能体现成熟度。

功能亮点与差异

相比市面上那一票“接个 yfinance 就敢叫 AI 投研”的项目,它的差异点集中在:

  • 结论有结构:输出的是可被机器和人类同时消费的研报模板(评级、目标价、催化剂、风险点),而非一段散文;
  • 流程可审计:每个数字都能追溯到哪里来的数据、套的什么公式,这对合规场景是刚需;
  • 插件化分发:/plugin marketplace add 一行命令接入,把“部署一个投研系统”的成本压到了接近零。

短板也很明显:数据源依赖外部 API,财报口径对齐(尤其跨市场)大概率是薄弱环节,A 股适配更像是“能跑”而非“跑得好”。

应用场景与落地建议

适合的场景非常明确:个人投资者的自选股初筛、投研团队的快速预研、金融科技产品里的“研究助理”模块。

生产环境落地要注意三点:其一,务必确认数据源授权与延迟,别用滞后三个月的财报算“当前估值”;其二,把插件输出当成假设生成器而非决策依据,人工复核财务异常项;其三,项目明确声明“仅供教育用途,不构成投资建议”,在任何商业集成中都要保留这一免责链条,合规不是可选项。

综合评价

优点:架构分层清晰,确定性计算与 LLM 推理边界划分得当,风险前置和置信度门槛体现出真实的行业理解,插件形态的接入成本极低。

缺点:数据质量受制于第三方 API,跨市场财务口径统一是硬伤,因子模型未公开可调,深度上更接近“优秀的研究脚手架”而非“完整的量化平台”。

一句话总结:它没有试图替代分析师,而是把分析师最枯燥的那 70% 流程自动化了——这个定位,恰恰是 LLM 应用最该有的样子。

关于

GitHub 原始描述(英文)

🔌 Claude Code Plugin for institutional-grade equity research. Install with /plugin marketplace add. Generates professional buy/sell recommendations with comprehensive fundamental analysis, technical indicators, and risk assessment. Educational use only - not financial advice.

描述取自 GitHub 官方 API,保持仓库作者书写的原文。

语言占比

Python

README

Claude Equity Research

by carolinacherry

Author: carolinacherry Built with Claude Code License: MIT Claude Code Required Status: Active

🤖 Built entirely with Claude Code - demonstrating AI-native development workflows for professional-grade financial tools.

Professional equity research and trading analysis powered by Claude AI, delivering institutional-grade investment insights with Goldman Sachs-style formatting and comprehensive risk assessment.

What It Does

  • Institutional-Grade Analysis: Generates professional equity research reports matching Wall Street standards
  • AI-Powered Intelligence: Leverages Claude AI for comprehensive fundamental and technical analysis
  • Real-Time Data Integration: Pulls live market data, earnings reports, and analyst coverage
  • Risk-Adjusted Recommendations: Provides buy/sell/hold ratings with specific price targets and position sizing
  • Advanced Market Intelligence: Includes options flow analysis, insider trading activity, and sector positioning

Key Features

Core Analysis Framework

  • Executive Summary: Investment thesis with price target and 12-month timeframe
  • Fundamental Analysis: Revenue growth, margins, peer comparisons, and forward estimates
  • Catalyst Analysis: Near-term and medium-term market drivers with specific dates
  • Valuation Models: Bull/base/bear scenarios with probability weighting
  • Risk Assessment: Company-specific and macro risks with position sizing guidance (1-5%)
  • Technical Context: Support/resistance levels, momentum indicators, and volume analysis

Enhanced Intelligence Features

  • Options Flow Analysis: Unusual activity, put/call ratios, implied volatility trends
  • Insider Activity Monitoring: Executive buying/selling patterns with dollar amounts
  • Sector Positioning: Rotation trends and relative strength vs market indices
  • ESG & Governance: Sustainability scores and regulatory compliance assessment

Professional Standards

  • Institutional Terminology: EBITDA, P/E ratios, EV/Sales, conviction levels
  • Probability Weighting: Bull/base/bear scenarios with percentage allocations
  • Legal Protection: Comprehensive disclaimers for educational use
  • Data Sourcing: Real-time web search with analyst firm citations

Installation & Setup

Prerequisites

  • Claude Code CLI (version 2.0.11 or higher)
  • Claude paid subscription (Pro, Team, or Enterprise)
  • Internet connection for real-time data retrieval

Quick Install - Interactive Menu:

# Step 1: Add the marketplace
/plugin marketplace add quant-sentiment-ai/claude-equity-research

# Step 2: Open the plugin menu
/plugin

# Step 3: Select "Browse Plugins" → find "claude-equity-research" → "Install now"

Alternative - Direct Install:

/plugin marketplace add quant-sentiment-ai/claude-equity-research
/plugin install trading-ideas@claude-equity-research-marketplace

Verify Installation:

/help  # Confirm /trading-ideas:research command is listed

Start Analyzing:

/trading-ideas:research AAPL
/trading-ideas:research NVDA --detailed

Claude Code namespaces plugin commands as <plugin-name>:<command-name>, so the invocation is /trading-ideas:research (not the bare /trading-ideas). If you prefer the bare form, use the manual install below — it copies the command file into your personal ~/.claude/commands/ and registers it as /trading-ideas.

💡 Tip: Restart Claude Code after installation for best results.

For comprehensive plugin documentation, see PLUGIN.md.

Manual Installation (Advanced)

Quick Start

  1. Install the /trading-ideas command (system-wide):
mkdir -p ~/.claude/commands
curl -o ~/.claude/commands/trading-ideas.md https://raw.githubusercontent.com/quant-sentiment-ai/claude-equity-research/main/commands/trading-ideas/commands/research.md
  1. Basic usage:
/trading-ideas AAPL
  1. Enhanced analysis:
/trading-ideas HOOD --detailed

Manual Setup via Git Clone

  1. Clone the repository:
git clone https://github.com/quant-sentiment-ai/claude-equity-research.git
cd claude-equity-research
  1. Copy command to Claude Code:
cp commands/trading-ideas/commands/research.md ~/.claude/commands/trading-ideas.md

Usage Examples

Examples below use the plugin install invocation (/trading-ideas:research). If you followed the manual install path, drop the :research suffix and use the bare /trading-ideas form.

Basic Equity Analysis

/trading-ideas:research AAPL

Output: Comprehensive institutional research report with BUY/SELL/HOLD recommendation

Technology Sector Analysis

/trading-ideas:research NVDA

Features: AI/semiconductor sector positioning, relative valuation vs peers

Financial Services Analysis

/trading-ideas:research JPM

Includes: Interest rate sensitivity, regulatory environment, book value analysis

Growth Stock Analysis

/trading-ideas:research TSLA

Focus: Growth metrics, competitive positioning, volatility assessment

Sample Output Format

# APPLE INC (AAPL) - ENHANCED EQUITY RESEARCH

## EXECUTIVE SUMMARY
BUY with $250 price target (9% upside) over 12 months. Strong Q4 2024 
results driven by iPhone 16 launch and AI integration provide foundation 
for premium product cycle. Balanced risk-reward with established ecosystem moat.

## FUNDAMENTAL ANALYSIS
Q4 2024: Revenue $94.9B (+6% YoY), EPS $1.64 (+12% YoY). iPhone revenue 
$46.2B (~49% of total), Services +12% to $25B with recurring characteristics.

## VALUATION & PRICE TARGETS
Consensus: $242 (range $200-$280)
Bull case: $280 | Base case: $250 | Bear case: $200
Probability weighting: 25%/55%/20%

## RECOMMENDATION: BUY | Conviction: High | Price Target: $250

Command Reference

Command Description Output
/trading-ideas:research <TICKER> Standard institutional analysis 8-section comprehensive report
/trading-ideas:research <TICKER> --detailed Enhanced analysis with options flow Extended technical and insider analysis
/trading-ideas:research --help Show usage information Command documentation

Repository Structure

claude-equity-research/
├── README.md                     # This file
├── LICENSE                       # MIT License
├── commands/
│   ├── trading-ideas/            # Plugin directory (installed via marketplace)
│   │   ├── .claude-plugin/
│   │   │   └── plugin.json       # Plugin manifest
│   │   └── commands/
│   │       └── research.md       # Slash command (invoked as /trading-ideas:research)
│   └── README.md                 # Command documentation
├── config/
│   ├── config.example.json       # Template configuration
│   └── prompts/                  # Analysis prompt templates
├── examples/
│   └── sample_reports/           # Example analyses (AAPL, HOOD, etc.)
├── docs/
│   ├── methodology.md            # Detailed analysis framework
│   ├── installation.md           # Setup instructions
│   └── customization.md          # Customization guide
├── utils/
│   ├── data_sources.md           # Data source documentation
│   └── validation.py             # Analysis validation tools
└── tests/
    └── test_command.py           # Command functionality tests

Analysis Methodology

Our research framework combines:

Quantitative Analysis

  • Financial Statements: Revenue, margins, cash flow analysis
  • Valuation Models: Multiple approaches (DCF, comparable company, precedent transaction)
  • Technical Indicators: Support/resistance, momentum, relative strength
  • Options Analytics: Implied volatility, unusual activity, sentiment indicators

Qualitative Assessment

  • Competitive Positioning: Market share, competitive advantages, moat analysis
  • Management Quality: Track record, capital allocation, strategic vision
  • Regulatory Environment: Industry-specific risks, compliance issues
  • ESG Factors: Environmental, social, governance considerations

Risk Management

  • Scenario Analysis: Bull/base/bear cases with probability weighting
  • Position Sizing: Risk-adjusted allocation recommendations (1-5% typical)
  • Stop-Loss Guidance: Downside protection levels
  • Correlation Analysis: Portfolio diversification considerations

Data Sources

  • Financial Data: SEC filings, earnings reports, company guidance
  • Market Data: Real-time pricing, volume, technical indicators
  • Analyst Coverage: Wall Street research, price target updates
  • News & Sentiment: Financial media, regulatory announcements
  • Options Data: Unusual activity, implied volatility, positioning
  • Insider Activity: Form 4 filings, executive transactions

Professional Disclaimers

This tool is designed for educational and research purposes only. All analysis and recommendations are:

  • Not financial advice - For informational purposes only
  • Not personalized - Does not consider individual circumstances
  • Historical data based - Past performance doesn’t guarantee future results
  • Requiring due diligence - Users must conduct independent research
  • Risk warning included - All investments carry risk of loss

Risk Warnings

  • Stock prices are volatile and unpredictable
  • AI analysis may contain errors or biases
  • Market conditions change rapidly
  • Regulatory and company-specific risks may not be fully captured
  • Position sizing recommendations are general guidelines only

Professional Consultation

Always consult with qualified financial professionals before making investment decisions. This tool does not replace professional financial advice.

Contributing

We welcome contributions! Please see our Contributing Guidelines:

Development Areas

  • Enhanced data source integration
  • Improved technical analysis algorithms
  • Additional sector-specific metrics
  • ESG scoring improvements
  • Risk model enhancements

Code Contributions

# Fork the repository
git fork https://github.com/quant-sentiment-ai/claude-equity-research

# Create feature branch
git checkout -b feature/your-enhancement

# Submit pull request with detailed description

Star History

Star History Chart

Generated from this repo’s own stargazer data — GitHub restricted the public stargazer API on 2026-06-30, which broke third-party star-history charts everywhere. Refresh with python3 scripts/update-star-history.py.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Support & Community

Author

Created and maintained by carolinacherry.

Acknowledgments

  • Built for Claude Code - Anthropic’s official CLI
  • Inspired by institutional equity research standards
  • Community-driven development and feedback

Remember: This tool provides educational insights only. Always conduct your own due diligence and consult qualified financial professionals before making investment decisions. Past performance does not guarantee future results.

评论

暂无评论