Levi DeHaan

SSAI - STARS Stock Analyzer

Comprehensive stock analysis app combining real-time financial data, AI-powered insights, and web scraping for deep company and market understanding

Status: in-progress · 2025-10-05

Overview

SSAI (STARS Stock Analyzer) unifies market, fundamentals, news, and filings into an AI-driven research experience with scraping, data fusion, and an interactive UI.

Technologies

React, TypeScript, Vite, Node.js, Express, SQLite, DeepSeek API, FinancialModelingPrep API, Firecrawl, TailwindCSS, Charting

Coverage
2,000+ tickers
AI Insight Depth
High
Data Sources
FMP, Firecrawl, SEC
Modes
Dark/Light

STARS Stock Analyzer (SSAI)

SSAI is a comprehensive stock analysis application that combines real-time financial data, AI-powered analysis, and web scraping to provide deep insights into stock performance.

🚀 Features

Core Functionality

  • Real-time Stock Data: Fetch comprehensive financial data using FinancialModelingPrep API
  • AI-Powered Analysis: Leverages DeepSeek AI for intelligent stock analysis and insights
  • News & Filing Scraping: Uses Firecrawl and custom scrapers to analyze recent news articles and SEC filings
  • Interactive Dashboard: Modern React interface with charts, tables, and detailed views
  • Search History: Persistent search history with local storage
  • Dark/Light Mode: Toggle between themes for better user experience

Data Sources

  • Financial Data: Company profiles, income statements, balance sheets, cash flow, ratios
  • Market Data: Stock prices, historical data, analyst estimates
  • News: Recent news articles with full content scraping
  • SEC Filings: Latest regulatory filings with content analysis
  • AI Analysis: Comprehensive stock evaluation using advanced language models

Architecture Overview

  • Frontend: React + TypeScript + TailwindCSS
  • Backend: Node.js + Express + SQLite for caching/search history
  • AI Integration: DeepSeek API with structured prompts and safety guards
  • Scraping Layer: Firecrawl + custom local scraper with rate limits and dedupe

Custom Local Scraper

The system uses a custom scraper to pull data from news and other sites, collecting statistics from many locations to construct a rich prompt for an advanced AI system. This produces high-quality, actionable insights about the stock and the company.

Example Endpoints (Equivalent)

  • GET /api/stock/:symbol/profile
  • GET /api/stock/:symbol/fundamentals
  • GET /api/stock/:symbol/history
  • GET /api/stock/:symbol/news
  • GET /api/stock/:symbol/filings
  • POST /api/stock/:symbol/analyze

Notes

  • Images are optimized via the image processing pipeline (small/medium/webp/LQIP)
  • All image paths are site-rooted (no /public prefix)