Eyewear Retailer Store Locator Webscraper and Aggregator

Project Overview

This project involves scraping retailer store locator data using REST APIs and BeautifulSoup.

In this case, the primary goal was to extract name and address pairs from various eyewear retailers and merge them into a consolidated dataset, ensuring accuracy and consistency in address formatting.

Since names and addresses can be entered into system databases with slightly differing formats from firm to firm (ie. "DR SMITH, 1001 Parkway East, Binghamton, NY 13905" versus "Dr. Smith, 1001 Pkwy E., Binghamton, NY 13905") this introduces a high likelihood of multi-counting any given true name, address pair.

To mitigate this issue, I use Fuzzy string-matching techniques to account for subtle differences in names and addresses and aggregate pairs using a moderate assumption of these differences across firm entries.

Directory Structure

.
├── .idea                   # IDE-specific configurations
├── data                    # Raw data from scraping
├── final_data              # Processed data ready for merging
├── merged_data             # Final merged dataset
├── scrapers                # Scripts for scraping store locators
├── utils                   # Utility scripts for data processing
├── README.md               # Project documentation
└── requirements.txt        # Python dependencies

Key Features

• Data Scraping: Tailored scripts for scraping store locator data using API requests and HTML parsing.
• Data Processing: Standardization and preprocessing scripts to ensure data consistency.
• Data Merging: Fuzzy string matching (Levenshtein distance) to merge datasets with consistent address formats.

Getting Started

To set up and run this project locally, follow these steps:

1. Clone the repository:

git clone https://github.com/yourusername/your-repository-name.git

2. Navigate to the project:

cd eyewear-retailer-scraper-aggregator

3. Install requirements:

pip install -r requirements.txt

Usage

1. Run the scrapers:

python scrapers/<script_name>.py

2. Data Processing:

python utils/<script_name>.py

License

This project is licensed under the MIT License - see the LICENSE.md file for details.