Free, transparent, open-source website security, privacy, tracker and phishing analysis, with continuous local browser protection.
See the site. See the risk. Keep your data on your device.
Overview β’ Features β’ Architecture β’ Tech Stack β’ Quick Start β’ Security Design β’ Testing β’ License
RevShield is an open-source platform that shows you how a website really behaves: how it secures your connection, what it tracks, which cookies it sets, where it redirects you, and whether the URL looks like phishing.
Paste any URL and get a clear, explained audit. Install the companion browser extension and get continuous protection that runs entirely on your device.
No account. No sign-up wall. No browsing history leaves your machine.
π‘ Philosophy: security and privacy tools should explain themselves. Every finding in RevShield comes with a reason, an impact rating, and a plain-language explanation.
| Capability | What you get | |
|---|---|---|
| π | Transport Security & TLS | Certificate chain validity, expiration, protocol version and cipher suites. |
| π§± | Security Header Audit | In-depth analysis of Content-Security-Policy, HSTS, X-Frame-Options, X-Content-Type-Options, Referrer-Policy and Permissions-Policy, with educational explanations and impact ratings. |
| Privacy & Trackers | Detects tracking scripts, advertising networks, session replay tools and canvas fingerprinting vectors. | |
| πͺ | Cookie & Storage Analysis | First-party vs. third-party classification and Secure / HttpOnly / SameSite compliance, without ever exposing cookie values. |
| π | Redirect Tracing | Multi-hop HTTP status tracking and protocol downgrade detection. |
| π€ | ML Phishing Detection | Interpretable lexical and structural classification with transparent, per-factor attribution. No black box. |
| π§© | Local Browser Extension | Manifest V3 extension that blocks trackers and ads using native DeclarativeNetRequest rules. Nothing is transmitted. |
| π | Free & Open | MIT licensed. No account required. |
flowchart TD
U([User enters a URL]) --> W[Web App<br/>React + TypeScript + Vite]
W --> A[API Gateway<br/>FastAPI]
A --> G{SSRF Guard<br/>scheme, DNS, IP checks}
G -- blocked --> X([Request rejected])
G -- allowed --> E[Analysis Engine]
E --> T[TLS & Certificates]
E --> H[Security Headers]
E --> P[Trackers & Cookies]
E --> R[Redirect Tracer]
E --> M[ML Phishing Classifier<br/>Scikit-Learn]
T --> S[(PostgreSQL)]
H --> S
P --> S
R --> S
M --> S
S --> W
EXT[Browser Extension<br/>Manifest V3] --> RE[Rule Engine<br/>DeclarativeNetRequest]
RE --> B([Local tracker & ad blocking])
RevShield/
βββ apps/
β βββ web/ # React + TypeScript + Vite + Tailwind CSS frontend
β βββ api/ # FastAPI + SQLAlchemy + Celery + Scikit-Learn backend
β βββ extension/ # Manifest V3 browser extension (DeclarativeNetRequest)
βββ packages/
β βββ shared-types/ # TypeScript interfaces shared by web and extension
β βββ shared-utils/ # URL normalization, risk tiering, entropy calculation
β βββ rule-engine/ # Tracker signatures and DeclarativeNetRequest rule compiler
βββ docker/ # Multi-container Docker Compose configuration
| Layer | Technology |
|---|---|
| Frontend | React, TypeScript, Vite, Tailwind CSS |
| Backend | FastAPI, SQLAlchemy, Celery |
| Machine Learning | Scikit-Learn |
| Data | PostgreSQL, Redis |
| Extension | Manifest V3, DeclarativeNetRequest |
| Tooling | npm workspaces, Docker Compose, pytest |
- Node.js 18+ and npm
- Python 3.10+
- (Optional) Docker and Docker Compose
cd apps/api
pip install -r requirements.txt
uvicorn app.main:app --reload --port 8000Interactive API docs: http://localhost:8000/docs
npm install
npm run dev:webWeb app: http://localhost:5173
npm run build:extensionLoad it in Chrome, Brave, Edge or Arc:
- Open
chrome://extensions - Enable Developer mode (top right)
- Click Load unpacked and select
apps/extension/dist
Launches PostgreSQL, Redis, the API and the web app:
docker-compose up --buildRevShield fetches arbitrary, user-supplied URLs, so the scanner itself is hardened against SSRF:
| Control | Behavior |
|---|---|
| Scheme allowlist | Only http:// and https:// are accepted. |
| DNS & IP validation | DNS is resolved before dispatch. IPv4/IPv6 loopback (127.0.0.0/8, ::1), private ranges (10.0.0.0/8, 172.16.0.0/12, 192.168.0.0/16), link-local and cloud metadata (169.254.169.254), multicast and internal hostnames are blocked. |
| Execution limits | 5 MB response cap, 8-second connect/read timeouts, maximum 5 redirects. |
- π Cookie values are never read or displayed, only their attributes.
- π The extension blocks locally and never transmits browsing history.
- π« No accounts, no tracking of the people using RevShield.
- π§ Phishing verdicts are explainable: every score lists the factors behind it.
cd apps/api
pytestContributions, bug reports and tracker-signature additions are welcome.
- Fork the repository
- Create a feature branch:
git checkout -b feature/your-feature - Commit your changes and run the tests
- Open a pull request describing what changed and why
RevShield is released under the MIT License.
Built to make the invisible parts of the web visible.