t0mer / safeurl

SafeUrl is a small and lite [FastAPI]( https://fastapi.tiangolo.com/) based web application intended to help us validate any URL safely before clicking it.

Please ⭐ this repo if you find it useful

SafeUrl

Safely check the URL befor clicking it.

With the growing amount of Spam, Fishing, and Malicious messages, I needed a tool that would help me safely check the URL before I clicked it. Correct, there are other options like VirusTotal, but I wanted something more, like getting a Preview of the final URL or even getting IP Information of the hosted service, So I combined them all into one lite and simple application.

Features

With SafeUrl, you can get the following information:

• Report Summary Using VirusTotal)
• Report Info.
• Site Preview
• Website Info:
  • Final URL.
  • Redirect Chain (If there are redirections).
  • Outgoing Links.
  • HTML Meta information.
  • Trackers (Google Tag, Analytics, Pixels, and more).
  • Ip Information Using IpInfo.

Limatations

• VirusTotal) free API is limited to 4 calls/minute.
• IpInfo free API is limited to 50,000 calls/moneh.

Usage

In order to start working with SafeUrl, you need to register for free [VirusTotal)] (https://www.virustotal.com/gui/home/url) account and get a valid Free API Key.

Now, add the VirusTotal API key to the docker environment and you are ready to go.

Run from hub

docker-compose from hub

version: "3.6"
services:
  safeurl:
    image: techblog/safeurl
    container_name: safeurl
    restart: always
    ports:
      - "8080:8080"
    environment:
      - VT_API_KEY=[Your VirusTotal API Key] #Required
      - IPINFO_API_KEY=[Your IPInfo API Key] #Optional

Checking URL

So now, after you installed SafeURL, It's time to give it a try. Navigate to you server address and you shuold see the following screen:

Enter the Requested URL and hit the "Check URL" button. The Scan process will start and then you will see the folllowing screen:

When the scan process will end, you will be able to see all the data collected during the scan process, Like Report summary:

Site preview:

And much much more.

safeurl's Issues

add SSL verification-validation