Instagram Followers Scraper

This project is an Instagram Followers Scraper built using Selenium and Python. It automates the process of logging into Instagram, visiting user profiles, and taking screenshots of their followers list. The script supports scraping multiple users and saves screenshots of followers and following lists into corresponding folders for each target user.

Features

• Automatic Instagram login: Saves and loads your Instagram credentials from a local credentials.txt file.
• Followers Scraper: Automates taking screenshots of a user's followers list and saves them to separate folders named after the target users.
• Headless browser option: The script is set up for headless scraping (though currently disabled).
• Custom screenshot count: Allows users to specify how many screenshots to take.

Requirements

• Python 3.6+
• Google Chrome browser installed

• The following Python packages:

  • selenium
  • webdriver-manager

Installation

1. Clone the repository:

   git clone https://github.com/darth-divyansh/Instagram_Followers-SS.git
   cd Instagram_Followers-SS
   

NOTE: It’s highly recommended to use a virtual environment for managing dependencies.

   python -m venv {your_virtual_environment_name}

Activate the virtual environment On Windows:

{your_virtual_environment_name}\Scripts\activate

On macOS/Linux:

source {your_virtual_environment_name}/bin/activate

After activation, you will see the environment name appear in your terminal, indicating that the environment is active.

2. Install dependencies:

   Install the required dependencies using pip:

   pip install -r requirements.txt

   The requirements.txt should include:

   python-decouple
   selenium==4.0.0
   webdriver_manager
   streamlit

3. Setup ChromeDriver:

   The script automatically installs the latest version of ChromeDriver using webdriver-manager. Ensure that you have Google Chrome installed.

4. Run the script:

   streamlit run app.py

Usage

1. Enter Instagram Credentials:

   • If running the script for the first time, you will be prompted to enter your Instagram username and password.

2. Specify Screenshot Count:

   • You will be asked to specify how many screenshots you'd like to take per user.

3. Enter Instagram Usernames:

   • Provide the usernames of the Instagram (Public) profiles other than the one you provided the credentials for you'd like to scrape, separated by commas.

Script Overview

• login(bot, username, password): Logs into Instagram using the provided credentials.
• scrape_followers(bot, username, user_input): Scrapes followers of the given Instagram user and takes screenshots.
• scrape(): Main function that loads credentials, logs into Instagram, and scrapes followers for all specified usernames.

Important Notes

• Instagram Rate Limits: Be mindful of Instagram's rate limits to avoid getting temporarily banned for suspicious activity.
• Login Issues: If Instagram changes its login flow, you might need to update the login-related XPath or CSS Selectors.
• Headless Mode: The script is currently not running in headless mode for debugging purposes. You can uncomment the options.add_argument("--headless") line in the scrape() function to enable it.

What is the NEED of this Code ?

During investigations, a tool that automatically captures and documents social media data—posts, messages, followers, and account info—could help generate detailed, error-free reports. This would streamline the process and allow examiners to print relevant screenshots as needed.

License

This project is licensed under the MIT License. See the LICENSE file for more details.

Disclaimer

This script is for educational purposes only. Use it responsibly and avoid violating Instagram's terms of service. The developer is not responsible for any misuse.