From 4ffdfbecc9d5d87323578fbf56edc09bcdf5954b Mon Sep 17 00:00:00 2001 From: WikkiE <70148919+Wikkiee@users.noreply.github.com> Date: Thu, 28 Dec 2023 13:34:43 +0530 Subject: [PATCH 1/3] Create README.md --- README.md | 110 ++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 110 insertions(+) create mode 100644 README.md diff --git a/README.md b/README.md new file mode 100644 index 0000000..78ed12c --- /dev/null +++ b/README.md @@ -0,0 +1,110 @@ +
+

+ +

+ + ![PyPI - Python Version](https://img.shields.io/pypi/pyversions/selenium) + ![License](https://img.shields.io/badge/License-MIT-blue.svg) + +
+LeadGenPy transforms lead generation by extracting Google Maps business details with Selenium, processing data, and dynamically generating personalized messages using the Chat GPT API. Seamlessly integrate with Google Sheets API for an efficient and impactful strategy. + +## Overview + +The Python script, `main.py`, controls the entire operation of LeadGenPy. It utilizes Selenium with a web driver to enter [Google Maps](https://maps.google.com), search for specific business types, and extract relevant information. + +LeadGenPy performs the following tasks: + +1. **Data Extraction:** + - Searches for a specific business type and location. + - Loops through search results, extracts business details, and stores data in CSV (`data.csv`) and JSON (`data.json`) files simultaneously. + - Data extracted includes: + ```json + { + "BusinessName": "Sample Business", + "Address": "123 Main Street, Cityville, State 12345", + "PhoneNumber": "123-456-7890", + "Website": "samplebusiness.com", + "Category": "General Business", + "Rating": "4.2", + "ReviewCount": "10", + "google_map_link": "https://www.google.com/maps/place/Sample+Business/data=...", + "email": "info@samplebusiness.com", + "status": "success" + } + + ``` +2. **User Interaction:** + - Offers options to the user: + - Terminate (`mode == 0`). + - Start extraction (`mode == 1`). + - View extracted dataset (`mode == 2`). + - Transfer data to Google Sheets (`mode == 3`). + - Generate personalized emails using Chat GPT (`mode == 4`). + - Production mode (combining extraction, data transfer, and email sending) (`mode == 5`). + - Development mode for sheet cleanup (`else`). + +3. **Authentication:** + - Prompts for Google sign-in if not authenticated (used for storing data in Google Sheets). + + + + + +## Getting Started + +Follow these steps to set up and run LeadGenPy locally: + +1. **Clone the Repository:** + ```bash + git clone https://github.com/your-username/LeadGenPy.git + ``` +2. **Install Dependencies:** + ```bash + pip install -r requirements.txt + ``` + **Dependencies:** + - `selenium==4.5.0` + - `python-dotenv==0.21.0` + - `beautifulsoup4==4.12.2` + - `requests==2.28.1` + - `google-auth-oauthlib==1.1.0` + - `google-auth-httplib2==0.1.0` + - `google-auth==2.15.0` + - `google-api-python-client==2.70.0` + - `google-api-core==2.11.0` + - `googleapis-common-protos==1.57.0` + - `openai==0.28.0` + - `lxml` + +3. **Environment Variables:** + - Create a `.env` file with the following content: + ``` + OPENAI_API_KEY="Your-OpenAI-API-KEY" + SPREADSHEET_ID="Your-Google-sheet-ID" + EMAIL_ADDRESS="Your-Email-Address" + ``` + - Sample +4. **Download ChromeDriver:** + - Download the appropriate version of [ChromeDriver](https://chromedriver.chromium.org/downloads) based on your Chrome browser version to avoid compatibility errors. + - Copy the Chromedriver.exe to the `assets\chromedriver.exe` folder + - To check your browser version, Open Chrome and enter this URL ``chrome://version`` + +5. **Run the Script:** + ```bash + cd src && python main.py + ``` +6. **Authenticate with Google (if prompted):** + - This is necessary for storing data in Google Sheets. +7. **Select the desired mode:** + - Choose the option that corresponds to your workflow. +### License +This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details. + +### Contributing +Feel free to contribute! Check out the [Contributing Guidelines](CONTRIBUTING.md) for more information. + +### Contact +- Discord: #wikkie +- LinkedIn: [Vignesh Mayilsamy](https://www.linkedin.com/in/vignesh-mayilsamy/) +- Email: wikkiedev@gmail.com From 57f0f9cc5f5948aa366fede14d125a01c3a5b183 Mon Sep 17 00:00:00 2001 From: WikkiE <70148919+Wikkiee@users.noreply.github.com> Date: Thu, 28 Dec 2023 13:36:22 +0530 Subject: [PATCH 2/3] Create LICENSE --- LICENSE | 21 +++++++++++++++++++++ 1 file changed, 21 insertions(+) create mode 100644 LICENSE diff --git a/LICENSE b/LICENSE new file mode 100644 index 0000000..687e2d8 --- /dev/null +++ b/LICENSE @@ -0,0 +1,21 @@ +MIT License + +Copyright (c) 2023 WikkiE + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. From 267f41400bb145f3a66b50c6fae7fd7a9c1d0b11 Mon Sep 17 00:00:00 2001 From: WikkiE <70148919+Wikkiee@users.noreply.github.com> Date: Thu, 28 Dec 2023 13:44:10 +0530 Subject: [PATCH 3/3] Update README.md --- README.md | 19 +++++++++++++++++++ 1 file changed, 19 insertions(+) diff --git a/README.md b/README.md index 78ed12c..622c974 100644 --- a/README.md +++ b/README.md @@ -46,7 +46,26 @@ LeadGenPy performs the following tasks: 3. **Authentication:** - Prompts for Google sign-in if not authenticated (used for storing data in Google Sheets). +4. **Select Extraction Mode (Mode 1):** + - Choose the extraction mode to search for a specific business type and location on Google Maps. + - Follow on-screen instructions to provide the business name and location. + - The script will loop through search results, extract business details, and store data in CSV (data.csv) and JSON (data.json) files. +5. **Lead Generation Using Chat GPT API (Mode 4):** + + - Choose the lead generation mode to generate personalized messages using the OpenAI Chat GPT API. + - The script will use the collected business data to create custom lead messages. +6. **Sending Emails (Mode 4):** + + - The script will use the generated messages to send personalized emails to the extracted email addresses. +7. **Additional Modes:** + + - Explore other modes for viewing the extracted dataset, transferring data to Google Sheets, and more. +8. **Production Mode (Mode 5):** + + - A combined mode that includes extraction, data transfer, and email sending for a streamlined workflow. +9. **Development Mode (Else):** + - Cleanup mode for sheet maintenance.