# martinvigo/email2phonenumber architecture

> Architecture diagram of the GitHub repository martinvigo/email2phonenumber, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-07). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/martinvigo/email2phonenumber
- Repository: https://github.com/martinvigo/email2phonenumber

## Overview

email2phonenumber is a single-file OSINT command-line tool with three documented modes: scrape recovery flows for masked phone digits, generate candidate numbers from numbering-plan data, and brute-force candidates against recovery flows to correlate masked emails. The README documents the modes and supported services; sampled excerpts show HTTP interactions with Amazon, Twitter, LastPass, PayPal, and numbering-plan data sources. The excerpts are partial, so internal dispatch and some integrations are represented only where documentation supports them.

Main entry points: [`email2phonenumber.py`](https://github.com/martinvigo/email2phonenumber/blob/master/email2phonenumber.py) (Recovery probes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["CLI entry"]
  node_cli["CLI commands"]
end

subgraph group_recovery["Recovery probing"]
  node_scrape["Scrape mode"]
  node_bruteforce["Bruteforce mode"]
  node_recovery_probes["Recovery probes"]
end

subgraph group_numbers["Number generation"]
  node_generate["Generate mode"]
  node_numbering_data["Numbering data"]
end

subgraph group_data["External services"]
  node_amazon["Amazon recovery"]
  node_twitter["Twitter recovery"]
  node_lastpass["LastPass recovery"]
  node_paypal["PayPal recovery"]
  node_ebay["eBay recovery"]
  node_nanpa["NANPA data"]
  node_pooling["Pooling data"]
end

node_user(("Operator"))

node_user -->|"runs command"| node_cli
node_cli -->|"selects mode"| node_scrape
node_cli -->|"selects mode"| node_generate
node_cli -->|"selects mode"| node_bruteforce
node_scrape -->|"starts resets"| node_recovery_probes
node_bruteforce -->|"tests candidates"| node_recovery_probes
node_recovery_probes -->|"requests reset"| node_amazon
node_recovery_probes -->|"requests reset"| node_twitter
node_recovery_probes -->|"requests reset"| node_lastpass
node_recovery_probes -->|"requests reset"| node_paypal
node_scrape -->|"scrapes digits"| node_ebay
node_generate -->|"builds candidates"| node_numbering_data
node_numbering_data -->|"downloads plan"| node_nanpa
node_numbering_data -->|"queries assignments"| node_pooling

click node_cli "https://github.com/martinvigo/email2phonenumber/blob/master/email2phonenumber.py"
click node_scrape "https://github.com/martinvigo/email2phonenumber/blob/master/email2phonenumber.py"
click node_bruteforce "https://github.com/martinvigo/email2phonenumber/blob/master/email2phonenumber.py"
click node_recovery_probes "https://github.com/martinvigo/email2phonenumber/blob/master/email2phonenumber.py"
click node_generate "https://github.com/martinvigo/email2phonenumber/blob/master/email2phonenumber.py"
click node_numbering_data "https://github.com/martinvigo/email2phonenumber/blob/master/email2phonenumber.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_cli toneBlue
class node_scrape,node_bruteforce,node_recovery_probes toneAmber
class node_generate,node_numbering_data toneMint
class node_amazon,node_twitter,node_lastpass,node_paypal,node_ebay,node_nanpa,node_pooling toneRose
class node_user toneIndigo
```

## Components

### CLI entry

- [CLI commands](https://github.com/martinvigo/email2phonenumber/blob/master/email2phonenumber.py): `email2phonenumber.py`

### Recovery probing

- [Scrape mode](https://github.com/martinvigo/email2phonenumber/blob/master/email2phonenumber.py): `email2phonenumber.py`
- [Bruteforce mode](https://github.com/martinvigo/email2phonenumber/blob/master/email2phonenumber.py): `email2phonenumber.py`
- [Recovery probes](https://github.com/martinvigo/email2phonenumber/blob/master/email2phonenumber.py): `email2phonenumber.py`

### Number generation

- [Generate mode](https://github.com/martinvigo/email2phonenumber/blob/master/email2phonenumber.py): `email2phonenumber.py`
- [Numbering data](https://github.com/martinvigo/email2phonenumber/blob/master/email2phonenumber.py): `email2phonenumber.py`

### External services

- **Amazon recovery**
- **Twitter recovery**
- **LastPass recovery**
- **PayPal recovery**
- **eBay recovery**
- **NANPA data**
- **Pooling data**

### Other components

- **Operator**

## Connections

- Operator → CLI commands: runs command (evidence: `README.md`)
- CLI commands → Scrape mode: selects mode (evidence: `README.md`)
- CLI commands → Generate mode: selects mode (evidence: `README.md`)
- CLI commands → Bruteforce mode: selects mode (evidence: `README.md`)
- Scrape mode → Recovery probes: starts resets (evidence: `README.md`)
- Bruteforce mode → Recovery probes: tests candidates (evidence: `README.md`)
- Recovery probes → Amazon recovery: requests reset (evidence: `email2phonenumber.py`)
- Recovery probes → Twitter recovery: requests reset (evidence: `email2phonenumber.py`)
- Recovery probes → LastPass recovery: requests reset (evidence: `email2phonenumber.py`)
- Recovery probes → PayPal recovery: requests reset (evidence: `email2phonenumber.py`)
- Scrape mode → eBay recovery: scrapes digits (evidence: `README.md`)
- Generate mode → Numbering data: builds candidates (evidence: `README.md`)
- Numbering data → NANPA data: downloads plan (evidence: `email2phonenumber.py`)
- Numbering data → Pooling data: queries assignments (evidence: `email2phonenumber.py`)
