# vysecurity/linkedint architecture

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

- Interactive diagram: https://gitdiagram.com/vysecurity/linkedint
- Repository: https://github.com/vysecurity/linkedint

## Overview

LinkedInt is a command-line LinkedIn intelligence scraper that searches for people, optionally filters by company, generates email candidates, and produces an HTML report. The main workflow is documented in the README and implemented in one large Python file, so several distinct responsibilities share that source path. The excerpts show LinkedIn authentication and search requests, profile parsing, email-pattern lookup through Hunter, and image retrieval; report generation is documented but its implementation was not sampled.

Main entry points: [`LinkedInt.py`](https://github.com/vysecurity/linkedint/blob/master/LinkedInt.py) (CLI Prompts), [`LinkedInt.cfg`](https://github.com/vysecurity/linkedint/blob/master/LinkedInt.cfg) (Credentials)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_inputs["Inputs and Configuration"]
  node_credentials["Credentials<br/>[LinkedInt.cfg]"]
  node_cli["CLI Prompts<br/>[LinkedInt.py]"]
end

subgraph group_collection["LinkedIn Collection"]
  node_auth["LinkedIn Login<br/>[LinkedInt.py]"]
  node_search["People Search<br/>[LinkedInt.py]"]
  node_profiles["Profile Parsing<br/>[LinkedInt.py]"]
end

subgraph group_enrichment["Email Enrichment"]
  node_hunter["Hunter Pattern Lookup<br/>[LinkedInt.py]"]
  node_email["Email Generation<br/>[LinkedInt.py]"]
  node_images["Profile Images<br/>[LinkedInt.py]"]
end

subgraph group_output["Report Output"]
  node_report["HTML Report<br/>[LinkedInt.py]"]
end

node_operator(("Operator"))
node_linkedin{{"LinkedIn"}}
node_hunter_api{{"Hunter.io"}}

node_operator -->|"runs and answers"| node_cli
node_credentials -->|"supplies credentials"| node_auth
node_cli -->|"provides search options"| node_search
node_auth -->|"authenticates with"| node_linkedin
node_search -->|"queries people"| node_linkedin
node_search -->|"parses results"| node_profiles
node_cli -->|"requests auto prefix"| node_hunter
node_hunter -->|"queries domain pattern"| node_hunter_api
node_profiles -->|"generates candidates"| node_email
node_profiles -->|"retrieves photos"| node_images
node_email -.->|"includes results"| node_report
node_images -->|"embeds images"| node_report

click node_credentials "https://github.com/vysecurity/linkedint/blob/master/LinkedInt.cfg"
click node_cli "https://github.com/vysecurity/linkedint/blob/master/LinkedInt.py"
click node_auth "https://github.com/vysecurity/linkedint/blob/master/LinkedInt.py"
click node_search "https://github.com/vysecurity/linkedint/blob/master/LinkedInt.py"
click node_profiles "https://github.com/vysecurity/linkedint/blob/master/LinkedInt.py"
click node_hunter "https://github.com/vysecurity/linkedint/blob/master/LinkedInt.py"
click node_email "https://github.com/vysecurity/linkedint/blob/master/LinkedInt.py"
click node_images "https://github.com/vysecurity/linkedint/blob/master/LinkedInt.py"
click node_report "https://github.com/vysecurity/linkedint/blob/master/LinkedInt.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_credentials,node_cli toneBlue
class node_auth,node_search,node_profiles toneAmber
class node_hunter,node_email,node_images toneMint
class node_report toneRose
class node_operator,node_linkedin,node_hunter_api toneIndigo
```

## Components

### Inputs and Configuration

- [Credentials](https://github.com/vysecurity/linkedint/blob/master/LinkedInt.cfg): `LinkedInt.cfg`
- [CLI Prompts](https://github.com/vysecurity/linkedint/blob/master/LinkedInt.py): `LinkedInt.py`

### LinkedIn Collection

- [LinkedIn Login](https://github.com/vysecurity/linkedint/blob/master/LinkedInt.py): `LinkedInt.py`
- [People Search](https://github.com/vysecurity/linkedint/blob/master/LinkedInt.py): `LinkedInt.py`
- [Profile Parsing](https://github.com/vysecurity/linkedint/blob/master/LinkedInt.py): `LinkedInt.py`

### Email Enrichment

- [Hunter Pattern Lookup](https://github.com/vysecurity/linkedint/blob/master/LinkedInt.py): `LinkedInt.py`
- [Email Generation](https://github.com/vysecurity/linkedint/blob/master/LinkedInt.py): `LinkedInt.py`
- [Profile Images](https://github.com/vysecurity/linkedint/blob/master/LinkedInt.py): `LinkedInt.py`

### Report Output

- [HTML Report](https://github.com/vysecurity/linkedint/blob/master/LinkedInt.py): `LinkedInt.py`

### Other components

- **Operator**
- **LinkedIn**
- **Hunter.io**

## Connections

- Operator → CLI Prompts: runs and answers (evidence: `README.md`)
- Credentials → LinkedIn Login: supplies credentials (evidence: `LinkedInt.py`)
- CLI Prompts → People Search: provides search options (evidence: `README.md`)
- LinkedIn Login → LinkedIn: authenticates with (evidence: `LinkedInt.py`)
- People Search → LinkedIn: queries people (evidence: `LinkedInt.py`)
- People Search → Profile Parsing: parses results (evidence: `LinkedInt.py`)
- CLI Prompts → Hunter Pattern Lookup: requests auto prefix (evidence: `README.md`)
- Hunter Pattern Lookup → Hunter.io: queries domain pattern (evidence: `LinkedInt.py`)
- Profile Parsing → Email Generation: generates candidates (evidence: `LinkedInt.py`)
- Profile Parsing → Profile Images: retrieves photos (evidence: `LinkedInt.py`)
- Email Generation → HTML Report: includes results (evidence: `LinkedInt.py`)
- Profile Images → HTML Report: embeds images (evidence: `README.md`)
