\n# Google Map Reviews Web Scrabbler 🗺️
The Google Map Reviews Web Scrabbler is a specialized tool designed to extract Google Maps reviews to a .CSV file. 📜
Please note that this tool is configured to perform a specific task and may not be suitable for customizing to your
specific requirements. ⚙️
## Installation & Usage Instructions 🚀
To use this tool, you'll need to set up the necessary components. Here are the installation steps:
1. **Web/Chrome Driver 🌐**: This tool utilizes Selenium, which requires a web driver to interact with your chosen web
browser. Web drivers serve as intermediaries between Selenium and the browser, facilitating communication through a
common wire protocol. To get started, follow these steps:
- Download the Chrome Driver from [here](https://chromedriver.chromium.org/home).
- Once downloaded, copy or cut the driver file from your downloads folder.
- Paste the driver file into your C drive, typically located at `C:\chromedriver_win32\chromedriver.exe`. Please
ensure you follow this path to avoid any path-related errors. 🚗
2. **Pip installation 🐍**: Ensure you have installed the package by running the following command:
```bash
python -m pip install gmap_scrabbler
```
3. **Usage**: Run the following command in the CLI window and provide necessary arguments:
```
python -m gmap_scrabbler
```
4. **Arguments⚙️**: You will be prompted to enter the following information:
- **url**: The URL of the Google Maps reviews page you want to scrape.
- **export_path**: The path where the extracted reviews will be saved as a CSV file. The specified folder should already
exist. You can customize the export path, but if none is provided, the default path is set to "D:/".
- **lang**: The browser locale for viewing the Google Maps page. By default, it is set to "en" (English), but you can
specify other supported locales like "es" (Spanish). You will be prompted to enter this value.
- **review_limit**: The maximum number of reviews you want to extract. You can specify the limit, but if none is
provided, the default limit is set to 1000. You will be prompted to enter this value.
5. **Output 📦**:
The script will initiate a web browser, load the Google Maps reviews page, scroll through the reviews, and extract the
specified number of reviews.
Once the extraction is complete, the reviews will be saved to a CSV file in the specified export path. 📂
Please keep in mind that this tool is intended for a specific purpose, and customization beyond its predefined
functionality may require additional development efforts. 🔧👨💻
## Technologies and Libraries Used 🛠️
- Python 3.7+
- Typer
- Selenium
- Pandas
- Published to PyPi using GitHub actions and Twine 📦🔗
Raw data
{
"_id": null,
"home_page": "https://github.com/freezerain/gMaps_selenium_scrabbler",
"name": "gmap-scrabbler",
"maintainer": "",
"docs_url": null,
"requires_python": "",
"maintainer_email": "",
"keywords": "pypi,cicd,python",
"author": "Ilia Rodikov",
"author_email": "rain-ilia@rambler.ru",
"download_url": "https://files.pythonhosted.org/packages/a1/6f/e0c60d98d8fac5409ab0788975eee5ffd6541274c6704df3d6bae876b185/gmap_scrabbler-0.2.2.tar.gz",
"platform": null,
"description": "\\n# Google Map Reviews Web Scrabbler \ud83d\uddfa\ufe0f\n\nThe Google Map Reviews Web Scrabbler is a specialized tool designed to extract Google Maps reviews to a .CSV file. \ud83d\udcdc\n\nPlease note that this tool is configured to perform a specific task and may not be suitable for customizing to your\nspecific requirements. \u2699\ufe0f\n\n## Installation & Usage Instructions \ud83d\ude80\n\nTo use this tool, you'll need to set up the necessary components. Here are the installation steps:\n\n1. **Web/Chrome Driver \ud83c\udf10**: This tool utilizes Selenium, which requires a web driver to interact with your chosen web\n browser. Web drivers serve as intermediaries between Selenium and the browser, facilitating communication through a\n common wire protocol. To get started, follow these steps:\n\n - Download the Chrome Driver from [here](https://chromedriver.chromium.org/home).\n - Once downloaded, copy or cut the driver file from your downloads folder.\n - Paste the driver file into your C drive, typically located at `C:\\chromedriver_win32\\chromedriver.exe`. Please\n ensure you follow this path to avoid any path-related errors. \ud83d\ude97\n\n2. **Pip installation \ud83d\udc0d**: Ensure you have installed the package by running the following command:\n\n ```bash\n python -m pip install gmap_scrabbler\n ```\n\n3. **Usage**: Run the following command in the CLI window and provide necessary arguments:\n ```\n python -m gmap_scrabbler\n ```\n4. **Arguments\u2699\ufe0f**: You will be prompted to enter the following information:\n\n- **url**: The URL of the Google Maps reviews page you want to scrape.\n- **export_path**: The path where the extracted reviews will be saved as a CSV file. The specified folder should already\n exist. You can customize the export path, but if none is provided, the default path is set to \"D:/\".\n- **lang**: The browser locale for viewing the Google Maps page. By default, it is set to \"en\" (English), but you can\n specify other supported locales like \"es\" (Spanish). You will be prompted to enter this value.\n- **review_limit**: The maximum number of reviews you want to extract. You can specify the limit, but if none is\n provided, the default limit is set to 1000. You will be prompted to enter this value.\n\n5. **Output \ud83d\udce6**:\n\n The script will initiate a web browser, load the Google Maps reviews page, scroll through the reviews, and extract the\n specified number of reviews.\n Once the extraction is complete, the reviews will be saved to a CSV file in the specified export path. \ud83d\udcc2\n \n Please keep in mind that this tool is intended for a specific purpose, and customization beyond its predefined\n functionality may require additional development efforts. \ud83d\udd27\ud83d\udc68\u200d\ud83d\udcbb\n\n## Technologies and Libraries Used \ud83d\udee0\ufe0f\n\n- Python 3.7+\n- Typer\n- Selenium\n- Pandas\n- Published to PyPi using GitHub actions and Twine \ud83d\udce6\ud83d\udd17\n",
"bugtrack_url": null,
"license": "",
"summary": "The Google Map Reviews Web Scrabbler is a specialized tool designed to extract Google Maps reviews to a .CSV file.",
"version": "0.2.2",
"project_urls": {
"Homepage": "https://github.com/freezerain/gMaps_selenium_scrabbler"
},
"split_keywords": [
"pypi",
"cicd",
"python"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "8ffb28bc0a6a49d84070bc3a0084c96e4e78ecb5550af2d265dc42053567bd1d",
"md5": "2ab58e24f0a25a23d103aa7879d57158",
"sha256": "200dac042d48817227d0e2f6810f14ac9d4a4c48e126161ee65b84376a00b017"
},
"downloads": -1,
"filename": "gmap_scrabbler-0.2.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "2ab58e24f0a25a23d103aa7879d57158",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 7208,
"upload_time": "2023-11-08T16:37:52",
"upload_time_iso_8601": "2023-11-08T16:37:52.990218Z",
"url": "https://files.pythonhosted.org/packages/8f/fb/28bc0a6a49d84070bc3a0084c96e4e78ecb5550af2d265dc42053567bd1d/gmap_scrabbler-0.2.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "a16fe0c60d98d8fac5409ab0788975eee5ffd6541274c6704df3d6bae876b185",
"md5": "06a5b5277d394bd9a31d7d63e22b096d",
"sha256": "c8f917a60f18805273d95f3f23466315707b5d00ba1e880807b3f32061aa1fc3"
},
"downloads": -1,
"filename": "gmap_scrabbler-0.2.2.tar.gz",
"has_sig": false,
"md5_digest": "06a5b5277d394bd9a31d7d63e22b096d",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 5788,
"upload_time": "2023-11-08T16:37:54",
"upload_time_iso_8601": "2023-11-08T16:37:54.639108Z",
"url": "https://files.pythonhosted.org/packages/a1/6f/e0c60d98d8fac5409ab0788975eee5ffd6541274c6704df3d6bae876b185/gmap_scrabbler-0.2.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-11-08 16:37:54",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "freezerain",
"github_project": "gMaps_selenium_scrabbler",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [],
"lcname": "gmap-scrabbler"
}
JSON
