{"id":50493539,"url":"https://github.com/simo-hue/reviewvault","last_synced_at":"2026-06-02T05:01:16.156Z","repository":{"id":352478259,"uuid":"1215245991","full_name":"simo-hue/ReviewVault","owner":"simo-hue","description":"🛡️ A self-hosted, anti-bot web app to extract and backup Google Maps reviews to local JSON files in real-time.","archived":false,"fork":false,"pushed_at":"2026-04-19T19:47:28.000Z","size":469,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-19T20:30:03.569Z","etag":null,"topics":["anti-bot","automation","google-maps","json","nodejs","playwright","reviews","self-hosted","web-scraping","websocket"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/simo-hue.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-04-19T17:09:20.000Z","updated_at":"2026-04-19T19:47:32.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/simo-hue/ReviewVault","commit_stats":null,"previous_names":["simo-hue/reviewvault"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/simo-hue/ReviewVault","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/simo-hue%2FReviewVault","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/simo-hue%2FReviewVault/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/simo-hue%2FReviewVault/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/simo-hue%2FReviewVault/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/simo-hue","download_url":"https://codeload.github.com/simo-hue/ReviewVault/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/simo-hue%2FReviewVault/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33806987,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-02T02:00:07.132Z","response_time":109,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["anti-bot","automation","google-maps","json","nodejs","playwright","reviews","self-hosted","web-scraping","websocket"],"created_at":"2026-06-02T05:01:12.362Z","updated_at":"2026-06-02T05:01:16.113Z","avatar_url":"https://github.com/simo-hue.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🛡️ ReviewVault: Premium Google Maps Review Scraper\n\n![ReviewVault Screenshot](docs/images/app_screenshot.png)\n\n**ReviewVault** is a high-performance, self-hosted web application designed to extract and archive Google Maps reviews with surgical precision. Featuring a state-of-the-art \"Cyber Navy\" interface and built on a robust extraction engine, it transforms public review data into structured JSON files ready for analysis.\n\n---\n\n### 🔍 Real-Time Monitoring \u0026 Feedback\n\nReviewVault provides absolute transparency during the extraction process with a dedicated live feedback system:\n\n| **Terminal Logging System** | **Progress \u0026 Status Bar** |\n|:---:|:---:|\n| ![Logging System](docs/images/logging_system.png) | ![Status Bar](docs/images/status_bar.png) |\n| *Deep-level logs tracking every action* | *Visual progress and state indicators* |\n\n---\n\n### 💾 Data Export \u0026 Secure Archiving\n\nOnce the extraction is complete, ReviewVault notifies the user and provides a clean, professional download interface:\n\n| **Task Completion Notification** | **Secure Export (.json)** |\n|:---:|:---:|\n| ![Task Complete](docs/images/task_complete.png) | ![Download Button](docs/images/download_button.png) |\n| *Clear confirmation of data collection* | *Instant access to your digital vault* |\n\n---\n\n### 🔄 Dual-Mode Architecture: Extract \u0026 Read\n\nReviewVault is now a comprehensive review management system. Switch seamlessly between real-time data collection and offline analysis:\n\n| **Mode: Estrai (Live)** | **Mode: Leggi (Vault Reader)** |\n|:---:|:---:|\n| ![Mode Extract](docs/images/mode_extract.png) | ![Mode Read](docs/images/mode_read.png) |\n| *Scrape new reviews in real-time* | *Load and visualize your archived .json vaults* |\n\n---\n\n## 🚀 Key Features\n\n- **🌐 Smart URL Resolution**: Full support for shortened `maps.app.goo.gl` links and automatic redirection handling.\n- **⚡ Real-Time Streaming**: Watch the extraction process live through a terminal-style console powered by Socket.io.\n- **🎭 Stealth Extraction**: Built-in bot detection bypass using Playwright-extra and stealth plugins.\n- **🛡️ Graceful Interruption**: Manually close the browser window or stop the process at any time; ReviewVault will automatically flush and save all partial data collected.\n- **📊 Custom Depth**: Choose exactly how many reviews to extract—from a quick sample of 5 to a deep scan of thousands.\n- **💎 Premium UI**: Immersive desktop experience with glassmorphism effects, mesh gradients, and interactive components.\n- **📂 Automatic Archiving**: All data is saved in structured JSON format within the `data/` vault for easy consumption.\n\n---\n\n## 🛠️ Technology Stack\n\n- **Backend**: [Node.js](https://nodejs.org/) \u0026 [Express](https://expressjs.com/)\n- **Scraper Engine**: [Playwright](https://playwright.dev/) with `stealth` plugins\n- **Real-Time Communication**: [Socket.io](https://socket.io/)\n- **Frontend**: Vanilla JS (ES6+), CSS3 (Glassmorphism \u0026 Flexbox)\n- **Data Integrity**: [fs-extra](https://github.com/jprichardson/node-fs-extra) for robust file management\n\n---\n\n## 📥 Installation\n\n1. **Clone the repository**:\n   ```bash\n   git clone https://github.com/simo-hue/ReviewVault.git\n   cd ReviewVault\n   ```\n\n2. **Install dependencies**:\n   ```bash\n   npm install\n   ```\n\n3. **Install Playwright Browsers**:\n   ```bash\n   npx playwright install chromium\n   ```\n\n---\n\n## 🚥 Quick Start\n\n1. **Launch the Vault**:\n   ```bash\n   npm run dev\n   ```\n\n2. **Access the Interface**:\n   Open [http://localhost:3000](http://localhost:3000) in your professional workstation.\n\n3. **Choose your Target**:\n   Paste a Google Maps Business URL (e.g., [this demo activity](https://maps.app.goo.gl/U8NvpizqYnwUf1U9A)), select your extraction depth, and hit **Inizia Estrazione**.\n\n4. **Download your Data**:\n   Once finished, click the **Scarica Caveau (.json)** button to secure your results.\n\n---\n\n## 📸 Demo Case\n\nTry the scraper with this example activity:\n🔗 [**Demo Target: Google Maps Business**](https://maps.app.goo.gl/U8NvpizqYnwUf1U9A)\n\n---\n\n## 📂 Project Structure\n\n```text\n├── data/               # The Vault: JSON results storage\n├── public/             # Frontend assets (HTML, CSS, JS)\n│   ├── index.html      # Main Dashboard\n│   ├── style.css       # Premium Design System\n│   └── app.js          # WebSocket Client Logic\n├── scraper.js          # Core Playwright Extraction Engine\n├── server.js           # Node/Express \u0026 Socket.io Server\n└── package.json        # Dependencies \u0026 Scripts\n```\n\n---\n\n## 📜 License\n\nDistributed under the MIT License. See [LICENSE](LICENSE) for more information.\n\n---\n*Developed for excellence in data extraction. © 2026 ReviewVault.*\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsimo-hue%2Freviewvault","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsimo-hue%2Freviewvault","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsimo-hue%2Freviewvault/lists"}