Tenders-SA/cli

Official command-line interface (CLI) for the Tenders-SA Developer API. Search tenders, analyze awards, access company intelligence, and integrate South African procurement data into scripts, automation workflows, and CI/CD pipeline # @tenders-sa-org/cli Official CLI for the Tenders-SA Developer API v2 — South African public procurement data at your terminal. --- ## Quick Start ```bash npm install -g @tenders-sa-org/cli # Configure your API key tendersa config set tsa_prod_your_key # List open tenders in Western Cape tendersa tenders list --province "Western Cape" # Get tender details tendersa tenders get tender_001 # AI-powered search tendersa tenders search "road construction" # Get company intelligence profile tendersa companies get "BuildCorp SA" --json | jq '.data' # Check if a supplier is restricted tendersa forensic check "Acme Corp" # Check API health tendersa meta status ``` --- ## Commands ### Config ``` tendersa config set Save API key to ~/.tendersa/config.json tendersa config get Show current API key (masked) ``` ### Tenders (14 subcommands) | Command | Description | |---------|-------------| | `list` | List tenders (status, province, category, page, limit) | | `get ` | Get tender details with awards | | `search ` | AI-powered semantic search | | `closing-soon` | Tenders closing soon | | `new` | Newly published tenders | | `bbbee` | Tenders with B-BBEE requirements | | `by-province ` | Tenders in a specific province | | `by-category ` | Tenders in a specific category | | `counts` | Tender counts by province, category, status | | `documents ` | Tender documents | | `analysis ` | AI-generated analysis | | `value-estimate ` | Estimated value range | | `timeline ` | Tender timeline events | | `awards ` | Awards for a tender | ### Awards (5 subcommands) | Command | Description | |---------|-------------| | `list` | List awards (status, province, supplier, enterprise-type, bee-level, min-amount, max-amount) | | `get ` | Award details | | `analytics` | Award analytics (group-by, from, to) | | `by-supplier ` | Awards by supplier name | | `by-tender ` | Awards by tender ID | ### Companies (6 subcommands) | Command | Description | |------ …