FS Automation Architecture

System Overview

Python outreach toolkit with optional FastAPI/app.py entry, Playwright browser automation, HTML frontend assets, and n8n workflow integration.

Architecture Diagram

graph TB
    ConfigEnv["config.py / .env<br/>cookies + settings"]
    FrontendUi["frontend.html / LeadGeneration-main"]
    N8nWorkflow["n8n_workflow.json"]
    AutomationApp["app.py + scripts<br/>search / connect / message"]
    PlaywrightBrowser["Playwright browser"]
    LinkedInSite["LinkedIn"]

    ConfigEnv -->|"loads credentials + settings"| AutomationApp
    FrontendUi -->|"UI triggers actions"| AutomationApp
    N8nWorkflow -->|"orchestrates automation"| AutomationApp
    AutomationApp -->|"drives browser"| PlaywrightBrowser
    PlaywrightBrowser -->|"login / search / outreach"| LinkedInSite

How to read this diagram

Arrows mean flow / dependency / "talks to", not button clicks. Each arrow label says what happens on that step.

Core Components

Module	Role
search_linkedin.py	Prospect discovery
send_connections.py	Connection requests
send_message.py / auto_reply.py	Messaging
check_replies.py / check_status.py	Status monitoring
login_linkedin.py / get_linkedin_cookie.py	Session helpers
fetch_ttb_data.py	Additional data fetch utility

Technology Stack

Layer	Technology
Language	Python
Browser automation	Playwright
Packaging	Docker
Orchestration	n8n

Next Steps

• API Reference
• Getting Started
• Overview