SkillAgentSearch skills...

urlscan

Submit URLs to urlscan.io — safety verdict + screenshot retrieval

Install / Use

npx skills add taracodlabs/aiden --skill urlscan

Installs into whichever agent you are using.

About this skill
📄

SKILL.md

Installable skill definition

Quality Score

83/100

Category

Security

Supported Platforms

Universal

Our assessment of urlscan

urlscan scores 83/100 on our quality scale, 924th of 1,096 Security skills we index.

Its SKILL.md is 3.9 KB long, well organised into 9 sections with 3 code examples: a solid amount of guidance for an agent.

It has 843 GitHub stars, a meaningful sign that others use it.

Substance
26/30
Structure
18/20
Description
12/15
Adoption
12/20
Freshness
15/15

Maintenance, license and trust

  • The repository was last updated about 2 months ago, so urlscan is actively maintained.
  • Our last check on 2026-11-07 found the source still online.
  • It is released under AGPL-3.0, a copyleft license: you can use it, but modified versions you distribute must carry the same license.
  • Its trust signals score 100/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.

Safety scan

No issues found

Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.

AI review by kimi-k2.7-code on 2026-10-06. Automated pattern scan on 2026-10-06. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.

urlscan compared with similar skills

All 4 of these similar skills score higher than urlscan; compare them before choosing.

SkillScoreStarsUpdatedFormat
urlscan (this skill)by taracodlabs838432mo agoSKILL.md
Agent-Reachby Panniantong100112.7k9d agoCLAUDE.md
headroomby headroomlabs-ai10079.9ktodayCLAUDE.md
Scraplingby D4Vinci100103.9ktodayMCP Server
crawl4aiby unclecode10087.5ktodayMCP Server

Frequently asked questions

How do I install urlscan?
Run npx skills add taracodlabs/aiden --skill urlscan. The install tabs above show the steps for each supported agent.
Which AI agents does urlscan work with?
It is written for Universal, as a SKILL.md file. Other agents that read the same format can often use it too.
Is urlscan safe to use?
Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is AGPL-3.0-licensed and scores 100/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
Is urlscan still maintained?
The repository was last updated about 2 months ago, so urlscan is actively maintained.

name: urlscan description: Submit URLs to urlscan.io — safety verdict + screenshot retrieval category: security version: 1.0.0 license: Apache-2.0 origin: aiden tags: security, malware, phishing, url, scan, osint, urlscan, threat-intel env_required:

  • URLSCAN_API_KEY

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)

    $body   = '{"url": "' + $TargetUrl + '", "visibility": "unlisted"}'
    $submit = Invoke-RestMethod -Uri "https://urlscan.io/api/v1/scan/" `
        -Method POST -Headers @{ "API-Key" = $ApiKey; "Content-Type" = "application/json" } `
        -Body $body
    $uuid = $submit.uuid

    Write-Host "Scanning $TargetUrl (uuid: $uuid)..."
    Start-Sleep -Seconds 30

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

    [PSCustomObject]@{
        URL       = $result.page.url
        IP        = $result.page.ip
        Malicious = $result.verdicts.overall.malicious
        Phishing  = $result.verdicts.overall.phishing
        Score     = $result.verdicts.overall.score
        Report    = "https://urlscan.io/result/$uuid/"
    }
}

Scan-Url -TargetUrl "https://example.com"

Examples

"Check if this link is safe: https://bit.ly/abc123" → Submit with visibility "unlisted", wait 30 seconds, retrieve result.

"Scan this suspicious email link for phishing" → Use the one-shot function above. If Phishing = True, warn the user.

"I want to see what this URL looks like without clicking it" → Submit the scan, then use the screenshot URL: https://urlscan.io/screenshots/{uuid}.png

Cautions

  • Scans take 20–60 seconds to complete — always wait before fetching results
  • "visibility": "public" makes the scan visible to all urlscan.io users — use "unlisted" for sensitive URLs
  • Do not scan URLs that contain personal data or credentials in query parameters
  • Free tier allows ~5 scans per minute — add delays for bulk scanning
  • The API key is required to submit scans; public search results are accessible without a key

Requirements

  • URLSCAN_API_KEY — free account at https://urlscan.io (no credit card required)

Related Skills

View on GitHub
GitHub Stars843
CategorySecurity
Updated2mo ago
Forks147

Languages

TypeScript

Trust signals

100/100

From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.

No cautions