https://github.com/prateek-chaubey/saferweb
Safer Web is a comprehensive URL security checker that detects malicious URLs, phishing attempts, malware threats, captures website screenshots, expands shortened URLs, and provides proxified access to websites. Built with Express, Puppeteer, and Google Safe Browsing API
https://github.com/prateek-chaubey/saferweb
deceptive-site-detector malicious-site-detector malicious-url-detector malware-scanner phishing-detector privacy-tool proxy-url puppeteer reverse-proxy safer-web screenshot-api short-url short-url-expander url-checker url-expander url-safety web-proxy web-safety web-security
Last synced: 6 months ago
JSON representation
Safer Web is a comprehensive URL security checker that detects malicious URLs, phishing attempts, malware threats, captures website screenshots, expands shortened URLs, and provides proxified access to websites. Built with Express, Puppeteer, and Google Safe Browsing API
- Host: GitHub
- URL: https://github.com/prateek-chaubey/saferweb
- Owner: prateek-chaubey
- License: mit
- Created: 2025-11-21T13:10:59.000Z (6 months ago)
- Default Branch: main
- Last Pushed: 2025-11-22T08:55:52.000Z (6 months ago)
- Last Synced: 2025-11-22T09:17:31.637Z (6 months ago)
- Topics: deceptive-site-detector, malicious-site-detector, malicious-url-detector, malware-scanner, phishing-detector, privacy-tool, proxy-url, puppeteer, reverse-proxy, safer-web, screenshot-api, short-url, short-url-expander, url-checker, url-expander, url-safety, web-proxy, web-safety, web-security
- Language: HTML
- Homepage: https://prateek.is-a.dev/SaferWeb/
- Size: 1.91 MB
- Stars: 2
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
**Protect yourself online with real-time URL security analysis**
[](https://choosealicense.com/licenses/mit/)
[](https://nodejs.org/)
[](https://expressjs.com/)
[](https://pptr.dev/)
[Features](#features) • [Demo](#demo) • [Deployment](#deployment) • [API](#api-endpoints)
---
## Features
- **Malware Detection** - Identify malicious websites
- **Phishing Protection** - Detect deceptive sites
- **Threat Analysis** - Real-time security checks powered by Google Safe Browsing API
- **Website Screenshots** - Capture any website in real-time
- **URL Expansion** - Expand shortened links and track redirections
- **Redirection Detection** - Track and display URL redirects
- **Proxified Access** - Anonymous browsing through proxy
---
## Demo
Check out the live demo: **[https://prateek.is-a.dev/SaferWeb/](https://prateek.is-a.dev/SaferWeb/)**
### Screenshots
| Safe URL Detection | Malicious URL Warning |
|:------------------:|:---------------------:|
|  |  |
---
## Quick Start
### Prerequisites
Before you begin, ensure you have the following installed:
- **Node.js** (v20.0.0 or higher) - [Download](https://nodejs.org/)
- **npm** or **yarn** package manager
- **Google Safe Browsing API Key** - [Get API Key](https://developers.google.com/safe-browsing/v4/get-started)
---
## Local Installation
### Clone the Repository
```bash
git clone https://github.com/prateek-chaubey/SaferWeb.git
cd SaferWeb
```
### Install Dependencies
```bash
npm install
```
### Configure Environment Variables
Create a `.env` file in the root directory:
```env
SAFE_BROWSING_API_KEY=your_google_safe_browsing_api_key_here
PORT=3000
```
> [!NOTE]
> Visit [Google Safe Browsing API](https://developers.google.com/safe-browsing/v4/get-started) to obtain your free API key.
### Run the Application
**Development Mode (with auto-reload):**
```bash
npm run dev
```
**Production Mode:**
```bash
npm start
```
### Access the Application
Open your browser and navigate to:
```
http://localhost:3000
```
---
## Deployment
### Deploy to Render.com
[](https://render.com)
#### Step-by-Step Guide
**1. Create a Render Account**
- Visit [Render.com](https://render.com) and sign up
**2. Create a New Web Service**
- Click **"New +"** → **"Web Service"**
- Connect your GitHub repository
**3. Configure Build Settings**
| Setting | Value |
|---------|-------|
| **Name** | SaferWeb |
| **Environment** | Node |
| **Build Command** | `npm install` |
| **Start Command** | `npm start` |
| **Plan** | Free |
**4. Add Environment Variables**
Go to **Environment** tab and add:
```
SAFE_BROWSING_API_KEY = your_google_safe_browsing_api_key
```
**5. Deploy**
- Click **"Create Web Service"**
- Wait for deployment to complete (3-5 minutes)
- Your app will be live at `https://your-app-name.onrender.com`
---
## API Endpoints
### Safety Check
```http
GET /safety?url=https://example.com
```
**Response:**
```json
[
"https://example.com",
{
"matches": [
{
"threatType": "MALWARE",
"platformType": "ANY_PLATFORM",
"threat": {
"url": "https://example.com"
}
}
]
}
]
```
### Screenshot Capture
```http
GET /screenshot?page=https://example.com&fullpage=true
```
**Parameters:**
- `page` (required) - URL to capture
- `fullpage` (optional) - Capture full page (true/false)
**Response:** PNG image
### Proxified Access
```http
GET /proxy?url=https://example.com
```
**Response:** Proxified website content
---
## Technology Stack
| Technology | Purpose |
|------------|---------|
|  | Runtime Environment |
|  | Web Framework |
|  | Headless Browser |
|  | Threat Detection |
# Made with ❤️ for a Safer Internet