Skills

Urlscan

Submit URLs for automated malware and phishing analysis, then retrieve safety verdicts...

Install

npx skills add taracodlabs/aiden --skill urlscan -g -a claude-code -y
Repository
taracodlabs/aiden868
Category
Security
Updated
16d ago
License
Apache-2.0
Context cost
Lightabout 940 tokens
Runs scripts
Yes, review before use

What it does

Submit URLs for automated malware and phishing analysis, then retrieve safety verdicts and screenshots via urlscan.io

URL Safety Scanner (urlscan.io)

Submit any URL for analysis and receive a safety verdict, screenshot, and DNS/HTTP metadata. Uses the urlscan.io API.

Requires: Free URLSCAN_API_KEY, sign up at urlscan.io, no credit card needed.

When to Use

  • User receives a suspicious link and wants to check it safely
  • User wants to verify if a URL is phishing or malware
  • User asks "is this link safe?" or "scan this URL for threats"
  • Security review of links before sharing them
  • OSINT: see what a URL looks like without visiting it yourself

How to Use

Submit a URL for scanning

$url    = "https://suspicious-site.example.com"
$key    = $env:URLSCAN_API_KEY
$body   = '{"url": "' + $url + '", "visibility": "unlisted"}'

$submit = Invoke-RestMethod -Uri "https://urlscan.io/api/v1/scan/" `
    -Method POST `
    -Headers @{ "API-Key" = $key; "Content-Type" = "application/json" } `
    -Body $body

Write-Host "Scan submitted!"
Write-Host "UUID:    $($submit.uuid)"
Write-Host "Results: $($submit.result)"
Write-Host "Waiting 30 seconds for scan to complete..."
Start-Sleep -Seconds 30

Retrieve scan results after waiting

$uuid   = "PASTE-UUID-FROM-SUBMIT-STEP"
$key    = $env:URLSCAN_API_KEY

$result = Invoke-RestMethod -Uri "https://urlscan.io/api/v1/result/$uuid/" `
    -Headers @{ "API-Key" = $key }

Write-Host "Final URL:   $($result.page.url)"
Write-Host "IP:          $($result.page.ip)"
Write-Host "Country:     $($result.page.country)"
Write-Host "Malicious:   $($result.verdicts.overall.malicious)"
Write-Host "Phishing:    $($result.verdicts.overall.phishing)"
Write-Host "Score:       $($result.verdicts.overall.score)"
Write-Host "Screenshot:  https://urlscan.io/screenshots/$uuid.png"

One-shot: submit and wait for result

function Scan-Url {
    param([string]$TargetUrl, [string]$ApiKey = $env:URLSCAN_API_KEY)
Read the whole SKILL.md on GitHub

More in Security