URL Safety Scanner

A Go-based web service that provides URL safety analysis using multiple security APIs.

Features

• 🔍 URL extraction from text messages
• 🛡️ URL safety checking using Google Safe Browsing API
• 🌐 Additional scanning via URLScan.io
• ✨ Real-time URL classification
• 🚦 Safety status indicators
• 🔗 Safe link previews

Installation

# Clone the repository
git clone https://github.com/telex_integrations/safe_url_scanner.git

# Navigate to project directory
cd safe_url_scanner

# Install dependencies
go mod download

# Set up environment variables
cp .env

Environment Variables

URL_SCAN_KEY=your_urlscan_io_api_key
GOOGLE_SAFE_BROWSING_API_KEY=your_google_api_key
PORT=8080

API Endpoints

1. Scan URL
2. Integration Specification

GET /integration-spec

Usage Examples

Scan a URL

POST /scan-url
Content-Type: application/json

{
"message": "Check this link: https://example.com"
}

Response Format

{
  "event_name": "url_scanned",
  "message": "✅ URL Check: https://example.com\n→ Status: safe\n→ Recommendation: This link appears safe",
  "urls": ["https://example.com"],
  "status": "success",
  "username": "url-scanner-bot"
}

Security Features URL validation and sanitization Multiple API security checks Safe browsing verification Suspicious link warnings Hidden URLs for unsafe content

Testing

Run unit tests locally with the following command:

go test -v ./...

Deployment

• Build the application using:

  go build

• Run the server:

  go run main.go

• Deployment details:

  • GitHub Repository: https://github.com/telex_integrations/safe_url_scanner
  • Hosted JSON file: URL Scanner JSON
  • Deployed URL: Deployed Link

Telex Integration Details (Telex App)

1. Go to the App Section in the telex dashboard.
2. Add New Integration
3. Add Integration Spec URL.
4. Activate Integration

Usage in Telex

1. Go to any Channel
2. Type in a url link
3. URL gets scanned and response gets returned