Claude Equity Research

1# Claude Equity Research
2 
3[![Built with Claude Code](https://img.shields.io/badge/Built%20with-Claude%20Code-blue?logo=anthropic&logoColor=white)](https://claude.ai/claude-code)
4![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)
5![Claude Code Required](https://img.shields.io/badge/Claude_Code-Required-blue.svg)
6![Status: Active](https://img.shields.io/badge/Status-Active-green.svg)
7 
8>🤖 Built entirely with Claude Code - demonstrating AI-native development workflows for professional-grade financial tools.
9 
10Professional equity research and trading analysis powered by Claude AI, delivering institutional-grade investment insights with Goldman Sachs-style formatting and comprehensive risk assessment.
11 
12## What It Does
13 
14- **Institutional-Grade Analysis**: Generates professional equity research reports matching Wall Street standards
15- **AI-Powered Intelligence**: Leverages Claude AI for comprehensive fundamental and technical analysis
16- **Real-Time Data Integration**: Pulls live market data, earnings reports, and analyst coverage
17- **Risk-Adjusted Recommendations**: Provides buy/sell/hold ratings with specific price targets and position sizing
18- **Advanced Market Intelligence**: Includes options flow analysis, insider trading activity, and sector positioning
19 
20## Key Features
21 
22### Core Analysis Framework
23- **Executive Summary**: Investment thesis with price target and 12-month timeframe
24- **Fundamental Analysis**: Revenue growth, margins, peer comparisons, and forward estimates
25- **Catalyst Analysis**: Near-term and medium-term market drivers with specific dates
26- **Valuation Models**: Bull/base/bear scenarios with probability weighting
27- **Risk Assessment**: Company-specific and macro risks with position sizing guidance (1-5%)
28- **Technical Context**: Support/resistance levels, momentum indicators, and volume analysis
29 
30### Enhanced Intelligence Features
31- **Options Flow Analysis**: Unusual activity, put/call ratios, implied volatility trends
32- **Insider Activity Monitoring**: Executive buying/selling patterns with dollar amounts
33- **Sector Positioning**: Rotation trends and relative strength vs market indices
34- **ESG & Governance**: Sustainability scores and regulatory compliance assessment
35 
36### Professional Standards
37- **Institutional Terminology**: EBITDA, P/E ratios, EV/Sales, conviction levels
38- **Probability Weighting**: Bull/base/bear scenarios with percentage allocations
39- **Legal Protection**: Comprehensive disclaimers for educational use
40- **Data Sourcing**: Real-time web search with analyst firm citations
41 
42## Installation & Setup
43 
44### Prerequisites
45- Claude Code CLI (version 2.0.11 or higher)
46- Claude paid subscription (Pro, Team, or Enterprise)
47- Internet connection for real-time data retrieval
48 
49### Installation via Claude Code Plugin (Recommended)
50 
51**Quick Install - Interactive Menu:**
52```bash
53# Step 1: Add the marketplace
54/plugin marketplace add quant-sentiment-ai/claude-equity-research
55 
56# Step 2: Open the plugin menu
57/plugin
58 
59# Step 3: Select "Browse Plugins" → find "claude-equity-research" → "Install now"
60```
61 
62**Alternative - Direct Install:**
63```bash
64/plugin marketplace add quant-sentiment-ai/claude-equity-research
65/plugin install claude-equity-research@quant-sentiment-ai
66```
67 
68**Verify Installation:**
69```bash
70/help  # Confirm /trading-ideas command is listed
71```
72 
73**Start Analyzing:**
74```bash
75/trading-ideas AAPL
76/trading-ideas NVDA --detailed
77```
78 
79> 💡 **Tip**: Restart Claude Code after installation for best results.
80 
81For comprehensive plugin documentation, see [PLUGIN.md](PLUGIN.md).
82 
83<details>
84<summary><strong>Manual Installation (Advanced)</strong></summary>
85 
86### Quick Start
87 
881. **Install the /trading-ideas command** (system-wide):
89```bash
90mkdir -p ~/.claude/commands
91curl -o ~/.claude/commands/trading-ideas.md https://raw.githubusercontent.com/quant-sentiment-ai/claude-equity-research/main/commands/trading-ideas.md
92```
93 
942. **Basic usage**:
95```bash
96/trading-ideas AAPL
97```
98 
993. **Enhanced analysis**:
100```bash
101/trading-ideas HOOD --detailed
102```
103 
104### Manual Setup via Git Clone
105 
1061. **Clone the repository**:
107```bash
108git clone https://github.com/quant-sentiment-ai/claude-equity-research.git
109cd claude-equity-research
110```
111 
1122. **Copy command to Claude Code**:
113```bash
114cp commands/trading-ideas.md ~/.claude/commands/
115```
116 
117</details>
118 
119## Usage Examples
120 
121### Basic Equity Analysis
122```bash
123/trading-ideas AAPL
124```
125**Output**: Comprehensive institutional research report with BUY/SELL/HOLD recommendation
126 
127### Technology Sector Analysis
128```bash
129/trading-ideas NVDA
130```
131**Features**: AI/semiconductor sector positioning, relative valuation vs peers
132 
133### Financial Services Analysis
134```bash
135/trading-ideas JPM
136```
137**Includes**: Interest rate sensitivity, regulatory environment, book value analysis
138 
139### Growth Stock Analysis
140```bash
141/trading-ideas TSLA
142```
143**Focus**: Growth metrics, competitive positioning, volatility assessment
144 
145## Sample Output Format
146 
147```
148# APPLE INC (AAPL) - ENHANCED EQUITY RESEARCH
149 
150## EXECUTIVE SUMMARY
151BUY with $250 price target (9% upside) over 12 months. Strong Q4 2024 
152results driven by iPhone 16 launch and AI integration provide foundation 
153for premium product cycle. Balanced risk-reward with established ecosystem moat.
154 
155## FUNDAMENTAL ANALYSIS
156Q4 2024: Revenue $94.9B (+6% YoY), EPS $1.64 (+12% YoY). iPhone revenue 
157$46.2B (~49% of total), Services +12% to $25B with recurring characteristics.
158 
159## VALUATION & PRICE TARGETS
160Consensus: $242 (range $200-$280)
161Bull case: $280 | Base case: $250 | Bear case: $200
162Probability weighting: 25%/55%/20%
163 
164## RECOMMENDATION: BUY | Conviction: High | Price Target: $250
165```
166 
167## Command Reference
168 
169| Command | Description | Output |
170|---------|-------------|---------|
171| `/trading-ideas <TICKER>` | Standard institutional analysis | 8-section comprehensive report |
172| `/trading-ideas <TICKER> --detailed` | Enhanced analysis with options flow | Extended technical and insider analysis |
173| `/trading-ideas --help` | Show usage information | Command documentation |
174 
175## Repository Structure
176 
177```
178claude-equity-research/
179├── README.md                     # This file
180├── LICENSE                       # MIT License
181├── commands/
182│   ├── trading-ideas.md          # Main Claude Code command
183│   └── README.md                 # Command documentation
184├── config/
185│   ├── config.example.json       # Template configuration
186│   └── prompts/                  # Analysis prompt templates
187├── examples/
188│   └── sample_reports/           # Example analyses (AAPL, HOOD, etc.)
189├── docs/
190│   ├── methodology.md            # Detailed analysis framework
191│   ├── installation.md           # Setup instructions
192│   └── customization.md          # Customization guide
193├── utils/
194│   ├── data_sources.md           # Data source documentation
195│   └── validation.py             # Analysis validation tools
196└── tests/
197    └── test_command.py           # Command functionality tests
198```
199 
200## Analysis Methodology
201 
202Our research framework combines:
203 
204### Quantitative Analysis
205- **Financial Statements**: Revenue, margins, cash flow analysis
206- **Valuation Models**: Multiple approaches (DCF, comparable company, precedent transaction)
207- **Technical Indicators**: Support/resistance, momentum, relative strength
208- **Options Analytics**: Implied volatility, unusual activity, sentiment indicators
209 
210### Qualitative Assessment
211- **Competitive Positioning**: Market share, competitive advantages, moat analysis
212- **Management Quality**: Track record, capital allocation, strategic vision
213- **Regulatory Environment**: Industry-specific risks, compliance issues
214- **ESG Factors**: Environmental, social, governance considerations
215 
216### Risk Management
217- **Scenario Analysis**: Bull/base/bear cases with probability weighting
218- **Position Sizing**: Risk-adjusted allocation recommendations (1-5% typical)
219- **Stop-Loss Guidance**: Downside protection levels
220- **Correlation Analysis**: Portfolio diversification considerations
221 
222## Data Sources
223 
224- **Financial Data**: SEC filings, earnings reports, company guidance
225- **Market Data**: Real-time pricing, volume, technical indicators
226- **Analyst Coverage**: Wall Street research, price target updates
227- **News & Sentiment**: Financial media, regulatory announcements
228- **Options Data**: Unusual activity, implied volatility, positioning
229- **Insider Activity**: Form 4 filings, executive transactions
230 
231## Professional Disclaimers
232 
233### ⚠️ Important Legal Notice
234 
235This tool is designed for **educational and research purposes only**. All analysis and recommendations are:
236 
237- **Not financial advice** - For informational purposes only
238- **Not personalized** - Does not consider individual circumstances
239- **Historical data based** - Past performance doesn't guarantee future results
240- **Requiring due diligence** - Users must conduct independent research
241- **Risk warning included** - All investments carry risk of loss
242 
243### Risk Warnings
244- Stock prices are volatile and unpredictable
245- AI analysis may contain errors or biases
246- Market conditions change rapidly
247- Regulatory and company-specific risks may not be fully captured
248- Position sizing recommendations are general guidelines only
249 
250### Professional Consultation
251Always consult with qualified financial professionals before making investment decisions. This tool does not replace professional financial advice.
252 
253## Contributing
254 
255We welcome contributions! Please see our [Contributing Guidelines](CONTRIBUTING.md):
256 
257### Development Areas
258- Enhanced data source integration
259- Improved technical analysis algorithms
260- Additional sector-specific metrics
261- ESG scoring improvements
262- Risk model enhancements
263 
264### Code Contributions
265```bash
266# Fork the repository
267git fork https://github.com/quant-sentiment-ai/claude-equity-research
268 
269# Create feature branch
270git checkout -b feature/your-enhancement
271 
272# Submit pull request with detailed description
273```
274 
275## Star History
276 
277[![Star History Chart](https://api.star-history.com/svg?repos=quant-sentiment-ai/claude-equity-research&type=date&legend=top-left)](https://www.star-history.com/#quant-sentiment-ai/claude-equity-research&type=date&legend=top-left)
278 
279## License
280 
281This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
282 
283## Support & Community
284 
285- 📖 [Documentation](docs/)
286- 🐛 [Report Issues](https://github.com/quant-sentiment-ai/claude-equity-research/issues)
287- 💬 [Discussions](https://github.com/quant-sentiment-ai/claude-equity-research/discussions)
288- 🔄 [Changelog](CHANGELOG.md)
289 
290## Acknowledgments
291 
292- Built for [Claude Code](https://claude.ai/code) - Anthropic's official CLI
293- Inspired by institutional equity research standards
294- Community-driven development and feedback
295 
296---
297 
298**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.
299