Skip to content

alicelabs-llc/govcon-scoring

govcon-scoring

Open-source viability scoring engine for federal contract opportunities

Built by AliceLabs LLC

TypeScript SAM.gov NAICS Federal Contracting GovTech


What it does

Scores federal contract opportunities (0–100) against your company profile — no AI credits required. Uses NAICS code matching, certification alignment, capability keyword analysis, and deadline proximity to calculate a viability score instantly.

How scoring works

Factor Points Logic
NAICS match +25 Your primary NAICS codes match the solicitation
Set-aside eligibility +10–15 Your certifications align (8(a), HUBZone, WOSB, SDVOSB)
Capability keywords +5 each (max 20) Your capabilities mentioned in the opportunity description
Deadline proximity -15 to -35 Penalty for opportunities closing within 7 days
Base score 50 Starting point for all opportunities

Installation

npm install govcon-scoring

Usage

import { scoreOpportunity, type CompanyProfile, type Opportunity } from 'govcon-scoring';

const myCompany: CompanyProfile = {
  name: 'Acme Federal LLC',
  naicsCodes: ['541511', '541512', '541519'],
  capabilities: ['software development', 'cloud infrastructure', 'data processing'],
  certifications: ['Small Business', 'SBA 8(a)'],
};

const opportunity: Opportunity = {
  naicsCode: '541512',
  setAside: '8(a) Competitive',
  description: 'Cloud infrastructure modernization and data processing services...',
  responseDeadline: '2026-05-01T17:00:00Z',
};

const score = scoreOpportunity(opportunity, myCompany);
console.log(`Viability: ${score}/100`);
// → Viability: 85/100

Score interpretation

Range Label Recommendation
70–100 High match Strong fit — prioritize this bid
40–69 Medium match Worth reviewing — check requirements
0–39 Low match Likely misaligned — pass or partner

API

scoreOpportunity(opportunity, profile): number

Returns a score between 0 and 100.

Parameters:

  • opportunity.naicsCode — NAICS code from the solicitation
  • opportunity.setAside — Set-aside type (e.g., "Small Business", "8(a) Competitive", "HUBZone")
  • opportunity.description — Full text description of the opportunity
  • opportunity.responseDeadline — ISO 8601 deadline string
  • profile.naicsCodes — Array of your company's NAICS codes
  • profile.capabilities — Array of capability keywords
  • profile.certifications — Array of certifications held

Use cases

  • Pipeline prioritization — Score hundreds of SAM.gov opportunities and focus on the top matches
  • Team allocation — Route high-scoring opportunities to your best capture managers
  • Automated alerts — Trigger notifications only for opportunities scoring above your threshold
  • CRM integration — Embed scoring into your existing business development workflow

License

MIT — free to use, modify, and distribute.


Part of the AliceLabs GovTech toolkit

alicelabs.site

About

Federal contract viability scoring engine — NAICS matching, certification alignment, capability analysis. No AI required.

Topics

Resources

License

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Packages

 
 
 

Contributors