Skip to content

Latest commit

 

History

19 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🔗 links_scanner

Quick URL / Link Scanner (Bash)

A lightweight and powerful Bash utility for analyzing URLs and domains. It performs local security checks such as DNS resolution, SSL certificate inspection, WHOIS lookups, and HTTP status verification, while also supporting optional online reputation checks through Google Safe Browsing and VirusTotal APIs.


📸 Screenshots

🖥️ Desktop Version

Desktop Version


📱 Mobile Version

Mobile Version

🔒 Safe to Publish

✅ The script is safe to upload publicly.

It only contains placeholder variables for API keys and does not include any sensitive information or credentials.

Important: Never commit real API keys to GitHub.


⚙️ What This Script Does

Local Analysis

  • Resolves domains and retrieves IP addresses (dig or host)
  • Extracts SSL certificate information (openssl)
  • Performs WHOIS lookups
  • Retrieves:
    • Registrar
    • Country
    • Creation date
    • Expiration date
  • Checks website availability and HTTP status codes (curl)

Online Reputation Checks (Optional)

  • Google Safe Browsing v4

    • Detects phishing sites
    • Detects malware-hosting domains
  • VirusTotal v3

    • URL reputation analysis
    • Multi-engine threat detection results

📦 Requirements

Operating System

  • Linux
  • macOS

Required Tools

curl
jq
whois
dig    # or host
openssl
grep
sed
awk

API Keys

Online reputation checks are optional — if no keys are set, those steps simply report no results. To enable them:

  1. Get a Google Safe Browsing API key from Google Cloud Console
  2. Get a VirusTotal API key from virustotal.com
  3. Open links_scanne.sh and replace the two placeholder values at the top of the file:
GOOGLE_API_KEY="YOUR_GOOGLE_API_KEY_HERE"
VIRUSTOTAL_API_KEY="YOUR_VIRUSTOTAL_API_KEY_HERE"

Important: Never commit real API keys to GitHub.


🧩 Install Dependencies

Debian / Ubuntu

sudo apt update
sudo apt install -y curl jq dnsutils whois openssl

Arch Linux

sudo pacman -S curl jq bind whois openssl

macOS (Homebrew)

brew install curl jq whois openssl

🚀 Usage

chmod +x links_scanne.sh
./links_scanne.sh

Enter a URL or domain when prompted.

Example:

https://example.com

✨ Features

  • 🌐 DNS Resolution
  • 🔒 SSL Certificate Inspection
  • 📜 WHOIS Information
  • 🚦 HTTP Status Checking
  • 🛡️ Google Safe Browsing Integration
  • 🔍 VirusTotal Integration
  • ⚡ Fast and Lightweight
  • 📦 Pure Bash Implementation

🛠️ Built With

  • Bash
  • curl
  • jq
  • openssl
  • dig / host
  • whois
  • Google Safe Browsing API
  • VirusTotal API

📄 License

This project is released under the MIT License.


Made with ❤️ by linuxcoding-ADAM

About

Bash utility for analyzing URLs and domains: DNS, SSL, WHOIS, HTTP status, plus optional Google Safe Browsing and VirusTotal reputation checks.

Topics

Resources

Stars

3 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages