Skip to main content

Fantasy Draft Assistant

Never miss a value pick again. Real-time player recommendations powered by live game data and season-long stats, right when you need them -- during your fantasy draft.


The Problem

Your fantasy draft is live. The clock is ticking. You need to decide between three players, but you don't know who's been hot lately, who's dealing with a minor tweak, or which position is about to run dry. You're tabbing between five browser windows and still guessing.

The Solution

Fantasy Draft Assistant merges live game performance with full-season stats to give you a ranked draft board that updates in real time. It knows who's on fire tonight, which positions are getting scarce, and where the value picks are hiding.

+--------------------------------------------------+
|  FANTASY DRAFT ASSISTANT — NBA Points League     |
|  Round 7, Pick 3  |  Your roster: 6/13 filled    |
+--------------------------------------------------+
|                                                  |
|  BEST AVAILABLE                                  |
|  ┌──────────────────────────────────────────┐    |
|  │ 1. Darius Garland (PG/SG) — VOR: +14.2  │    |
|  │    Season: 21.3 pts, 8.1 ast, 2.4 3pm   │    |
|  │    Last 10: 24.8 pts (+17% from avg)     │    |
|  │    LIVE: 28 pts at halftime tonight      │    |
|  │    >> RECOMMENDED — fills PG need        │    |
|  ├──────────────────────────────────────────┤    |
|  │ 2. Tyler Herro (SG/SF) — VOR: +11.8     │    |
|  │    Season: 23.7 pts, 5.2 reb, 4.8 ast   │    |
|  │    Last 10: 21.1 pts (-11% from avg)     │    |
|  ├──────────────────────────────────────────┤    |
|  │ 3. Walker Kessler (C) — VOR: +10.4      │    |
|  │    Season: 12.1 pts, 9.8 reb, 2.9 blk   │    |
|  │    Last 10: 14.3 pts (+18% from avg)     │    |
|  │    >> SLEEPER — blocks upside            │    |
|  └──────────────────────────────────────────┘    |
|                                                  |
|  POSITIONAL SCARCITY ALERT                       |
|  PG: 4 quality options left (SCARCE)             |
|  C:  7 quality options left (OK)                 |
|  SF: 11 quality options left (DEEP)              |
+--------------------------------------------------+

Features

  • Live context — Sees who's performing right now in tonight's games
  • Value over replacement — Ranks players relative to the next-best option at their position
  • Positional scarcity — Warns you when a position is drying up
  • Trend detection — Flags players trending up or down over the last 10 games
  • Sleeper picks — Surfaces under-drafted players with recent breakout signals
  • Multi-format — Supports points leagues, category leagues, and roto

Quick Start

1. Install dependencies

pip install requests

2. Set your API key

Requires a Shipp.ai API key for live game context -- get 5,000 free credits/day at platform.shipp.ai.

export SHIPP_API_KEY="your-api-key-here"

3. Run the draft assistant

# NBA points league draft
python scripts/draft_agent.py --sport nba --format points

# NBA 9-category league
python scripts/draft_agent.py --sport nba --format categories

# MLB roto league (spring training scouting mode)
python scripts/draft_agent.py --sport mlb --format roto

# Exclude already-drafted players
python scripts/draft_agent.py --sport nba --format points --drafted "LeBron James,Nikola Jokic,Luka Doncic"

4. During your draft

The assistant outputs a ranked board of available players. After each pick:

  • Mark the player as drafted (remove from available pool)
  • Add your pick to your roster
  • The board re-ranks based on your new positional needs

How It Works

  1. Live game scan — Connects to live sports feed for current game data
  2. Season stats pull — Fetches per-game averages and recent game logs from public stats APIs
  3. Merge and rank — Combines live signals (hot/cold) with season baselines
  4. VOR calculation — For each position, computes value above the replacement-level player
  5. Scarcity adjustment — Positions with fewer quality options get a draft priority boost
  6. Output — Sorted recommendations with context on why each player ranks where they do

Data Sources

Source Data Auth Required
Live game feed (via Shipp.ai) Current game scores, player performance API key (free tier)
balldontlie.io NBA season stats, game logs None
statsapi.mlb.com MLB stats, spring training, rosters None

Configuration

Environment Variable Required Description
SHIPP_API_KEY Yes API key for live game data

License

MIT


Powered by Shipp.ai real-time sports data

Release files for shipp-fantasy 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for shipp-fantasy 0.1.0
File Size Uploaded
shipp_fantasy-0.1.0.tar.gz 37.7 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for shipp-fantasy 0.1.0
File Interpreter ABI Platform
shipp_fantasy-0.1.0-py3-none-any.whl Python 3 none any Details

Total release size: 53.6 kB

Release files / shipp_fantasy-0.1.0.tar.gz

Download URL shipp_fantasy-0.1.0.tar.gz
Size 37.7 kB
Tags Source
SHA-256 checksum
How to use checksums
a486f132c3b23a96bcdf22e03600ed09fdafa1241ddf31ff0ced5197ef5ea168
BLAKE2b-256 checksum
How to use checksums
ca53114fd29e9494ad8d8913f1bcf2d2a105481f22ea7c618bf3c2652b199714
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.13.12

Release files / shipp_fantasy-0.1.0-py3-none-any.whl

Download URL shipp_fantasy-0.1.0-py3-none-any.whl
Size 16.0 kB
Tags Python 3
SHA-256 checksum
How to use checksums
048454daca803d25010477d38c87d2386c6081a069be360e7d46fd6fd9169e57
BLAKE2b-256 checksum
How to use checksums
4117a83cb55248115bad90aa7ff9a271f22eb73246b48eddc45bbdb2157f6d89
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.13.12

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page