Skip to content

Feature: Add --only-found flag to filter console output for hits only #236

@kaifcodec

Description

@kaifcodec

Feature Request: Add --only-found flag for cleaner OSINT reporting

Description

Currently, when performing a full scan or a category scan, the tool outputs every check, including sites where the username/email was not found.

We need a new flag, --only-found, that filters the console output to display only successful matches.


Proposed Behavior

  • Flag: --only-found
  • Scope: This should apply to Category scans (-c) and Full scans (default).
  • Exclusion: This flag should be ignored when running a Single Module scan (-m), as the user is explicitly looking for a specific result there.

Username Mode:

If --only-found is active, only sites with the status [✔] Found (Status.TAKEN) should be printed to the terminal.

Email Mode:

If --only-found is active, only sites with the status [✔] Registered (Status.TAKEN) should be printed to the terminal.

Tasks

  • Add --only-found to the argparse logic in __main__.py.
  • Update Result class in result.py with a helper method (e.g., is_found()) to check if self.status.value == 0.
  • Modify orchestrator.py (User) and email_orchestrator.py (Email) to wrap the result.show() or print calls in a conditional check.
  • Ensure the flag is passed correctly through the asynchronous worker in email_orchestrator.py.

Example Usage

# Should only show sites where 'target' has an account
user-scanner -e target@email.com --only-found

# Should show all sites in Social category where 'target' has an account
user-scanner -u target -c social --only-found

Metadata

Metadata

Assignees

No one assigned

    Labels

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions