sharsil/mailcat

How sharsil/mailcat works

Mailcat is a command-line OSINT tool that checks whether email addresses associated with supplied nicknames already exist. Its main workflow accepts one or more usernames (optionally from a file), runs provider-specific checks, and reports matches. The implementation is concentrated in one large module; provider methods include registration and recovery endpoints, SMTP, APIs, and browser-driven checks. The README documents Tor and proxy routing. The excerpt does not show the full dispatcher or result-formatting code, so those internal links are limited to documented behavior.

Main entry points: __init__.py Check orchestration · __main__.py Module entry

Components 12

Command entry

Module entry src/mailcat/__main__.py
CLI runtime src/mailcat/__init__.py
Username inputs src/mailcat/__init__.py

Provider checks

Check orchestration src/mailcat/__init__.py
Registration checks src/mailcat/__init__.py
SMTP checks src/mailcat/__init__.py
API checks src/mailcat/__init__.py
Browser checks src/mailcat/__init__.py

Network routing

Tor / proxy

Results

Match output src/mailcat/__init__.py

Other components

User
Email providers

Connections 16

User → Module entry: runs command README.md
Module entry → CLI runtime: calls main src/mailcat/__main__.py
User → Username inputs: provides names README.md
Username inputs → Check orchestration: checks names README.md
CLI runtime → Check orchestration: starts checks src/mailcat/__init__.py
Check orchestration → Registration checks: dispatches checks src/mailcat/__init__.py
Check orchestration → SMTP checks: dispatches checks src/mailcat/__init__.py
Check orchestration → API checks: dispatches checks src/mailcat/__init__.py
Check orchestration → Browser checks: dispatches checks src/mailcat/__init__.py
Registration checks → Email providers: queries availability README.md
SMTP checks → Email providers: checks addresses README.md
API checks → Email providers: queries availability README.md
Browser checks → Email providers: checks availability README.md
Tor / proxy → SMTP checks: routes traffic README.md
Tor / proxy → Check orchestration: routes requests README.md
Check orchestration → Match output: reports matches README.md

Drawn by GitDiagram on November 14, 2026 from the repository's file tree, README and source files. Read as Markdown ·