diff options
| author | s <[email protected]> | 2025-11-06 22:24:43 -0500 |
|---|---|---|
| committer | s <[email protected]> | 2025-11-06 22:24:43 -0500 |
| commit | d9990f48d76bf13f59b582e13eb66b1756457bfb (patch) | |
| tree | 08fbd124e765e14a7e9a3196dfe266bd67236aca | |
| parent | 5f0e15788032951f215bda1df3b5ce1e55125f59 (diff) | |
| download | dborg-d9990f48d76bf13f59b582e13eb66b1756457bfb.tar.gz dborg-d9990f48d76bf13f59b582e13eb66b1756457bfb.zip | |
feat: add osint, reddit, and skiptrace commands and update installation to use @latestv0.3.0
| -rw-r--r-- | README.md | 115 | ||||
| -rw-r--r-- | cmd/update.go | 4 | ||||
| -rw-r--r-- | internal/utils/version.go | 4 |
3 files changed, 111 insertions, 12 deletions
@@ -9,9 +9,13 @@ dborg/ ├── cmd/ # CLI commands │ ├── admin.go # Admin commands (build tag: admin) │ ├── npd.go # NPD breach data search +│ ├── osint.go # OSINT tools (username, BSSID, BreachForum) +│ ├── reddit.go # Reddit data retrieval │ ├── root.go # Root command configuration +│ ├── skiptrace.go # Premium skiptrace operations │ ├── sl.go # Stealer logs search -│ ├── usrsx.go # Username availability check +│ ├── update.go # Auto-update functionality +│ ├── version.go # Version command │ └── x.go # Twitter/X username history ├── internal/ # Private application code │ ├── client/ # API client implementation @@ -19,6 +23,9 @@ dborg/ │ │ ├── client.go # Base HTTP client │ │ ├── client_test.go # Client tests │ │ ├── npd.go # NPD API methods +│ │ ├── osint.go # OSINT API methods +│ │ ├── reddit.go # Reddit API methods +│ │ ├── skiptrace.go # Skiptrace API methods │ │ ├── sl.go # Stealer logs API methods │ │ ├── usrsx.go # Username check API methods │ │ └── x.go # Twitter/X API methods @@ -28,6 +35,9 @@ dborg/ │ ├── models/ # Data models │ │ ├── admin.go # Admin response types │ │ ├── npd.go # NPD response types +│ │ ├── osint.go # OSINT response types +│ │ ├── reddit.go # Reddit response types +│ │ ├── skiptrace.go # Skiptrace response types │ │ ├── sl.go # Stealer logs types │ │ ├── usrsx.go # Username check types │ │ └── x.go # Twitter/X types @@ -45,7 +55,7 @@ dborg/ ## Installation ```bash -go install git.db.org.ai/dborg +go install git.db.org.ai/dborg@latest ``` To build with admin commands: @@ -64,7 +74,7 @@ go build -tags admin -o dborg . The CLI automatically checks for updates on startup. When a newer version is available: - You'll be prompted to update -- Accepts with `Y` or `Enter` to install the latest version via `go install git.db.org.ai/dborg` +- Accepts with `Y` or `Enter` to install the latest version via `go install git.db.org.ai/dborg@latest` - The binary automatically restarts with the new version - Skip with `n` to continue with your current version @@ -117,16 +127,105 @@ Available flags: - `--posted_start_date`, `--posted_end_date` - `--format` (json, ulp, up, pul, etc.) -### USRSX - Check username availability +### OSINT - Open Source Intelligence tools + +#### Username Check +Check username availability across hundreds of websites using WhatsMyName dataset: + +```bash +dborg osint username john_doe --sites GitHub,Twitter --max_tasks 100 +``` + +Available flags: +- `--sites`, `-s` (comma-separated list of specific sites to check) +- `--fuzzy`, `-f` (enable fuzzy validation mode) +- `--max_tasks`, `-m` (maximum concurrent tasks, default: 50) + +#### BSSID Lookup +Lookup WiFi access point location by BSSID (MAC address): + +```bash +dborg osint bssid 00:11:22:33:44:55 --google --osm +``` + +Available flags: +- `--all`, `-a` (show all related results instead of exact match only) +- `--google`, `-g` (include Google Maps URL for the location) +- `--osm`, `-o` (include OpenStreetMap URL for the location) + +#### BreachForum Search +Search BreachForum data from breachdetect index: ```bash -dborg usrsx username123 --sites GitHub,Twitter --max_tasks 100 +dborg osint breachforum "search term" --max_hits 20 ``` Available flags: -- `--sites` (comma-separated list) -- `--fuzzy` (enable fuzzy validation) -- `--max_tasks` (default: 50) +- `--max_hits`, `-m` (maximum number of results, default: 10) + +### Reddit - Reddit data retrieval + +#### Subreddit Posts +```bash +dborg reddit subreddit posts programming +``` + +#### Subreddit Comments +```bash +dborg reddit subreddit comments programming +``` + +#### User Posts +```bash +dborg reddit user posts spez +``` + +#### User Comments +```bash +dborg reddit user comments spez +``` + +#### User Profile +```bash +dborg reddit user about spez +``` + +### Skiptrace - Premium people search (requires premium access) + +**Note:** All skiptrace commands require a premium API key. Contact support to upgrade for premium access. + +#### Search People +```bash +dborg skiptrace people --first-name John --last-name Doe --city Austin --state TX +``` + +Required flags: +- `--first-name`, `-f` (first name) +- `--last-name`, `-l` (last name) + +Optional flags: +- `--city`, `-c` (city) +- `--state`, `-s` (state, 2-letter code) +- `--age`, `-a` (age) + +#### Get Person Report +```bash +dborg skiptrace report SX_KEY 1 +``` + +Args: `[sx_key]` `[selection]` from previous search results + +#### Phone Lookup +```bash +dborg skiptrace phone 5551234567 +``` + +Args: 10-digit phone number (no +1 prefix) + +#### Email Lookup +```bash +dborg skiptrace email [email protected] +``` ### X - Twitter/X username history diff --git a/cmd/update.go b/cmd/update.go index c1aaec3..fe1e958 100644 --- a/cmd/update.go +++ b/cmd/update.go @@ -11,11 +11,11 @@ import ( var updateCmd = &cobra.Command{ Use: "update", Short: "Update dborg to the latest version", - Long: `Update dborg by running go install git.db.org.ai/dborg`, + Long: `Update dborg by running go install git.db.org.ai/dborg@latest`, Run: func(cmd *cobra.Command, args []string) { fmt.Println("Updating dborg...") - installCmd := exec.Command("go", "install", "git.db.org.ai/dborg") + installCmd := exec.Command("go", "install", "git.db.org.ai/dborg@latest") installCmd.Stdout = os.Stdout installCmd.Stderr = os.Stderr diff --git a/internal/utils/version.go b/internal/utils/version.go index 1759ecc..42a6d40 100644 --- a/internal/utils/version.go +++ b/internal/utils/version.go @@ -78,13 +78,13 @@ func promptAndUpdate(newVersion string) { fmt.Fprintf(os.Stderr, "Updating to %s...\n", newVersion) - installCmd := exec.Command("go", "install", "git.db.org.ai/dborg") + installCmd := exec.Command("go", "install", "git.db.org.ai/dborg@latest") installCmd.Stdout = os.Stderr installCmd.Stderr = os.Stderr if err := installCmd.Run(); err != nil { fmt.Fprintf(os.Stderr, "Failed to update: %v\n", err) - fmt.Fprintf(os.Stderr, "Please update manually: go install git.db.org.ai/dborg\n\n") + fmt.Fprintf(os.Stderr, "Please update manually: go install git.db.org.ai/dborg@latest\n\n") return } |
