Skip to content

About

Automated, high-performance scraper for YÖK ATLAS Tercih Kılavuzu API

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

UniAtlas (YÖK ATLAS Scraper & YKS University Analytics Platform)

Build & Deploy

UniAtlas (atlas.bountools.com) is an intelligence platform and web dashboard combining real-time 2026 YÖK ATLAS scraped program data (21,493 programs) with 2019–2024 Kaggle YKS university admissions analytics (128,000+ historical entries & 1,000,000+ subject net stats).


📚 Technical Documentation

Complete documentation is organized in the docs/ directory:


⚡ Quick Start

1. Local Development Setup

Requirements: uv (Python 3.12+) and Node.js 22+.

# Clone the repository
git clone [email protected]:fusuyfusuy/uniyok-atlas.git
cd uniyok-atlas

# Install Python dependencies
uv sync

# Run data scraper (fetches 2,150 pages with size 10)
uv run main.py --concurrency 20

# Construct unified database
uv run python build_unified_db.py

# Install & build frontend
cd dashboard-ui && npm install && npm run build && cd ..

# Run backend API server
uv run uvicorn server:app --host 0.0.0.0 --port 8000

Access the dashboard at http://localhost:8000/.


🐳 Docker Container Build

# Build production Docker image
docker build -t registry.bogazici.app/budok/uniatlas:latest .

# Run container locally
docker run -p 8000:8000 registry.bogazici.app/budok/uniatlas:latest

📄 License & Attribution

  • Scraped Data: YÖK ATLAS Official Guide (yokatlas.yok.gov.tr)
  • Historical Data: Kaggle Turkish University Admissions (ramazanizci/turkish-university-admissions)

About

Automated, high-performance scraper for YÖK ATLAS Tercih Kılavuzu API

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages