naman8485/stock_scans

StockPulse India ⚡

Live NSE & BSE Corporate Announcements, Concalls, Transcripts & YouTube Feeds Terminal

A modern, real-time financial intelligence terminal designed for Indian equity markets (NSE & BSE). Aggregates official corporate filings, earnings call transcripts with AI sentiment analysis (Positive vs Negative highlights), and live YouTube conference call video uploads with direct in-app playback.

---

🌟 Key Features

1. 📢 Live Corporate Announcements (NSE & BSE)

• Real-Time Stream: Live corporate filings directly from NSE India (https://www.nseindia.com/) and BSE India (https://www.bseindia.com/).
• Smart Categorization: Automatically categorizes filings into:
  • Financial Results (Audited / Unaudited Q2/Q3/Q4 results)
  • Concalls & Transcripts (Investor presentation, concall schedule, audio links)
  • Dividends (Interim, special, final dividends)
  • Board Meetings & Outcomes
  • Corporate Actions (Bonus issues, stock splits, buybacks, rights)
  • Orders, Contracts & Acquisitions
• Direct PDF Viewer & Download: 1-click in-terminal document preview and direct download links to official exchange archives.

2. 📞 Conference Calls & Transcripts (Trendlyne & Exchanges)

• Integrates live feeds from Trendlyne Conference Calls and official exchange filings.
• Displays:
  • Stock Ticker & Company Name
  • Current Market Price (CMP) & Intraday % Change
  • Durability, Valuation & Momentum Scores (Color-coded)
  • Direct Links to Audio Recordings, Transcripts, and Investor Presentations.

3. 🎯 Full Earnings Transcript Analyzer (Positive vs Negative Points)

• On-Demand Intelligence: Click "Analyze Pos / Neg" on any announcement or paste any filing PDF URL / transcript text.
• Categorized Breakdown:
  • Positive Drivers & Growth Highlights (Revenue growth, margin expansion, order book records, new store/capacity rollouts, debt reduction).
  • Negative Headwinds, Margin Pressures & Risks (Cost inflation, margin contraction, freight spikes, working capital stretch, volume slowdowns).
  • Overall Sentiment Meter: Quantified Bullish / Neutral / Bearish ratio (0% – 100%).
  • Key Management Quotes: Isolates strategic guidance and direct CEO/CFO statements.
  • Quantitative Metrics: Automatically extracts numbers, percentages, and crore figures mentioned in the call.

4. 🎥 Live YouTube Concall Hub (Direct Playback & Embeds)

• Real-time video stream from premier earnings concall channels:
  • (3322) Concall - YouTube (@concall_in)
  • ConCall.Inc5 - YouTube (@ConCall.Inc5)
• Direct In-App Playback: Responsive zero-delay embedded player modal (watch directly without navigating away from the terminal).
• Filter by channel, search by ticker or quarter (e.g., Q2 FY27).

5. ⚡ Advanced Terminal Experience

• Auto-Refresh: Configurable live updates (every 30s, 60s, 2m, or manual).
• Sound Alerts: Audio chime upon receiving new live market announcements.
• Unified Global Search: Instant filter across tickers, company names, quarters, and filing topics.

---

🛠️ Architecture & Tech Stack

• Backend: FastAPI (Python 3.12) with async caching and background scraping engines.
• Scrapers & Parsers:
  • nse_scraper.py: NSE India corporate announcements API with session and cookie management.
  • trendlyne_scraper.py: Trendlyne corporate news and earnings call data.
  • youtube_scraper.py: Real-time YouTube XML feeds (100% free, no API keys required).
  • transcript_analyzer.py: PDF text extractor (pypdf) with NLP pattern matching for financial sentiment and operational drivers.
• Frontend: Clean single-page application built with Tailwind CSS, Lucide Icons, and Web Audio API.

---

🚀 How to Run

Method 1: Double-Click (Windows)

Double-click run.bat in this folder. It will start the server and automatically open the application in your default browser.

Method 2: Command Line

# Activate virtual environment
.venv\Scripts\activate

# Start the application
python run.py

Open http://127.0.0.1:8000 in your browser.

---

📂 Project Directory Structure

Stock Scans/
├── .venv/                      # Python virtual environment (Python 3.12)
├── run.bat                     # 1-click Windows launcher
├── run.py                      # Application bootstrap & browser launcher
├── requirements.txt            # Python dependencies
├── README.md                   # Complete documentation
└── app/
    ├── __init__.py
    ├── main.py                 # FastAPI backend & REST endpoints
    ├── scrapers/
    │   ├── __init__.py
    │   ├── nse_scraper.py      # NSE India corporate announcements scraper
    │   ├── trendlyne_scraper.py# Trendlyne concalls, audio & filing scraper
    │   ├── youtube_scraper.py  # YouTube XML RSS parser for @concall_in & @ConCall.Inc5
    │   └── transcript_analyzer.py # Positive/Negative transcript sentiment engine
    └── static/
        ├── index.html          # Responsive Dark Financial Terminal UI
        ├── app.js              # Live updates, video player modal, sentiment UI
        └── styles.css          # Terminal styling & glassmorphism