# machinekillin/ciper architecture

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

- Interactive diagram: https://gitdiagram.com/machinekillin/ciper
- Repository: https://github.com/machinekillin/ciper

## Overview

##### Project type and purpose
- Ciper is an open-source, single-file Python CLI tool that automates Google “dork” queries, scrapes results, and bypasses reCAPTCHAs via Selenium.
- It is not a multi-service system but a monolithic script with clear stages.

##### File structure
- ciper.py: the sole entrypoint containing all logic (parsing, crawling, captcha solving, logging).
- requirements.txt: lists dependencies (e.g., selenium, a CAPTCHA-solving client).
- README.md: describes features, prerequisites (Python, Chrome), and usage.

##### Insights from the README
- Relies on Chrome + Selenium WebDriver to drive searches
- Uses an external CAPTCHA-solving service for reCAPTCHA
- Provides console UI (CUI) and log file output
- Runs queries sequentially with rate control to avoid bans

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Main Pipeline
    subgraph "Ciper CLI Tool"
        direction TB
        CLI["CLI Interface"]:::internal
        Parser["Dork Parser"]:::internal
        Scraper["Web Scraper"]:::internal
        Solver["CAPTCHA Solver"]:::internal
        Extractor["Result Extractor"]:::internal
        Logger["Logger / Output"]:::internal
    end

    %% External Services
    Google["Google Search"]:::external
    CAPAPI["CAPTCHA-solving API"]:::external

    %% Storage
    LogFile["Local Log File"]:::storage

    %% Documentation
    README["README.md"]:::docs
    Req["requirements.txt"]:::docs

    %% User Interaction
    User["User"]:::external

    %% Data Flows
    User -->|"start"| CLI
    CLI -->|"parse dorks"| Parser
    Parser -->|"queries"| Scraper
    Scraper -->|"HTTP GET"| Google
    Scraper -->|"solve captcha"| Solver
    Solver -->|"API request"| CAPAPI
    CAPAPI -->|"token"| Solver
    Solver -->|"captcha token"| Scraper
    Scraper -->|"raw results"| Extractor
    Extractor -->|"structured data"| Logger
    Logger -->|"write logs"| LogFile
    Logger -->|"console output"| User

    %% Click Events
    click CLI "https://github.com/machinekillin/ciper/blob/main/ciper.py"
    click Parser "https://github.com/machinekillin/ciper/blob/main/ciper.py"
    click Scraper "https://github.com/machinekillin/ciper/blob/main/ciper.py"
    click Solver "https://github.com/machinekillin/ciper/blob/main/ciper.py"
    click Extractor "https://github.com/machinekillin/ciper/blob/main/ciper.py"
    click Logger "https://github.com/machinekillin/ciper/blob/main/ciper.py"
    click README "https://github.com/machinekillin/ciper/blob/main/README.md"
    click Req "https://github.com/machinekillin/ciper/blob/main/requirements.txt"

    %% Styles
    classDef internal fill:#B3C7E6,stroke:#000,stroke-width:1px
    classDef external fill:#C7E6B3,stroke:#000,stroke-width:1px
    classDef storage fill:#F2C38F,stroke:#000,stroke-width:1px
    classDef docs fill:#D3D3D3,stroke:#000,stroke-width:1px
```
