README
¶
██ ██ ██ ██ ███ ██ ██ ██ ██ ██ ██ ██ ████ ██ ██ ██ █████ ██ ██ ██ ██ ██ ██ ██ ██ ██ ██ ██ ██ ██ ██ ██ ██ ██ ██ ██ ██████ ██ ████ █████ ██
Universal API Key Validation Engine
Features • Installation • Usage • Security • Providers • Full Manual
Kunji is a high-performance, concurrent CLI tool designed to rapidly validate API keys across 260+ services. Whether you're auditing infrastructure, testing integrations, or cleaning up configuration dumps, Kunji provides a safe, fast, and automated way to verify credentials.
🚀 Terminal Experience
Kunji features a modern, interactive UI built with pterm, providing real-time feedback during bulk operations.
██ ██ ██ ██ ███ ██ ██ ██
██ ██ ██ ██ ████ ██ ██ ██
█████ ██ ██ ██ ██ ██ ██ ██
██ ██ ██ ██ ██ ██ ██ ██ ██ ██
██ ██ ██████ ██ ████ █████ ██
Validating API Keys [256/260] ███████████████████████████████████░ 98%
» shopify ✓ Valid myshop:shpat_****abc123
» openai ✓ Valid sk-proj-****xyz789
» stripe ✗ Invalid sk_live_****123456
» deepseek ✓ Valid sk-****def456
✨ Key Features
- 🔍 Smart Auto-Detection — Instantly identifies 260+ services via a high-speed prefix trie and sensitive regex fallback.
- ⚡ Concurrent Engine — Multi-threaded worker pool handles thousands of keys in seconds with configurable throughput.
- 📊 Metadata Extraction — Automatically retrieves account balance, email, usage limits, and organization names.
- 🛡️ Hardened Security — Built-in SSRF protection, restrictive file permissions, and automatic secret scrubbing in logs.
- 🔄 Smart Resume & Retry — Skip already-validated keys and handle intermittent network failures or rate limits with jittered backoff.
- 📤 Clean Export — Generate structured reports in
.txt,.csv, or.jsonfor easy integration with other tools.
📦 Installation
Go Install (Recommended)
go install github.com/Grey-Magic/kunji@latest
Prebuilt Binaries
Download the latest release for your platform:
# Example for Linux/macOS
curl -sL https://github.com/Grey-Magic/kunji/releases/latest/download/kunji_1.0.4.zip -o kunji.zip
unzip kunji.zip && chmod +x kunji
sudo mv kunji /usr/local/bin/
🛠️ Usage
For a comprehensive guide including service-specific examples, see USAGE.md.
Basic Commands
# Validate a single key (auto-detects provider)
kunji validate -k "sk-proj-..."
# Bulk validation from a file with 20 workers
kunji validate -f keys.txt -o results.csv -t 20
# Resume an interrupted run
kunji validate -f keys.txt --resume -o results.json
# List all 260+ supported services
kunji validate --list
Advanced Options
| Flag | Description |
|---|---|
-p, --provider |
Force a specific provider (e.g., openai) to skip detection. |
-c, --category |
Limit detection to a category (e.g., llm, payments). |
--proxy |
Provide a single proxy or a file for automatic rotation. |
--timeout |
Set custom request timeout (default: 15s). |
🏛️ Supported Providers (260+)
Kunji supports an extensive array of services across multiple domains:
| Category | Top Services |
|---|---|
| Foundation LLMs | OpenAI, Anthropic, Google Gemini, xAI, Mistral, DeepSeek |
| Cloud & Hosting | Cloudflare, Vercel, Netlify, Railway, DigitalOcean, Heroku, Render |
| Databases | MongoDB Atlas, Redis Cloud, ClickHouse, CockroachDB, TiDB, Neon |
| Security & OSINT | Shodan, VirusTotal, Censys, FOFA, ZoomEye, Intelligence X |
| Auth & Identity | Auth0, Clerk, WorkOS, Stytch, Frontegg, FusionAuth |
| DevOps & CICD | GitHub, GitLab, NPM, Supabase, CircleCI, Travis CI, Pulumi, ArgoCD |
| Payments | Stripe, PayPal, Square, LemonSqueezy, Paddle, Plaid |
| CMS & E-com | Shopify, WooCommerce, Strapi, Sanity, Contentful, Webflow, Prismic |
| Blockchain | Alchemy, Infura, QuickNode, Etherscan, Moralis, Thirdweb |
📄 License
This project is licensed under the MIT License - see the LICENSE file for details.
Documentation
¶
There is no documentation for this package.
Source Files
Directories