Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/lahcenezzara/whatsapp-scraping-python
WhatsApp Scraping Python
https://github.com/lahcenezzara/whatsapp-scraping-python
automation data python scraping selenium whatsapp
Last synced: about 1 month ago
JSON representation
WhatsApp Scraping Python
- Host: GitHub
- URL: https://github.com/lahcenezzara/whatsapp-scraping-python
- Owner: LahcenEzzara
- License: mit
- Created: 2024-07-10T00:00:32.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2024-07-17T12:39:07.000Z (4 months ago)
- Last Synced: 2024-10-14T05:40:43.322Z (about 1 month ago)
- Topics: automation, data, python, scraping, selenium, whatsapp
- Language: Python
- Homepage: https://lahcenezzara.github.io/whatsapp-scraping-python/
- Size: 15.6 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# WhatsApp Scraping Project
This project includes several Python scripts to scrape contacts and chat messages from WhatsApp Web using Selenium.
## Prerequisites
1. **Python**: Make sure you have Python 3.6 or higher installed.
2. **Google Chrome**: Ensure you have Google Chrome installed.
3. **ChromeDriver**: Download ChromeDriver from the official website:
[ChromeDriver](https://googlechromelabs.github.io/chrome-for-testing/#stable)
## Installation
1. **Clone the repository**:
```bash
git clone https://github.com/LahcenEzzara/WhatsApp-Scraping-Python.git
```
2. **Install the required packages**:
```bash
pip install -r requirements.txt
```
3. **Set up the ChromeDriver**:
- Download the ChromeDriver from the link [ChromeDriver](https://googlechromelabs.github.io/chrome-for-testing/#stable).
- Extract the downloaded file.
- Note the path where you extracted the `chromedriver` executable.
## Usage
### Scraping Contacts
1. **Script**: `contacts_scraper.py`
2. **Description**: Scrapes contact numbers from WhatsApp Web.
3. **Configuration**: Update the `chrome_user_data_dir` and `chrome_driver_path` variables in the script with your own paths.
4. **Run**:
```bash
py contacts_scraper.py
```
### Scraping a Single Chat
1. **Script**: `single_chat_scraper.py`
2. **Description**: Scrapes messages from a specific WhatsApp chat.
3. **Configuration**: Update the `chrome_user_data_dir` and `chrome_driver_path` variables in the script with your own paths. Edit the script to set the `chat_name` variable to the name of the chat you want to scrape.
4. **Run**:
```bash
py single_chat_scraper.py
```
### Scraping Multiple Chats from a CSV
1. **Script**: `csv_multi_chat_scraper.py`
2. **Description**: Scrapes messages from multiple WhatsApp chats listed in a CSV file.
3. **Configuration**: Update the `chrome_user_data_dir` and `chrome_driver_path` variables in the script with your own paths. Ensure you have a `contact_numbers.csv` file with chat names, one per line.
4. **Run**:
```bash
py csv_multi_chat_scraper.py
```
### Scraping Multiple Chats Specified in the Script
1. **Script**: `multi_chat_scraper.py`
2. **Description**: Scrapes messages from multiple WhatsApp chats specified in the script.
3. **Configuration**: Update the `chrome_user_data_dir` and `chrome_driver_path` variables in the script with your own paths. Edit the script to update the `chat_names` list with the names of the chats you want to scrape.
4. **Run**:
```bash
py multi_chat_scraper.py
```
## Notes
- Ensure that you have logged into WhatsApp Web on Chrome before running the scripts.
- The scripts will prompt you to scan the QR code if you are not logged in.
## License
This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.