↑ ↓ to navigate
    ↵ to select
    esc to close
    Urx

    Examples

    Usage Examples

    Basic Usage

    Single Domain

    urx example.com

    Multiple Domains

    urx example.com example.org

    From Standard Input

    cat domains.txt | urx

    File Input

    # Single file
urx --files urls.txt

# Multiple files
urx --files urls.txt archive.warc data.gz
urx --files urls.txt --files archive.warc

# With filters
urx --files data.txt --patterns api,admin -f json

    Output Formats

    Save to File

    urx example.com -o results.txt

    JSON Format

    urx example.com -f json -o results.json

    CSV Format

    urx example.com -f csv -o results.csv

    Filtering Examples

    Include Specific Extensions

    # JavaScript files only
urx example.com -e js

# Multiple extensions
urx example.com -e js,php,aspx

    Exclude Extensions

    urx example.com --exclude-extensions html,txt

    Pattern Matching

    # Include patterns
urx example.com --patterns api,v1,graphql

# Exclude patterns
urx example.com --exclude-patterns static,images

# Combined
urx example.com --patterns api --exclude-patterns test,dev

    Using Presets

    # Exclude images
urx example.com -p no-images

# Exclude all resources (images, CSS, fonts, etc.)
urx example.com -p no-resources

# JavaScript files only
urx example.com -p only-js

    Advanced Filtering

    # Multiple filters
urx example.com -e js,php --patterns admin,login --min-length 20

# URL length constraints
urx example.com --min-length 50 --max-length 200

    Provider Selection

    Specific Providers

    # Only Wayback Machine and OTX
urx example.com --providers wayback,otx

# All available providers
urx example.com --providers wayback,cc,otx,vt,urlscan

    With API Keys

    Command Line

    urx example.com --vt-api-key=YOUR_KEY --urlscan-api-key=YOUR_KEY

    Environment Variables

    export URX_VT_API_KEY=YOUR_KEY
export URX_URLSCAN_API_KEY=YOUR_KEY
urx example.com --providers=vt,urlscan

    API Key Rotation

    # Multiple keys for rate limit distribution
urx example.com --vt-api-key=key1 --vt-api-key=key2 --vt-api-key=key3

# Or with environment variable
URX_VT_API_KEY=key1,key2,key3 urx example.com

    Discovery Options

    Exclude Discovery Features

    # Exclude robots.txt
urx example.com --exclude-robots

# Exclude sitemap.xml
urx example.com --exclude-sitemap

# Exclude both
urx example.com --exclude-robots --exclude-sitemap

    Testing & Validation

    Include Subdomains

    urx example.com --subs

    Check HTTP Status

    urx example.com --check-status

    urx example.com --extract-links

    Status Filtering

    # Include only successful responses
urx example.com --check-status --include-status 200

# Include redirects and success
urx example.com --check-status --include-status 200,30x

# Exclude errors
urx example.com --check-status --exclude-status 404,50x

    Network Configuration

    Proxy Usage

    urx example.com --proxy http://localhost:8080

    Proxy with Authentication

    urx example.com --proxy http://localhost:8080 --proxy-auth username:password

    Custom Timeouts and Parallelism

    urx example.com --timeout 60 --parallel 10

    Skip SSL Verification

    urx example.com --insecure

    Random User-Agent

    urx example.com --random-agent

    Complete Network Configuration

    urx example.com \
  --proxy http://localhost:8080 \
  --timeout 60 \
  --parallel 10 \
  --retries 5 \
  --insecure \
  --random-agent

    URL Normalization

    Basic Normalization

    urx example.com --normalize-url

    With Endpoint Merging

    urx example.com --normalize-url --merge-endpoint

    From File

    urx --files urls.txt --normalize-url

    Caching & Incremental Scanning

    SQLite Cache (Default)

    urx example.com --cache-type sqlite --cache-path ~/.urx/cache.db

    Redis Cache

    urx example.com --cache-type redis --redis-url redis://localhost:6379

    Incremental Mode

    # Only return new URLs not seen before
urx example.com --incremental

    Custom TTL

    # Set cache TTL to 12 hours (43200 seconds)
urx example.com --cache-ttl 43200

    Disable Cache

    urx example.com --no-cache

    Combined Caching Examples

    # Daily monitoring with incremental updates
urx target.com --incremental --silent | notify-tool

# Distributed scanning with shared Redis cache
urx example.com --cache-type redis --redis-url redis://shared-cache:6379

# Rapid iterations with short cache TTL
urx test-domain.com --cache-ttl 300

# Incremental scan with filtering
urx example.com --incremental -e js,php --patterns api

    Pipeline Integration

    Filter with grep

    echo "example.com" | urx | grep "login" > targets.txt

    Chain with Other Tools

    cat domains.txt | urx --patterns api | other-tool

    Security Tool Integration

    # With Nuclei for XSS scanning
urx example.com -e js | nuclei -t xss

# With httpx for HTTP probing
urx example.com | httpx -silent

# With gf patterns
urx example.com | gf xss

    Display Options

    Verbose Output

    urx example.com -v

    Silent Mode

    urx example.com --silent

    Disable Progress Bar

    urx example.com --no-progress

    Complex Scenarios

    Complete Bug Bounty Workflow

    urx target.com \
  --subs \
  -e js,json,xml \
  --patterns api,v1,v2,admin,panel \
  --exclude-patterns cdn,static \
  --check-status \
  --include-status 200,30x \
  --incremental \
  --parallel 15 \
  -o results.txt

    API Endpoint Discovery

    urx example.com \
  --patterns api,graphql,rest,v1,v2,v3 \
  -e json,xml \
  --exclude-patterns test,staging \
  -f json \
  -o api-endpoints.json

    JavaScript Analysis Pipeline

    urx target.com \
  -p only-js \
  --check-status \
  --include-status 200 \
  --extract-links \
  | tee js-files.txt \
  | nuclei -t exposures/