A local, safe, and efficient tool to automate LinkedIn connection requests.
PLEASE READ CAREFULLY BEFORE USE:
This software is developed strictly for educational purposes to demonstrate browser automation using Selenium and Python.
Caution
Use at your own risk. Automating actions on LinkedIn violates their User Agreement and Professional Community Policies.
Potential Risks Include:
- Temporary account restriction.
- Permanent account ban.
- Flagging of your IP address.
The authors of this repository are not responsible for any consequences resulting from the use of this tool. We strongly recommend:
- Do NOT send more than 20 requests per day.
- Do NOT run this on a server (AWS/Azure/GitHub Actions) - Always run locally.
- Monitor your account health regularly.
- 🛡️ Safe & Local: Runs on your own machine using your own IP, reducing detection risk compared to cloud bots.
- 🧠 Smart Automation:
- Filters by Company and Role.
- Automatically handles "Connect" buttons.
- Dismisses "Send with note" modals (sends without note).
- Auto-Dismisses "You are growing your network too fast" warnings.
- 💾 Persistent Login: Log in once manually; the bot saves your session locally so you don't have to log in again.
- 🎨 Modern UI: A clean, dark-mode Web Interface to control the bot easily.
-
Clone the repository:
git clone https://github.com/yourusername/linkedin-automation.git cd linkedin-automation -
Install dependencies:
pip install -r requirements.txt
-
Start the Application:
python app.py
-
Access the Dashboard: Open your browser and navigate to:
http://localhost:5000 -
Configure & Run:
- Enter your target Company (e.g.,
Google) and Role (e.g.,Software Engineer). - Set a safe Limit (Recommended: < 10 for testing).
- Click Start Automation.
- Enter your target Company (e.g.,
-
First Run:
- A Chrome window will open.
- Log in to LinkedIn manually.
- The bot will detect your login and proceed automatically.
linkedin-automation/
├── app.py # Flask Web Server entry point
├── bot/ # Core Automation Logic
│ ├── __init__.py
│ └── linkedin_bot.py # Selenium Bot Class
├── static/ # Frontend Assets
│ ├── style.css # Premium Dark Mode Styles
│ ├── script.js # UI Logic
│ └── logo.png # App Logo
├── templates/ # HTML Templates
│ └── index.html # Dashboard UI
├── requirements.txt # Python Dependencies
└── README.md # Documentation
- "Chrome not reachable": If the bot gets stuck or you see this error, click the yellow Force Reset button in the UI. This will forcibly close all Chrome instances and reset the driver.
- Login Loop: If the bot keeps asking you to login, ensure you are not using an Incognito window and that the
chrome_datafolder is being created.
This project is licensed under the MIT License - see the LICENSE file for details.