Fantasy Football Draft Automation System

Portfolio project

T.S.C.C.A.R.K.S. - Tactical Sleeper Cell Clandestine Automated Ranking Kinetic System

"When regular drafting isn't enough... deploy The SLEEPER CARKS"

📌 Important Note

The most critical file in this repository is data/player-mappings.json - this contains the Sleeper-specific player IDs needed for the automation to work. You'll need to:

Add your own CSV ranking files to the data/ directory

Reference the output/ directory for example scripts used in previous drafts

🎯 Mission Briefing

Welcome to Operation: SLEEPER CARKS - a highly classified fantasy football draft automation system designed for maximum tactical advantage in Sleeper leagues. This advanced kinetic system leverages cutting-edge algorithms and clandestine data analysis to execute precision draft strikes with surgical accuracy.

🚁 Operational Status

Current Version: v1.0 "Operation Nightfall" Threat Level: MODERATE Readiness: DEFCON 3

📡 System Capabilities

Automated Reconnaissance: Real-time player value scanning (365+ targets tracked)

Tactical Draft Execution: Precision-guided draft selections with bulk queue management

Stealth Mode Operations: Silent automation via GraphQL infiltration

Multi-Theatre Support: Simultaneous amateur, best ball, and premier league operations

Adaptive Strategy Matrix: CSV-based ranking system for dynamic adjustment

Intelligence Validation: Pre-mission player verification protocols

Rapid Deployment: Bash script execution for immediate tactical advantage

🎖️ Installation Protocol

Prerequisites

Node.js 16+ (Communications Array)

Bash terminal (Command Interface)

Active Sleeper account (Security Clearance Required)

Web browser (Intelligence Gathering Tool)

⚔️ Deployment Sequence

Secure the Operational Base

git clone https://github.com/yourusername/sleeper-carks.git
cd sleeper-carks

Install Tactical Dependencies

npm install  # Arming the system...

Configure Mission Parameters

cp config.example.json config.json
# [CLASSIFIED] Edit config.json with your authentication credentials

Load Target Intelligence

Deploy CSV rankings to the data/ directory

Primary intelligence format: Player names in column A

Generate Strike Protocols

npm run generate-queues  # Compiling tactical scripts...

Execute Operation CARKS

./output/amateur-queue.sh    # Phase 1: Amateur infiltration
./output/bestball-queue.sh   # Phase 2: Best ball penetration
./output/premier-queue.sh    # Phase 3: Premier league domination

📊 CSV Format

Place your player rankings in CSV files within the data/ directory:

Player,Position,Team,Ranking
CeeDee Lamb,WR,DAL,1
Tyreek Hill,WR,MIA,2
Christian McCaffrey,RB,SF,3

Note: Only the first column (player name) is required. Additional columns are optional but help with player matching.

⚙️ Configuration

Edit config.json with your specific values:

{
  "amateur": {
    "draftId": "1249779323884273664"
  },
  "bestball": {
    "draftId": "1249779139896954880"
  },
  "premier": {
    "draftId": "1249778638644064256"
  },
  "authToken": "eyJhbGciOiJIUzI1NiIs...",
  "cookieSession": "eyJhbGciOiJIUzI1NiJ9..."
}

Getting Your Draft IDs

Navigate to your draft room: https://sleeper.com/draft/nfl/[DRAFT_ID]

Copy the ID from the URL

Getting Auth Tokens

See detailed setup guide for step-by-step instructions on obtaining auth tokens.

📁 Project Structure

sleeper-draft-automation/
├── data/                    # CSV rankings and player mappings
│   ├── amateur-rankings.csv
│   ├── bestball-rankings.csv
│   ├── premier-rankings.csv
│   └── player-mappings.json
├── scripts/                 # Node.js scripts
│   ├── generate-queue-script.js
│   ├── validate-players.js
│   └── fetch-all-players.js
├── output/                  # Generated bash scripts
│   ├── amateur-queue.sh
│   ├── bestball-queue.sh
│   └── premier-queue.sh
└── docs/                    # Documentation
    └── SETUP.md

🛠️ Command & Control Interface

# Primary Operations
npm run generate-queues   # Compile tactical strike protocols
npm run validate          # Verify target acquisition 
npm run fetch-players     # Update intelligence database
npm run generate-all      # Full deployment sequence

# Tactical Aliases
npm run deploy           # Alias for generate-queues
npm run recon            # Alias for validate
npm run intel-update     # Alias for fetch-players

🔍 Validation

Before generating scripts, validate that all players in your CSV files can be mapped:

npm run validate

This will show:

How many players were found/not found

List of missing players

Duplicate player matches

🔄 Updating Player Mappings

If players are missing or you want the latest data:

npm run fetch-players

This fetches all active NFL players from Sleeper's API and updates the mappings.

⚠️ Operational Security

CLASSIFIED INFORMATION:

Token Half-Life: Authentication expires in ~31 solar cycles. Re-authenticate when compromised.

Queue Protocol: Each transmission replaces entire queue (no append mode - total replacement doctrine)

Target Identification: Exact name matching required (e.g., "A.J. Brown" - precision is paramount)

Local Execution Only: Operations run from secure local terminals only (no cloud deployment)

🐛 Troubleshooting

Issue Solution "Invalid token" error Tokens expired - get fresh ones from browser DevTools Players not found Check exact spelling, try npm run validate to see issues Permission denied Run chmod +x output/*.sh to make scripts executable Script hangs Check network connection, firewall settings

📖 Detailed Setup Guide

For comprehensive setup instructions including screenshots and troubleshooting, see docs/SETUP.md.

🤝 Allied Forces

Contributions from fellow operatives are welcome. Please submit pull requests through secure channels only.

Fork the repository (covert operation)

Create your feature branch (git checkout -b operation/YourMission)

Commit your changes (git commit -m 'Add tactical enhancement')

Push to the branch (git push origin operation/YourMission)

Open a Pull Request (await clearance)

🗺️ Roadmap

v1.0 "Operation Nightfall" (Current)

✅ Basic automation framework deployed

✅ Player ranking integration operational

✅ Draft execution engine armed

v2.0 "The CARKS Awakens" (Q2 2025)

🎯 Advanced machine learning algorithms

🎯 Real-time injury tracking satellite

🎯 Social media sentiment analysis division

v3.0 "CARKS: Reloaded" (Q4 2025)

🔮 Predictive modeling with 97% accuracy

🔮 Quantum draft simulation chambers

🔮 Neuralink integration (pending FDA clearance)

📄 License

MIT License - because even covert operations need proper documentation.

🎖️ Acknowledgments

The Sleeper API team (unwitting accomplices)

2025 NFL player database (365+ confirmed targets)

Coffee (primary fuel source)

That one guy who autodrafted and still beat you (inspiration)

⚡ Operational Metrics

Payload Capacity: 365+ simultaneous targets

Response Time: < 2 seconds per strike

Detection Rate: 0% (no rate limiting encountered)

Success Rate: CLASSIFIED

📞 Emergency Contact

If the system becomes self-aware or starts drafting kickers in the 3rd round:

Initiate Protocol Omega

Check the troubleshooting section

Review tactical manual

Submit incident report with:

Error codes

CSV intelligence format

Node.js clearance level (node --version)

Remember: With great CARKS comes great responsibility.

"Stay frosty, draft wisely." - Anonymous CARKS Operative

Development Status Badges

Disclaimer: This tactical system is unofficial and operates independently of Sleeper. Deploy at your own risk within operational parameters.

0 likes · 12 views · Nov 6, 2025

Developed a fantasy football draft automation system for Sleeper leagues.