# stockpickr - AI Stock Analysis Tool

> AI-powered stock analysis platform providing real-time market data, DCF valuations, and expert investment recommendations.

## Overview

stockpickr is a web-based stock analysis tool that leverages AI to provide comprehensive stock insights, helping users make smarter investment decisions.

## Key Features

- **AI-Powered Analysis**: Real-time stock analysis using multiple AI models (Gemini, Claude, DeepSeek, Grok)
- **DCF Valuation**: Discounted Cash Flow calculations for intrinsic value assessment
- **Expert Recommendations**: Buy/Sell/Hold recommendations with confidence levels
- **Market Data**: Real-time market data, key metrics, and financial insights
- **TradingView Integration**: Live stock charts and technical analysis
- **News & Sentiment**: Latest news aggregation and sentiment analysis
- **Premium Subscription**: Unlimited analyses, faster results, and priority support

## Tech Stack

- **Frontend**: Vanilla JavaScript, HTML5, CSS3
- **Backend**: Node.js, Express
- **Hosting**: Firebase Hosting + Cloud Functions
- **AI APIs**: Google Gemini, Anthropic Claude, OpenRouter
- **Database**: Firebase Firestore
- **Authentication**: Firebase Auth (Google OAuth, Email/Password)
- **Payments**: Stripe (subscriptions)

## Free vs Premium

### Free Tier
- 3 stock analyses per 24 hours
- 30-second delay on results
- Basic features

### Premium ($2.50/month or $19.99/year)
- Unlimited stock analyses
- Instant results (no delays)
- Priority support
- Advanced features

## API Endpoints

The backend server provides secure API endpoints:

- `POST /api/gemini` - Google Gemini AI analysis
- `POST /api/claude` - Anthropic Claude AI analysis
- `POST /api/openrouter` - OpenRouter AI models (DeepSeek, Grok)
- `POST /createCheckoutSession` - Stripe checkout for subscriptions
- `POST /stripeWebhook` - Stripe webhook for payment events
- `POST /createPortalSession` - Stripe customer portal
- `POST /cancelSubscription` - Cancel user subscription

## File Structure

```
/
├── public/               # Production files (deployed to Firebase)
│   ├── index.html       # Main HTML file
│   ├── rendering.js     # Stock analysis rendering logic
│   ├── api.js           # API client for backend calls
│   ├── sidebar.min.css  # Minified sidebar styles
│   ├── stockpicker.min.css # Minified stockpicker styles
│   ├── firebase-config.js # Firebase configuration
│   ├── robots.txt       # Search engine directives
│   └── sitemap.xml      # XML sitemap
├── functions/           # Firebase Cloud Functions
│   └── index.js         # Serverless API endpoints
├── server.js            # Local development server
├── firebase.json        # Firebase hosting configuration
└── package.json         # Node.js dependencies
```

## Usage Limits

**Free Users:**
- 3 analyses per 24-hour period
- Counter resets 24 hours after first analysis
- Stored in localStorage: `freeAnalysisCount`, `freeAnalysisFirstTime`

**Caching:**
- 24-hour cache for stock analyses
- Stored in localStorage and Firestore
- Reduces API costs and improves performance

## SEO & Metadata

The site includes comprehensive SEO optimization:
- Meta descriptions with relevant keywords
- Open Graph tags for social media
- Twitter Card tags
- Google Site Verification
- robots.txt and sitemap.xml
- Minified CSS for performance

## Contact & Support

- Website: https://stockpickr.app
- Support: Available through Premium subscription

---

*This file follows the llms.txt convention for LLM-friendly documentation.*