FedComp Index

Federal contractor competitive intelligence. Scores every federal contractor in a state from 0 to 100 based on public award data, assigns posture classes, and provides pre-scored datasets.

This is the meta-package. It installs:

• fedcomp-index-scoring - posture score computation engine
• fedcomp-index-data - pre-scored contractor datasets

Install

npm install fedcomp-index

Usage

const { scoreContractor, loadState, lookup, PostureClass } = require("fedcomp-index");

// Score a contractor from raw award data
const result = scoreContractor(15_000_000, "2025-09-15");
console.log(result.fedcompIndex);   // 58
console.log(result.postureClass);   // "Class 2"

// Load pre-scored data
const contractors = loadState("NV");
console.log(`${contractors.length} contractors scored`);

// Look up by UEI
const c = lookup("CGAKREGGN9J3");
console.log(c.legal_name);        // FLEET VEHICLE SOURCE INC
console.log(c.fedcomp_index);     // 81
console.log(c.posture_class);     // Class 1

Posture scoring methodology

Two index drivers, no normalization:

| Index driver | Weight | How it works | |-------------|--------|-------------| | Award volume | 90% | log10 of total dollars won, mapped to 0-100 | | Award recency | 10% | Last award date, bucketed by age |

Posture classes are fixed thresholds:

| Posture class | FedComp Index score | Typical award volume | |---------------|--------------------|--------------------| | Class 1 | 60-100 | $100M+ | | Class 2 | 40-59 | $5M-$100M | | Class 3 | 0-39 | Under $5M |

Full methodology: fedcompindex.org/methodology

Packages

| Package | What it does | |---------|-------------| | fedcomp-index | Meta-package (this one) | | fedcomp-index-scoring | Posture score computation | | fedcomp-index-data | Pre-scored contractor datasets |

Also available on PyPI

pip install fedcomp-index

• fedcomp-index - meta-package
• fedcomp-index-scoring - scoring engine
• fedcomp-index-data - pre-scored datasets

Data sources

All public federal records:

• USASpending.gov - award history, dollar amounts, agencies, NAICS, PSC
• SAM.gov - entity registration, certifications, CAGE/UEI
• SBA.gov - certification verification

Datasets

• Nevada Federal Contractors (HuggingFace)
• Nevada Federal Contract Awards (HuggingFace)
• Nevada Federal Contractors (Kaggle)
• Nevada Federal Contract Awards (Kaggle)

Links

• Website: https://fedcompindex.org/
• Nevada Rankings: https://fedcompindex.org/nv/
• Methodology: https://fedcompindex.org/methodology/
• Tabularium: https://fedcompindex.org/tabularium/
• FAQ: https://fedcompindex.org/faq/
• Source: https://github.com/fedcompindex/FedCompIndex
• PyPI: https://pypi.org/project/fedcomp-index/
• HuggingFace: https://huggingface.co/datasets/npetro6/nevada-federal-contractors
• Kaggle: https://www.kaggle.com/datasets/npetro6/nevada-federal-contractors-fedcomp-index

Citation

@software{fedcomp_index,
  title = {FedComp Index},
  author = {FedComp Index},
  url = {https://fedcompindex.org/},
  year = {2026}
}

License

MIT