Skip to content

README.md

Latest commit

 

History

History
80 lines (62 loc) · 2.83 KB

README.md

File metadata and controls

80 lines (62 loc) · 2.83 KB
Raw

📞 Screener Concall Tracker

Automated system that tracks upcoming investor concalls from Screener.in, extracts dial-in numbers from PDFs, and syncs everything to Google Sheets + Calendar.

Zero manual work. Runs daily at 7 AM IST.

✨ Features

  • 🔍 Scrapes 100 upcoming concalls from Screener.in
  • 📄 Extracts phone numbers from PDF announcements (92% success rate)
  • 📊 Auto-updates Google Sheet with all concall details
  • 📅 Creates Google Calendar events with reminders
  • 🎨 Color codes calls by watchlist (My Stonks → Tomato, Core Watchlist → Flamingo/Tangerine/Banana)
  • 🔔 My Stonks events auto-sync to main calendar
  • 📧 Email notifications on success/failure
  • ☁️ Runs automatically via GitHub Actions (even if your laptop is off)

📊 Live Data

⚙️ How It Works

Every day at 7 AM IST:
┌─────────────────┐
│  Screener.in    │
└────────┬────────┘
         ▼
┌─────────────────┐
│  Scrape 100     │
│  Concalls       │
└────────┬────────┘
         ▼
┌─────────────────┐
│  Download PDFs  │
│  Extract Phones │
└────────┬────────┘
         ▼
    ┌────┴────┐
    ▼         ▼
┌───────┐ ┌──────────┐
│ Sheet │ │ Calendar │
└───────┘ └──────────┘
         ▼
┌─────────────────┐
│  Email Summary  │
└─────────────────┘

🛠️ Tech Stack

  • Python + Selenium (web scraping)
  • pdfplumber (PDF extraction)
  • Google Sheets API
  • Google Calendar API
  • GitHub Actions (automation)

🔐 Setup (For Forks)

You must provide your own credentials. This repo contains no stored credentials.

  1. Screener.in Account - Create your own account at screener.in
  2. Google Service Account - Create via Google Cloud Console with Sheets, Drive, and Calendar APIs enabled
  3. GitHub Secrets - Add these to your forked repo:
    • SCREENER_USERNAME - Your Screener.in email
    • SCREENER_PASSWORD - Your Screener.in password
    • GOOGLE_CREDENTIALS_BASE64 - Base64-encoded service account JSON
    • EMAIL_USERNAME / EMAIL_PASSWORD - Gmail app password for notifications

🚀 Built With

This entire project was built in 3 hours using Claude Code with zero prior coding experience.

📝 License

MIT

Built by @AnishA_Moonka