# lordzohar/naukri-autoapply-bot architecture

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

- Interactive diagram: https://gitdiagram.com/lordzohar/naukri-autoapply-bot
- Repository: https://github.com/lordzohar/naukri-autoapply-bot

## Overview

This repository automates two Naukri job-application workflows: keyword-based search and applications in Edge, plus recommended-job applications with an interactive questionnaire. The Edge workflow logs in, searches keyword/location pages in parallel tabs, deduplicates listings, attempts applications, handles some inline fields, and records outcomes. The recommended-jobs script adds tab selection and reusable questionnaire answers. The map reflects README-documented flow and sampled source; unsampled implementation details and connections are omitted.

Main entry points: [`Naukri-Edge.py`](https://github.com/lordzohar/naukri-autoapply-bot/blob/main/Naukri-Edge.py) (Edge bot), [`Naukri-Recommended.py`](https://github.com/lordzohar/naukri-autoapply-bot/blob/main/Naukri-Recommended.py) (Recommended bot), [`application_answers.csv`](https://github.com/lordzohar/naukri-autoapply-bot/blob/main/application_answers.csv) (Answer history), [`naukriapplied.csv`](https://github.com/lordzohar/naukri-autoapply-bot/blob/main/naukriapplied.csv) (Application results)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_edge_search["Edge Job Search"]
  node_edge_bot["Edge bot<br/>[Naukri-Edge.py]"]
  node_edge_login["Naukri login<br/>[Naukri-Edge.py]"]
  node_parallel_search["Parallel search<br/>[Naukri-Edge.py]"]
  node_listing_collection["Listing collection<br/>[Naukri-Edge.py]"]
end

subgraph group_edge_apply["Edge Applications"]
  node_application_loop["Application loop<br/>[Naukri-Edge.py]"]
  node_apply_handler["Apply and form handling<br/>[Naukri-Edge.py]"]
end

subgraph group_recommended["Recommended Jobs"]
  node_recommended_bot["Recommended bot"]
  node_recommended_login["Recommended login"]
  node_recommended_tabs["Recommended tabs"]
  node_questionnaire["Questionnaire handling"]
end

subgraph group_state["Local Records"]
  node_answer_store[("Answer history")]
  node_results_store[("Application results<br/>[naukriapplied.csv]")]
end

node_job_seeker(("Job seeker"))
node_naukri_search{{"Naukri search pages"}}
node_naukri_jobs{{"Naukri job pages"}}
node_company_sites{{"Company career sites"}}

node_job_seeker -->|"starts"| node_edge_bot
node_edge_bot -->|"runs login"| node_edge_login
node_edge_login -->|"authenticates"| node_naukri_search
node_edge_bot -->|"builds searches"| node_parallel_search
node_parallel_search -->|"opens tabs"| node_naukri_search
node_parallel_search -->|"collects listings"| node_listing_collection
node_listing_collection -->|"reads listings"| node_naukri_search
node_edge_bot -->|"processes jobs"| node_application_loop
node_application_loop -->|"visits listings"| node_naukri_jobs
node_application_loop -->|"attempts apply"| node_apply_handler
node_apply_handler -->|"clicks apply"| node_naukri_jobs
node_apply_handler -.->|"may redirect"| node_company_sites
node_edge_bot -->|"saves outcomes"| node_results_store
node_job_seeker -->|"starts"| node_recommended_bot
node_recommended_bot -->|"logs in"| node_recommended_login
node_recommended_bot -->|"selects tabs"| node_recommended_tabs
node_recommended_tabs -->|"opens recommendations"| node_naukri_jobs
node_recommended_bot -->|"handles questions"| node_questionnaire
node_questionnaire -->|"loads and saves"| node_answer_store

click node_edge_bot "https://github.com/lordzohar/naukri-autoapply-bot/blob/main/Naukri-Edge.py"
click node_edge_login "https://github.com/lordzohar/naukri-autoapply-bot/blob/main/Naukri-Edge.py"
click node_parallel_search "https://github.com/lordzohar/naukri-autoapply-bot/blob/main/Naukri-Edge.py"
click node_listing_collection "https://github.com/lordzohar/naukri-autoapply-bot/blob/main/Naukri-Edge.py"
click node_application_loop "https://github.com/lordzohar/naukri-autoapply-bot/blob/main/Naukri-Edge.py"
click node_apply_handler "https://github.com/lordzohar/naukri-autoapply-bot/blob/main/Naukri-Edge.py"
click node_recommended_bot "https://github.com/lordzohar/naukri-autoapply-bot/blob/main/Naukri-Recommended.py"
click node_recommended_login "https://github.com/lordzohar/naukri-autoapply-bot/blob/main/Naukri-Recommended.py"
click node_recommended_tabs "https://github.com/lordzohar/naukri-autoapply-bot/blob/main/Naukri-Recommended.py"
click node_questionnaire "https://github.com/lordzohar/naukri-autoapply-bot/blob/main/Naukri-Recommended.py"
click node_answer_store "https://github.com/lordzohar/naukri-autoapply-bot/blob/main/application_answers.csv"
click node_results_store "https://github.com/lordzohar/naukri-autoapply-bot/blob/main/naukriapplied.csv"

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_edge_bot,node_edge_login,node_parallel_search,node_listing_collection toneBlue
class node_application_loop,node_apply_handler toneAmber
class node_recommended_bot,node_recommended_login,node_recommended_tabs,node_questionnaire toneMint
class node_answer_store,node_results_store toneRose
class node_job_seeker,node_naukri_search,node_naukri_jobs,node_company_sites toneIndigo
```

## Components

### Edge Job Search

- [Edge bot](https://github.com/lordzohar/naukri-autoapply-bot/blob/main/Naukri-Edge.py): `Naukri-Edge.py`
- [Naukri login](https://github.com/lordzohar/naukri-autoapply-bot/blob/main/Naukri-Edge.py): `Naukri-Edge.py`
- [Parallel search](https://github.com/lordzohar/naukri-autoapply-bot/blob/main/Naukri-Edge.py): `Naukri-Edge.py`
- [Listing collection](https://github.com/lordzohar/naukri-autoapply-bot/blob/main/Naukri-Edge.py): `Naukri-Edge.py`

### Edge Applications

- [Application loop](https://github.com/lordzohar/naukri-autoapply-bot/blob/main/Naukri-Edge.py): `Naukri-Edge.py`
- [Apply and form handling](https://github.com/lordzohar/naukri-autoapply-bot/blob/main/Naukri-Edge.py): `Naukri-Edge.py`

### Recommended Jobs

- [Recommended bot](https://github.com/lordzohar/naukri-autoapply-bot/blob/main/Naukri-Recommended.py): `Naukri-Recommended.py`
- [Recommended login](https://github.com/lordzohar/naukri-autoapply-bot/blob/main/Naukri-Recommended.py): `Naukri-Recommended.py`
- [Recommended tabs](https://github.com/lordzohar/naukri-autoapply-bot/blob/main/Naukri-Recommended.py): `Naukri-Recommended.py`
- [Questionnaire handling](https://github.com/lordzohar/naukri-autoapply-bot/blob/main/Naukri-Recommended.py): `Naukri-Recommended.py`

### Local Records

- [Answer history](https://github.com/lordzohar/naukri-autoapply-bot/blob/main/application_answers.csv): `application_answers.csv`
- [Application results](https://github.com/lordzohar/naukri-autoapply-bot/blob/main/naukriapplied.csv): `naukriapplied.csv`

### Other components

- **Job seeker**
- **Naukri search pages**
- **Naukri job pages**
- **Company career sites**

## Connections

- Job seeker → Edge bot: starts (evidence: `README.md`)
- Edge bot → Naukri login: runs login (evidence: `Naukri-Edge.py`)
- Naukri login → Naukri search pages: authenticates (evidence: `Naukri-Edge.py`)
- Edge bot → Parallel search: builds searches (evidence: `Naukri-Edge.py`)
- Parallel search → Naukri search pages: opens tabs (evidence: `Naukri-Edge.py`)
- Parallel search → Listing collection: collects listings (evidence: `Naukri-Edge.py`)
- Listing collection → Naukri search pages: reads listings (evidence: `Naukri-Edge.py`)
- Edge bot → Application loop: processes jobs (evidence: `Naukri-Edge.py`)
- Application loop → Naukri job pages: visits listings (evidence: `Naukri-Edge.py`)
- Application loop → Apply and form handling: attempts apply (evidence: `Naukri-Edge.py`)
- Apply and form handling → Naukri job pages: clicks apply (evidence: `Naukri-Edge.py`)
- Apply and form handling → Company career sites: may redirect (evidence: `README.md`)
- Edge bot → Application results: saves outcomes (evidence: `README.md`)
- Job seeker → Recommended bot: starts (evidence: `Naukri-Recommended.py`)
- Recommended bot → Recommended login: logs in (evidence: `Naukri-Recommended.py`)
- Recommended bot → Recommended tabs: selects tabs (evidence: `Naukri-Recommended.py`)
- Recommended tabs → Naukri job pages: opens recommendations (evidence: `Naukri-Recommended.py`)
- Recommended bot → Questionnaire handling: handles questions (evidence: `Naukri-Recommended.py`)
- Questionnaire handling → Answer history: loads and saves (evidence: `Naukri-Recommended.py`)
