Skip to content

UnauthScout is an OSINT (Open Source Intelligence) tool developed in Bash for passive exploration of assets on version control platforms (GitLab and GitHub).

License

Notifications You must be signed in to change notification settings

rmottanet/unauthscout

Repository files navigation

Quality Gate Status Reliability Rating Maintainability Rating Security Rating Bugs Vulnerabilities

UnauthScout

UnauthScout is a CLI tool for unauthenticated OSINT reconnaissance on public developer platforms such as GitHub and GitLab.

It standardizes the collection of publicly available user data using a consistent interface and normalized JSON output contracts.

Problem Statement

Public developer platforms expose valuable reconnaissance data without requiring authentication. However, this data is often inconsistent across providers and hard to consume programmatically.

UnauthScout addresses this by:

  • Querying public APIs without authentication
  • Normalizing responses via explicit schemas
  • Providing a simple, script-friendly CLI

Features

  • Unauthenticated user reconnaissance on GitHub
  • Unauthenticated user reconnaissance on GitLab
  • Normalized JSON output defined by explicit schemas
  • Raw output mode for debugging and field discovery
  • Modular, provider-based architecture

Non-goals

  • Authentication or token-based access
  • Rate-limit bypassing
  • Collection of private or restricted data
  • Automated correlation or enrichment across platforms

Requirements

  • Bash (POSIX-compatible)
  • curl
  • jq

Installation

git clone https://github.com/rmottanet/unauthscout.git
cd unauthscout
chmod +x bin/unauthscout

Usage

Basic usage

unauthscout <username>

Raw output (unprocessed API response)

unauthscout <username> --raw

By default, UnauthScout outputs normalized JSON that conforms to the corresponding schema under schemas/.

Output Contracts

Normalized outputs are defined via JSON Schema:

  • schemas/github_user.json
  • schemas/gitlab_user.json

These schemas are the source of truth for all processed output and ensure stable, predictable data structures.

Project Structure

bin/        # CLI entry point and orchestration
lib/        # Provider integrations and parsing logic
schemas/    # Normalized data contracts (JSON Schema)
docs/       # Documentation as code
tests/      # Automated tests (optional)

Design Principles

  • Unauthenticated by default
  • Explicit data contracts over implicit assumptions
  • Clear separation between orchestration and data retrieval
  • Minimal surface area, extensible by design



Static Badge Static Badge

About

UnauthScout is an OSINT (Open Source Intelligence) tool developed in Bash for passive exploration of assets on version control platforms (GitLab and GitHub).

Topics

Resources

License

Contributing

Security policy

Stars

Watchers

Forks

Languages