Metadata-Version: 2.4
Name: fedcontracts-cli
Version: 0.1.1
Summary: Search US federal contracts from your terminal — powered by USASpending.gov data, updated nightly
Project-URL: Homepage, https://govspendapi.com
Project-URL: Repository, https://github.com/d0nldduck22-crypto/fedcontracts-cli
Project-URL: Issues, https://github.com/d0nldduck22-crypto/fedcontracts-cli/issues
Project-URL: RapidAPI Listing, https://rapidapi.com/d0nldduck22-crypto/api/govspend-us-federal-contracts
License: MIT
Keywords: cli,federal-contracts,government,govtech,open-data,procurement,usaspending
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Financial and Insurance Industry
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Office/Business
Requires-Python: >=3.9
Requires-Dist: click>=8.1.0
Requires-Dist: requests>=2.31.0
Requires-Dist: rich>=13.0.0
Description-Content-Type: text/markdown

# fedcontracts-cli

Search US federal contracts from your terminal.

## Install

```bash
pip install fedcontracts-cli
```

## Setup

Get a free API key at [RapidAPI](https://rapidapi.com/d0nldduck22-crypto/api/govspend-us-federal-contracts) (50 requests/day free).

```bash
fedcontracts config --api-key YOUR_RAPIDAPI_KEY
```

## Usage

```bash
fedcontracts search                                    # keyword search
fedcontracts search --naics 541511 --min-amount 1000000
fedcontracts search --date-from 2026-03-01 --date-to 2026-03-28
fedcontracts search --agency 097 --export dod.csv
fedcontracts by-date 2026-03-24                        # all contracts on a date
fedcontracts get AWARD_ID                              # single contract detail
fedcontracts status                                    # API health check
```

## Data source

US federal contract awards via [USASpending.gov](https://usaspending.gov).
Updated nightly. Powered by the GovSpend API on [govspendapi.com](https://govspendapi.com).
