Guestbook Extractor Pro 📑

Guestbook Extractor Pro is a specialized Chrome Extension designed to automate the extraction of contact information and messages from guestbook pages and web directories. It transforms unstructured web data into organized Excel spreadsheets, significantly accelerating lead generation and data collection workflows.

🚀 Key Features

• Deep DOM Extraction: Intelligently scans webpage structures to identify names, email addresses, website URLs, and message content.

• One-Click Export: Instantly converts extracted data into professional .xlsx files using a built-in Excel engine.

• Clean Data Formatting: Automatically strips HTML noise and whitespace to ensure the exported data is ready for CRM or outreach use.

• Live Counter: Displays a real-time count of identified entries directly on the extension UI.

• Safety & Privacy: Operates entirely within the browser's sandbox. No data is sent to external servers, ensuring total privacy for your lead lists.

• Status Notifications: Integrated toast system to provide feedback on extraction progress and successful downloads.

🛠️ Technical Stack

• Core Logic: Vanilla JavaScript (Content Scripts) for direct DOM manipulation and data scraping.

• UI Framework: HTML5 and CSS3 with a clean, compact popup interface.

• Extension Architecture: Manifest V3, utilizing background service workers and content scripts for tab communication.

• Utilities:

  • SheetJS (XLSX): A powerful local utility for generating Excel files on the fly.

  • Chrome Storage API: For maintaining state and configuration across sessions.

📁 Project Structure

Plaintext

├── manifest.json      # Extension permissions and background config
├── popup.html         # The extension's interactive menu
├── popup.js           # Logic for the popup UI and trigger events
├── content.js         # The "Brain" – performs the actual web scraping
├── style.css          # Styling for the popup and injected UI elements
└── xlsx.full.min.js   # Local library for Excel generation

⚙️ Installation

1. Download/Clone this repository to your local machine.

2. Open Google Chrome and navigate to chrome://extensions/.

3. Enable Developer mode (toggle in the top right).

4. Click Load unpacked and select the project folder.

5. Pin the Guestbook Extractor to your toolbar for easy access.

📖 How to Use

1. Navigate to a guestbook page or a list of entries you wish to extract.

2. Open the extension popup and click "Extract Entries".

3. The extension will highlight or count the found data points.

4. Click "Download Excel" to save the structured data to your computer.

---

Developed by Shakeeb to simplify complex data entry tasks.