gitwtfhub

wtf is f150-lightning-scanner?

mattbrubakr/f150-lightning-scanner — explained in plain English

Analysis updated 2026-05-18

1PythonAudience · generalComplexity · 2/5Setup · moderate

TL;DR

A daily scanner that checks six car listing sites for used Ford F-150 Lightning Lariat trucks, filters by battery type, and builds an HTML deal report.

Mindmap

mindmap
  root((f150 lightning scanner))
    What it does
      Scans 6 car sites
      Filters Lariat ER trim
      Dedupes by VIN
      Tracks price drops
    Tech stack
      Python
      Playwright
      nodriver
    Use cases
      Daily used truck search
      Deal scoring
      Price history tracking
    Audience
      Truck shoppers
      Mac users

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Automatically check six car sites at once for a used F-150 Lightning Lariat instead of refreshing them by hand.

REASON 2

See which listings are confirmed Extended Range versus unconfirmed battery type.

REASON 3

Track price drops on specific trucks over time and spot deals against the live market median.

What's in the stack?

PythonPlaywright

How it stacks up

mattbrubakr/f150-lightning-scanner0xustaz/streamgatea-bissell/unleash-lite
Stars111
LanguagePythonPythonPython
Setup difficultymoderatehardhard
Complexity2/54/54/5
Audiencegeneraldeveloperresearcher

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · moderate Time to first run · 30min

Requires a Mac, Python 3.11+, Google Chrome, and installing Playwright's Chromium browser.

No license information is provided in the README.

Wtf does this do

F-150 Lightning Scanner is a tool for people actively shopping for a used 2023-2024 Ford F-150 Lightning Lariat pickup truck. Instead of manually checking Cars.com, CarGurus, AutoTrader, CarMax, Edmunds, and Carvana every day, you run this scanner and it checks all six sources for you, then builds a single HTML report you can open in any browser. The scanner focuses specifically on the Lariat trim with the Extended Range battery, filtering out Standard Range trucks and other trims like Pro, XLT, and Flash. It figures out which battery a listing has by reading the VIN, with text-based backup checks when the VIN alone is not conclusive. Listings found on more than one site are matched by VIN so the same truck does not show up twice in your report. Each report groups listings into confirmed Extended Range, unconfirmed battery type, and a separate callout for a specific paint color the owner is targeting (Azure Gray by default, but this can be changed in the settings). Every listing gets a 1 to 5 star deal score based on how its price compares to the current market median, adjusted for mileage. The tool also tracks price drops over time and keeps a history so you can see when a price changed and by how much. Setup requires a Mac with Python 3.11 or later, and takes about 10 to 15 minutes the first time. After downloading the code, you install a few Python packages and two browser automation tools it depends on to read listing pages. Search settings like your zip code, target color, and fallback price baseline are adjusted by editing a plain settings file. Once set up, running a scan takes a few minutes and produces a fresh, dated report each time, with troubleshooting notes included for common setup issues.

Yoink these prompts

Prompt 1
Walk me through installing Python 3.11 and setting up this F-150 Lightning scanner on my Mac step by step.
Prompt 2
How do I change the target zip code and paint color settings in scanner/config.py?
Prompt 3
Explain what the deal score stars and DOM column mean in the generated HTML report.
Prompt 4
Help me troubleshoot a ModuleNotFoundError when running scanner.py.

Frequently asked questions

wtf is f150-lightning-scanner?

A daily scanner that checks six car listing sites for used Ford F-150 Lightning Lariat trucks, filters by battery type, and builds an HTML deal report.

What language is f150-lightning-scanner written in?

Mainly Python. The stack also includes Python, Playwright.

What license does f150-lightning-scanner use?

No license information is provided in the README.

How hard is f150-lightning-scanner to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is f150-lightning-scanner for?

Mainly general.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.