Instagram Follower Bot
OOP Selenium Profile Discovery, Modal Handling & Lazy-Load Scroll Bot
Automates authenticated session login, modal dismissal, target account lookup, infinite follower modal scrolling, and throttled following.
An object-oriented social media follower bot built with Python and Selenium WebDriver. Encapsulates authentication, recurring post-login modal dismissal, target account search, JavaScript scrollIntoView lazy-loading inside the followers dialog, and rate-limited follow actions.
Modern social web apps render follower lists lazily inside nested scrollable dialogs gated by overlapping onboarding popups.
Demonstrates handling nested scrollable overlays, button state inspection to skip already-followed users, and pacing delays.
Engineering Objectives
System Architecture
OOP InstaFollower Selenium controller managing explicit waits, XPath discovery, and throttled interaction loops.
Lazy-Load Dialog Scrolling
Uses JavaScript scrollIntoView execution inside nested follower modals to load incremental user batches.
Core & Backend Implementation
- InstaFollower class with login(), find_followers(), and follow() workflow methods.
- State check follow_if_needed inspecting button labels prior to clicking.
Client & Interface Layer
- Nested modal DOM automation with rate-limit sleep throttling.
Data & Schema Design
Maintains authenticated cookies and visited button elements per automation run.
Authentication & Security Controls
- Credentials loaded exclusively from git-ignored .env files.
Engineering Challenges & Technical Decisions
Key Challenges Solved
Trade-Off Decisions
Testing & Verification Methodology
- Verified modal dismissal and incremental batch follow progression.