emails-google-search

byHello Mcdonald

design a working application extractor that search for emails through google search links online and extract over 5million emails

LandingLoginResultsExtraction RunsSign UpRun Progress
Landing

Comments (0)

No comments yet. Be the first!

Architecture

emails-google-search Service Networkv23
External Services
redis : Run progress cache
database : MariaDB
Service Clients
backend : FastAPI
frontend : React UI
Client
overlay progress
BackgroundTasks
yield/density series
Google Custom Search
JSON API
Target Websites
source_url pages
Redis
extraction:progress:*
MariaDB
users, admins,
extraction_runs, extracted_emails
GoogleSearchClient
Custom Search JSON API
email_extractor
regex scrape of result pages
FastAPI Server
Auth Routes
register / login
Health Route
DB + Redis connectivity check
Runs Routes
POST /api/runs
POST /api/runs/:id/start
GET /api/runs
GET /api/runs/:id
GET /api/runs/:id/progress
GET /api/runs/:id/emails
Extraction Engine
run_extraction background task
query-variation search cycles
run_progress
build_progress_series
yield/density aggregation
React App
AppRoutes
Login / SignUp pages
AuthContext + authService
ExtractionRuns / RunProgress / Results pages
static mock data, not yet wired to backend
Operator Browser
Live
Landing design preview
Landing: Read sourcing and target
Sign Up: Open enrollment form
Sign Up: 1. Submit enrollment
Sign Up: 2. Correct invalid credentials
Extraction Runs: Configure new run
Extraction Runs: 1. Launch run
Extraction Runs: 2. Correct invalid configuration
Extraction Runs: Open run progress
Run Progress: 1. Observe live harvested counter
Run Progress: 2. Review yield sparkline
Run Progress: 3. Retry progress fetch
Run Progress: Continue to results
Results: 1. Browse extracted emails
Results: 2. Review total against target
Results: 3. Retry results fetch
Login: Open returning verification
Login: 1. Submit credentials
Login: 2. Retry credentials
Extraction Runs: Review durable runs
Results: 4. Select completed run
Results: 5. Reselect another run
Live
Landing design preview
Landing: Read sourcing and target
Sign Up: Open enrollment form
Sign Up: 1. Submit enrollment
Sign Up: 2. Correct invalid credentials
Extraction Runs: Configure new run
Extraction Runs: 1. Launch run
Extraction Runs: 2. Correct invalid configuration
Extraction Runs: Open run progress
Run Progress: 1. Observe live harvested counter
Run Progress: 2. Review yield sparkline
Run Progress: 3. Retry progress fetch
Run Progress: Continue to results
Results: 1. Browse extracted emails
Results: 2. Review total against target
Results: 3. Retry results fetch
Login: Open returning verification
Login: 1. Submit credentials
Login: 2. Retry credentials
Extraction Runs: Review durable runs
Results: 4. Select completed run
Results: 5. Reselect another run