ScanMalware.com URL Scanner

com.scanmalware.mcpPublished by mcp.scanmalware.comOfficial publisherv0.1.6Updated Oct 24, 2026

MCP server for ScanMalware.com URL scanning, malware detection, and analysis.

VerifiedStreamable HTTPWeb executableWeb Search & ScrapingSecurity & Monitoring

Overview

AI-generated overview

Remote MCP server for ScanMalware.com that lets an assistant submit URLs for sandboxed scanning and query scan results, verdicts and threat-intelligence data.

What you can do
  • Submit URLs for sandboxed browser scanning and wait for or track scan progress
  • Read scan summaries, full results, AI analysis, verdicts and analyzer status
  • Inspect TLS certificates, JARM fingerprints, technologies, bot protection, YARA matches and clipboard events
  • Search the public scan archive by text, domain, IP, ASN, favicon, JARM, OCR text, semantic similarity or AI risk and scam type
  • Look up domain, IP, ASN, favicon and screenshot statistics and similar-page matches
When to use it
Useful for phishing triage, brand-abuse monitoring and investigating suspicious links, where an assistant should scan a URL and pull together verdicts, indicators and certificate details. Also handy for searching an existing archive of public scans by domain, IP, favicon or OCR text.
Requirements
A remote streamable HTTP endpoint; no local install needed. Optional Authorization bearer token when the server is configured with MCP_AUTH_TOKEN. Private-visibility scans need a ScanMalware account token configured server-side. Network access to ScanMalware.
Before you install
Submitting a scan sends the target URL to ScanMalware and may be logged. scan_type is required: public publishes the URL and results to a public feed and search engines, unlisted is link-accessible, private needs an account token. Choose visibility deliberately for client or confidential targets and do not retry with a less restrictive mode. Some aggregate searches can take up to 90 seconds.

Installation

In SourceWeft

  1. Open ScanMalware.com URL Scanner in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/com.scanmalware.mcp%2Fscanmalware-mcp/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "scanmalware-com-url-scanner": {
      "type": "http",
      "url": "https://mcp.scanmalware.com/mcp"
    }
  }
}

README

scanmalware-mcp

Minimal Python MCP server that wraps the public ScanMalware.com API.

Operations

See the operations runbook for deployment, TLS, logging, security maintenance, and how to connect to the DigitalOcean droplet.

Run locally (Streamable HTTP)

bash
python -m venv .venvsource .venv/bin/activatepip install -U pippip install .
export MCP_TRANSPORT=streamable-httpexport MCP_HOST=127.0.0.1export MCP_PORT=8000
scanmalware-mcp

Run with Docker

bash
docker build -t scanmalware-mcp .docker run --rm -p 127.0.0.1:8000:8000 \  -e MCP_TRANSPORT=streamable-http \  -e MCP_HOST=0.0.0.0 \  -e MCP_PORT=8000 \  scanmalware-mcp

Optional: set MCP_AUTH_TOKEN to require Authorization: Bearer <MCP_AUTH_TOKEN> for HTTP transports.

Optional auth env vars (only needed for auth-gated endpoints):

  • SCANMALWARE_BEARER_TOKEN

Other env vars:

  • SCANMALWARE_BASE_URL (default: https://scanmalware.com)
  • SCANMALWARE_ALLOW_HTTP (default: false)
  • SCANMALWARE_TIMEOUT_S (default: 30)
  • SCANMALWARE_SLOW_QUERY_TIMEOUT_S (default: 90; favicon and technology statistics, OCR text search, JS fingerprint similarity counts and behavioural signature search)
  • SCANMALWARE_MAX_DOWNLOAD_BYTES (default: 10485760)
  • SCANMALWARE_ALLOW_PRIVATE_TARGETS (default: false)
  • SCANMALWARE_CA_CERT (optional; path to a CA bundle for SSL bump)

MCP server security env vars:

  • MCP_AUTH_TOKEN (if set, HTTP transports require Authorization: Bearer <token>)
  • MCP_RESOURCE_SERVER_URL / MCP_ISSUER_URL (optional; only used when MCP_AUTH_TOKEN is set)

Transport note: the HTTP transports run stateless (stateless_http=True), so responses carry no mcp-session-id header. Clients must not require one. This keeps per-session state - and therefore memory - flat. Both MCP protocol generations are served: initialize (2024-11-05 to 2025-11-25) and server/discover (2026-07-28). Requests use POST; GET on /mcp returns 405 because the server offers no standalone SSE stream.

SSE transport: set MCP_TRANSPORT=sse, and optionally MCP_SSE_MOUNT_PATH to serve it under a path prefix.

Tool note: submit_scan does not call /api/v1/csrf-token; there is no CSRF token tool. Tool note: some upstream endpoints are disabled and excluded from the tool list (e.g., get_improvements, find_screenshot_duplicates, get_ai_stats, search_js_fingerprinter2_code_hash, search_js_segments_by_tlsh). Filters: every search tool can be called with its defaults. search_js_fingerprint_patterns applies has_eval=true when no pattern filter is given, because the API requires one; search_js_obfuscation and search_js_malware_families fall back to the API's own defaults. Score filters use the API's scales and are checked before the request: the AI risk score is 0-10, AI confidence 0-100, JS obfuscation scores 0-1 and the runtime JS risk score 0-100. OCR search requires at least three characters after trimming. Library lookups use detected identifiers from get_js_library_inventory; search_js_fingerprint_by_library accepts Next.js as an alias for the detected identifier nextjs.

Scan visibility

submit_scan requires scan_type; there is no default. A public scan puts the target URL and scan results in ScanMalware's public feed, visible to other users and search engines. Choose deliberately for client targets, confidential URLs, and security engagements:

  • public: publishes the scan. Use for these targets only with explicit approval to publish.
  • unlisted: excluded from public listings, but accessible to anyone with the direct link.
  • private: results are restricted to the authenticated ScanMalware account. Requires a valid SCANMALWARE_BEARER_TOKEN configured on the MCP server; MCP_AUTH_TOKEN only controls access to the MCP server and does not provide ScanMalware authentication.

If visibility has not already been specified for these targets, ask the user to choose unlisted or private before submitting. If submission fails, do not retry with a less restrictive visibility. These modes control scan visibility; requests still go to ScanMalware and may be recorded in server logs (see the MCP privacy policy). ScanMalware documents the visibility options in its privacy policy.

Example prompts

Phishing triage (submit → wait → summarize):

text
Submit an unlisted scan for https://example-login-update.com, wait for completion, andreturn status, risk_score, and the top indicators. If high risk, include theAI analysis and screenshot resource.

Brand abuse monitoring:

text
Search scans for "acme login" (limit 5). For each result, list scan_id,status, risk_score, and URL. Highlight anything marked high risk.

TLS/certificate inspection:

text
For scan_id 1234...abcd, fetch TLS details and the certificate PEM download.Summarize issuer, subject, validity dates, and SANs; flag mismatches.

Deploy to DigitalOcean (Debian + Docker + Nginx)

The deploy bundle lives in deploy/ and runs three containers:

  • mcp (this server, streamable HTTP on port 8000)
  • nginx (frontend on ports 80/443; redirects HTTP to HTTPS and proxies /mcp to the MCP server)
  • proxy (mitmproxy, checks ScanMalware destinations and logs upstream HTTP traffic)

Prereqs

  • doctl authenticated (doctl auth init)
  • SSH key uploaded to DigitalOcean (used by doctl compute droplet create)
  • DNS and Let's Encrypt certificates at the paths in HTTPS / TLS before starting Nginx

Create a small droplet in Germany (Frankfurt)

bash
DROPLET_NAME=scanmalware-mcp-smallREGION=fra1SIZE=s-1vcpu-2gbIMAGE=debian-12-x64SSH_KEYS=$(doctl compute ssh-key list --format ID --no-header | paste -sd, -)
doctl compute droplet create "$DROPLET_NAME" \  --region "$REGION" \  --size "$SIZE" \  --image "$IMAGE" \  --ssh-keys "$SSH_KEYS" \  --tag-name scanmalware-mcp \  --wait

Firewall (public HTTP/HTTPS + SSH)

bash
doctl compute firewall create \  --name scanmalware-mcp-fw \  --inbound-rules "protocol:tcp,ports:22,address:0.0.0.0/0,address:::0/0" \  --inbound-rules "protocol:tcp,ports:80,address:0.0.0.0/0,address:::0/0" \  --inbound-rules "protocol:tcp,ports:443,address:0.0.0.0/0,address:::0/0" \  --outbound-rules "protocol:icmp,ports:0,address:0.0.0.0/0,address:::0/0" \  --outbound-rules "protocol:tcp,ports:0,address:0.0.0.0/0,address:::0/0" \  --outbound-rules "protocol:udp,ports:0,address:0.0.0.0/0,address:::0/0" \  --droplet-ids <droplet-id>

Install Docker + compose on the droplet

Install Docker Engine and the Compose plugin from the official Docker apt repository. Use docker compose; the old Python docker-compose client is incompatible with current Docker Engine.

See the operations runbook for pinned builds and maintenance checks.

Upload and run

bash
# Package exactly one commit; a tar of the working tree also picks up untracked# files (.tools/, caches, egg-info) and uncommitted edits.git archive --format=tar.gz -o /tmp/scanmalware-mcp.tar.gz origin/mainscp -i /path/to/key /tmp/scanmalware-mcp.tar.gz root@<droplet-ip>:/tmp/ssh -i /path/to/key root@<droplet-ip> \  "mkdir -p /opt/scanmalware-mcp && tar -xzf /tmp/scanmalware-mcp.tar.gz -C /opt/scanmalware-mcp"

On a fresh host, follow TLS inspection to build the proxy and generate its CA before starting MCP and Nginx. Install the egress rules and Docker startup hook and log rotation as part of host setup.

Verify

bash
curl -I https://mcp.scanmalware.com/curl -sS -o /dev/null -w '%{http_code}\n' https://mcp.scanmalware.com/mcp

/ should return 200 from Nginx. /mcp returns 405 on GET, which is expected: the server offers no standalone SSE stream, so MCP requests use POST.

Smoke test (MCP initialize + tools/list)

bash
python - <<'PY'import jsonimport httpx
URL = "https://mcp.scanmalware.com/mcp"HEADERS = {    "accept": "application/json, text/event-stream",    "content-type": "application/json",}
init_payload = {    "jsonrpc": "2.0",    "id": 1,    "method": "initialize",    "params": {        "protocolVersion": "2025-06-18",        "capabilities": {},        "clientInfo": {"name": "mcp-smoke-test", "version": "0.1.0"},    },}
with httpx.Client(timeout=10) as client:    init_resp = client.post(URL, headers=HEADERS, json=init_payload)    init_resp.raise_for_status()    # Stateless deployments return no session header.    session_id = init_resp.headers.get("mcp-session-id")
    def extract_sse_data(text: str) -> dict:        for line in text.splitlines():            if line.startswith("data: "):                return json.loads(line[len("data: "):])        raise ValueError("No SSE data line found")
    init_message = extract_sse_data(init_resp.text)    protocol_version = init_message["result"]["protocolVersion"]
    headers = {**HEADERS, "mcp-protocol-version": protocol_version}    if session_id:        headers["mcp-session-id"] = session_id
    # Send initialized notification    client.post(        URL,        headers=headers,        json={"jsonrpc": "2.0", "method": "notifications/initialized"},    )
    tools_resp = client.post(        URL,        headers=headers,        json={"jsonrpc": "2.0", "id": 2, "method": "tools/list"},    )    tools_resp.raise_for_status()    tools_message = extract_sse_data(tools_resp.text)    tool_names = [tool["name"] for tool in tools_message["result"]["tools"]]
print("protocol_version:", protocol_version)print("tool_count:", len(tool_names))print("tools:", ", ".join(tool_names))PY

Redeploy / new deploys

Two common flows:

  1. In-place update (same droplet)
bash
# Package exactly one commit; a tar of the working tree also picks up untracked# files (.tools/, caches, egg-info) and uncommitted edits.git archive --format=tar.gz -o /tmp/scanmalware-mcp.tar.gz origin/mainscp -i /path/to/key /tmp/scanmalware-mcp.tar.gz root@<droplet-ip>:/tmp/ssh -i /path/to/key root@<droplet-ip> \  "bash /opt/scanmalware-mcp/deploy/redeploy.sh /tmp/scanmalware-mcp.tar.gz"

The redeploy script stops all three containers, replaces the files, and rebuilds and restarts every image (docker compose up -d --build), preserving the mitmproxy CA. It deletes files on the droplet that are not in git (everything outside logs/). If the script is not on the droplet yet, run the legacy tar + docker compose command once to install it.

Optional one-shot helper from the repo root (it packs the working tree, including uncommitted changes, rather than a commit):

bash
./deploy/push-redeploy.sh root@<droplet-ip> /path/to/key

To update only the MCP server with a few seconds of downtime, see Updating only the MCP server.

  1. Rolling deploy (new droplet)
  • Create a new droplet (steps above)
  • Deploy the same bundle
  • Switch DNS to the new IP
  • Destroy the old droplet when ready
bash
doctl compute droplet delete <old-droplet-id> --force

Source: README.md at commit 0ad36e7

Tools

128

get_recent_scans

Get Recent Scans

List the most recent public scans, newest first (paginated with page and limit). Each row has the scan ID, URL, status, visibility and submission time. Unlisted and private scans are never included.

Parameterspagelimit

submit_scan

Submit Scan

Submit a URL to ScanMalware to be rendered and analysed in a sandboxed browser; returns the new scan_id. scan_type is required and sets who can see the result: 'public' lists the URL and its results in the public feed, visible to anyone and to search engines; 'unlisted' keeps the scan out of public listings, but anyone with its link can open it; 'private' limits the result to the ScanMalware account of this server's SCANMALWARE_BEARER_TOKEN and is rejected when no token is configured. Wraps POST /api/v1/scan of the ScanMalware API, documented at https://scanmalware.com/api-docs.

Parametersurlrequiredoptionsscan_typerequireduser_agent

get_scan_summary

Get Scan Summary

Get a compact summary of one scan: submitted URL, final URL after redirects, status, completion time and the security verdict (verdict text, risk level, confidence and risk factors). Useful as the first look at a scan; the verdict is empty for a few seconds after a scan completes. scan_id is the UUID of a ScanMalware scan.

Parametersscan_idrequired

wait_for_scan

Wait For Scan

Wait for a submitted scan to finish by polling its status every poll_interval_s seconds, up to timeout_s seconds (default 180). Returns the final compact summary (URL, final URL, status, completion time and the security verdict), or the last known status with timeout set to true if the scan is still running. The security verdict is computed after the scan completes, usually within about a minute: until then verdict_pending is true and the verdict fields are empty, so a risk score of 0 is not yet a verdict. scan_id is the UUID of a ScanMalware scan.

Parametersscan_idrequiredtimeout_spoll_interval_s

get_scan_result

Get Scan Result

Get the full result document of one scan: URLs and redirects, page title, load times, links, network requests, IP addresses, JavaScript files, TLS, fuzzy hashes, screenshot hashes, favicon and the security verdict. The response is large; the compact summary is enough for a verdict. scan_id is the UUID of a ScanMalware scan.

Parametersscan_idrequired

search_scans

Search Scans

Search the archive of public scans by text in the URL, domain or page title (paginated); q needs at least 3 characters and search_type narrows the match (default 'all'). Each result has the scan ID, URL, status, title, submission time and hosting ASN.

Parametersqrequiredpagelimitsearch_type

get_ai_analysis

Get AI Analysis

Get the AI analysis of one scan: classification (LEGITIMATE to CONFIRMED_SCAM), scam type, risk score, confidence, impersonated brand and the key evidence behind it. The analysis is produced a few minutes after the scan completes and returns not found until then. It can disagree with the scanner's own security verdict. scan_id is the UUID of a ScanMalware scan.

Parametersscan_idrequired

get_scan_progress

Get Scan Progress

Get the progress of a running scan: current step, total steps, step name, percentage and status. Useful for checking whether a scan has finished before reading its results. scan_id is the UUID of a ScanMalware scan.

Parametersscan_idrequired

get_scan_ioc

Get Scan IOC

Check one scan against threat-intelligence indicator feeds: matching IP addresses and domains the page contacted, the threat types, and a summary of total and unique matches. scan_id is the UUID of a ScanMalware scan.

Parametersscan_idrequired

get_tls_details

Get TLS Details

Get the TLS certificate the scanned site presented: subject, issuer, validity dates, whether it was valid or expired, and related details. scan_id is the UUID of a ScanMalware scan.

Parametersscan_idrequired

get_tls_asn1

Get TLS ASN1

Get the raw ASN.1 structure of the TLS certificate from one scan, for detailed certificate inspection. scan_id is the UUID of a ScanMalware scan.

Parametersscan_idrequired

get_technologies_by_scan

Get Technologies By Scan

List the web technologies detected on a scanned page (frameworks, CMS, CDN, analytics and so on), with versions where known. scan_id is the UUID of a ScanMalware scan.

Parametersscan_idrequired

get_bot_protection

Get Bot Protection

Get the bot-protection and CAPTCHA services detected on a scanned page (for example Cloudflare Turnstile), with a detected flag. Phishing kits often use these to hide from scanners. scan_id is the UUID of a ScanMalware scan.

Parametersscan_idrequired

get_yara_matches

Get YARA Matches

Get the YARA rule matches recorded for one scan, with the matching rules and a summary by severity and category. scan_id is the UUID of a ScanMalware scan.

Parametersscan_idrequired

get_jarm_signatures

Get JARM Signatures

Get the JARM TLS server fingerprints measured for the hosts in one scan, with whether each matches a known signature. A shared JARM often points to the same server software or hosting platform, so it is a weak pivot on its own. scan_id is the UUID of a ScanMalware scan.

Parametersscan_idrequired

get_analyzer_results

Get Analyzer Results

List which analysis modules ran for one scan (for example JavaScript fingerprinting and AI analysis), with each module's status, success flag and timing. Useful for checking why a result is missing. scan_id is the UUID of a ScanMalware scan.

Parametersscan_idrequired

get_clipboard_events

Get Clipboard Events

Get the clipboard writes the page attempted while it was scanned, with the event count and whether collection ran. Empty with an explanatory note when the page wrote nothing. scan_id is the UUID of a ScanMalware scan.

Parametersscan_idrequired

get_js_fingerprints

Get JS Fingerprints

List the JavaScript files a scanned page loaded, each with its fingerprint: hashes (SHA-256, SHA-1, MD5, normalized and fuzzy), size metrics, detected library and bundler. The include_* options add function lists, HTTP headers or ML vector details. Useful for collecting script hashes to search for elsewhere. scan_id is the UUID of a ScanMalware scan.

Parametersscan_idrequiredinclude_functionsinclude_http_headersinclude_vectors_info

get_scan_reports

Get Scan Reports

List the user reports and votes filed about one scan (for example marked safe or malicious), with the total count; report_type filters by kind. Empty when nobody has reported the scan. scan_id is the UUID of a ScanMalware scan.

Parametersscan_idrequiredreport_type

get_domain_scans

Get Domain Scans

List the recent scans of a domain and its subdomains, newest first, up to limit; status filters by scan status. Each row has matched_on: 'url' when the scan was submitted for a host under this domain, and only 'final_url' when another site redirected there. A verdict on a final_url-only row belongs to the submitted host, not to this domain.

Parameterslimitdomainrequiredstatus

get_domain_history

Get Domain History

Get the scan history of a domain with the total count and the scans, paginated with page and limit.

Parameterspagelimitdomainrequired

get_domain_stats

Get Domain Stats

Get scan counts for a domain: total, unique, completed and failed scans, first and latest scan, and scans in the last 24 hours, 7 days and 30 days.

Parametersdomainrequired

search_by_ip

Search By IP

List scans of pages served from an IP address (paginated), each with scan ID, URL and time. On shared hosting and CDNs an IP serves many unrelated sites, so a match is not evidence of a connection.

Parameterspagelimitip_addressrequired

get_ip_stats

Get IP Stats

Get statistics for an IP address across the archive: total scans, unique URLs, first and last seen, geolocation, ASN and organisation, BGP and DNS data; paginated.

Parameterspagelimitip_addressrequired

search_by_asn

Search By ASN

Get what the archive knows about an autonomous system (ASN number, without 'AS'): organisation, total scans, unique URLs, first and last seen and BGP prefixes; paginated.

Parameterspagelimitasn_numberrequired

search_similar_scans

Search Similar Scans

Find scans that look like this one by screenshot similarity, favicon or fuzzy page hash (methods, default screenshot), each with URL, final URL, title and what it matched by; paginated. Useful for finding copies of a phishing page on other hosts. scan_id is the UUID of a ScanMalware scan.

Parameterspagelimitmethodsscan_idrequired

search_semantic

Search Semantic

Search scans by meaning rather than exact words, comparing the query with scanned page content (for example 'bank login page asking for card details'). threshold (default 0.7) is the minimum similarity; an empty result means nothing was similar enough.

Parameterspagelimitqueryrequiredthreshold

search_by_favicon

Search By Favicon

Search scans by favicon hash (paginated): a mmh3 hash by default, or the favicon's MD5 with hash_type='md5'.

Parameterspagelimithash_typehash_valuerequired

search_ai_high_risk

Search AI High Risk

List scans that the AI analysis rated high risk, optionally above min_risk_score and min_confidence, each with URL, title and the analysis. min_risk_score is on the AI's 0-10 risk scale (default 7) and min_confidence is a 0-100 percentage (default 70).

Parameterslimitmin_confidencemin_risk_score

search_ai_scam_type

Search AI Scam Type

List scans whose AI analysis named a given scam type, such as 'Phishing', each with URL, title, submission time and the analysis (verdict, classification, risk score). The match is on the scam type text the analysis produced.

Parameterslimitscam_typerequired

search_ai_classification

Search AI Classification

List scans whose AI analysis gave a specific classification: LEGITIMATE, LOW_RISK, MODERATE_RISK, HIGH_RISK or CONFIRMED_SCAM. Each result has the URL, title, submission time and the analysis.

Parameterslimitclassificationrequired

get_analyzer_stats

Get Analyzer Stats

Get platform-wide statistics for the scan analysis modules: the modules and their run counts. Describes the service, not a particular scan.

Takes no parameters.

search_analyzer_high_risk

Search Analyzer High Risk

List scans that the security analyzer scored as high risk, highest first (paginated), each with URL, risk score, verdict, confidence and analysis time. min_risk_score raises the threshold.

Parameterspagelimitmin_risk_score

get_favicon

Get Favicon

Get the favicon recorded for a scan_id: its size, MD5 and SHA-256 hashes, and the image base64-encoded. found is false when no favicon is stored for the scan.

Parametersscan_idrequired

get_favicon_stats

Get Favicon Stats

Get favicon statistics across the archive: total favicons, those seen in the last 24 hours and the most common hashes with sample URLs. This aggregate query can take up to 90 seconds by default.

Takes no parameters.

get_screenshot_stats

Get Screenshot Stats

Get screenshot statistics across the archive: total screenshots, hash coverage and the distribution of perceptual hash types.

Takes no parameters.

search_similar_screenshots

Search Similar Screenshots

Find screenshots within max_distance (Hamming distance, default 3) of an integer perceptual hash (hash_type, default phash), each with scan, URL, title, distance and similarity score.

Parameterslimithash_typehash_valuerequiredmax_distance

search_ocr

Search OCR

Search OCR text (paginated). q must contain at least 3 characters after trimming. This query can take up to 90 seconds by default.

Parametersqrequiredpagelimit

search_ocr_pattern

Search OCR Pattern

Search the text read by OCR from scan screenshots for a pattern (paginated); case_sensitive controls matching. Useful for finding pages that show the same lure text as an image.

Parameterspagelimitpatternrequiredcase_sensitive

search_by_jarm

Search By JARM

List scans whose server presented this JARM TLS fingerprint (paginated). Large hosting platforms share JARMs across many unrelated sites, so check what the matches have in common.

Parameterspagelimitjarm_signaturerequired

search_by_fuzzy_hash

Search By Fuzzy Hash

List scans whose page content has a similar fuzzy hash (hash_type tlsh, ssdeep or sdhash; the value comes from a scan result), each with URL, title and time; paginated. Useful for finding near-identical copies of a page.

Parameterspagelimithash_typerequiredhash_valuerequired

search_by_screenshot_hash

Search By Screenshot Hash

List scans whose screenshot has this perceptual hash (hash_type ahash, phash, dhash, whash, color_hash or crop_resistant), optionally within similarity_threshold, each with URL, title and time; paginated. Useful for finding pages that look the same.

Parameterspagelimithash_typerequiredhash_valuerequiredsimilarity_threshold

search_suspicious_clipboard

Search Suspicious Clipboard

List scans where the page wrote suspicious content to the clipboard (for example PowerShell commands), each with URL, event count, reason and time; pattern filters the content; paginated.

Parameterspagelimitpattern

get_recent_threats

Get Recent Threats

List malware threats detected in scans during the last hours (default window set by the API), with totals and grouping by threat.

Parametershourslimit

get_recent_yara_threats

Get Recent YARA Threats

List YARA rule matches from scans in the last hours, each with the scan, URL, rule, category, severity and confidence.

Parametershourslimit

get_ct_certificates

Get CT Certificates

Get the certificates issued for a domain according to Certificate Transparency logs, with a found flag.

Parametersdomainrequired

get_ct_dns_records

Get CT DNS Records

List subdomains of a domain found through Certificate Transparency, with their DNS records (type, IP addresses, TTL) and when they were seen. Useful for finding the other hosts of a domain.

Parametersdomainrequired

get_ct_domains_by_ip

Get CT Domains By IP

List domains that Certificate Transparency and DNS data associate with an IP address, with record counts and the total.

Parametersip_addressrequired

get_ct_similar_domains

Get CT Similar Domains

Find domains with names similar to a domain in Certificate Transparency data (for example lookalikes and typosquats), each with a certificate count and the kind of similarity.

Parametersdomainrequired

get_ct_timeline

Get CT Timeline

Get the certificate history of a domain from Certificate Transparency: when certificates were issued and when the certificate changed.

Parametersdomainrequired

get_api_root

Get API Root

Get the ScanMalware API's name, version, status, main endpoints and feature list.

Takes no parameters.

get_health

Get Health

Check whether the ScanMalware API is up. Returns the service status.

Takes no parameters.

get_platform_stats

Get Platform Stats

Get the current scan queue length, running scans and scans completed in the last 24 hours by visibility.

Takes no parameters.

get_latest_capabilities

Get Latest Capabilities

Get the current size of ScanMalware's detection content: indicator count, malware detection rules and ClamAV signatures.

Takes no parameters.

get_capabilities_by_date

Get Capabilities By Date

Get the size of ScanMalware's detection content (indicators, detection rules, ClamAV signatures) on a given date (scan_date, YYYY-MM-DD).

Parametersscan_daterequired

get_clipboard_stats

Get Clipboard Stats

Get clipboard and pastejacking statistics across the archive: event totals, detections and daily activity.

Takes no parameters.

get_cpe_stats

Get CPE Stats

Get CPE statistics across the archive: scans with CPEs, unique CPEs, total detections, top vendors and products.

Takes no parameters.

get_cpe_by_scan

Get CPE By Scan

List the CPE identifiers (product and version names in the NVD format) derived from the technologies detected on a scanned page, with their source. Useful for matching against vulnerability data. scan_id is the UUID of a ScanMalware scan.

Parametersscan_idrequired

search_cpe

Search CPE

Find scans with a CPE identifier matching a pattern such as 'cpe:2.3:a:facebook:react' (paginated). Useful for finding sites running a given product.

Parameterspagelimitcpe_patternrequired

get_ids_alerts

Get IDS Alerts

Get intrusion detection (IDS) alerts raised on the network traffic recorded during one scan, with a severity breakdown and total count. Empty when no rule fired. scan_id is the UUID of a ScanMalware scan.

Parametersscan_idrequired

get_jarm_stats

Get JARM Stats

Get JARM statistics across the archive, including the most common signatures. Common signatures usually belong to large hosting platforms.

Takes no parameters.

get_malware_stats

Get Malware Stats

Get malware detection statistics across the archive: overall and last-24-hour counts, top threats and hourly trend.

Takes no parameters.

get_malware_by_scan

Get Malware By Scan

Get the malware detections for files the scanned page delivered, with threat names, detection counts and the detection source. Empty when nothing was detected. scan_id is the UUID of a ScanMalware scan.

Parametersscan_idrequired

get_yara_stats

Get YARA Stats

Get YARA statistics across the archive: overall and last-24-hour matches, severity and category distribution and top threats.

Takes no parameters.

get_yara_by_scan

Get YARA By Scan

Get YARA rule matches for one scan, with a summary by severity (critical, high, medium, low) and category. Empty when no rule matched. scan_id is the UUID of a ScanMalware scan.

Parametersscan_idrequired

get_safe_browsing_stats

Get Safe Browsing Stats

Get Google Safe Browsing statistics across the archive: total threats, threats in the last 7 days, scans with threats and threat types.

Takes no parameters.

get_safe_browsing

Get Safe Browsing

Get Google Safe Browsing threats found for the URLs in one scan, with a has_threats flag. scan_id is the UUID of a ScanMalware scan.

Parametersscan_idrequired

get_top_tracking_keys

Get Top Tracking Keys

List the tracking and site keys seen on the most sites (analytics IDs, CAPTCHA keys and so on), with the tracker name, category and site count; tracker_type filters by kind.

Parameterslimittracker_type

search_tracking_key

Search Tracking Key

Find scans that embed a given tracking or site key, such as an analytics ID or a CAPTCHA site key (tracker_type and key), sorted latest or oldest; paginated. A shared key often ties sites to one operator.

Parameterskeyrequiredpagesortlimittracker_typerequired

search_technologies

Search Technologies

Search the web technologies detected across the archive by name (q) or category, each with how many scans used it and when it was last seen; paginated.

Parametersqpagelimitcategory

get_technology_combinations

Get Technology Combinations

List the technologies most often detected together with a given technology, with counts; min_occurrences drops rare pairs; paginated.

Parameterspagelimittech_namerequiredmin_occurrences

get_technology_stats

Get Technology Stats

Get technology detection statistics across the archive: unique technologies, total detections and counts per category. This aggregate query can take up to 90 seconds by default.

Takes no parameters.

search_by_nameserver

Search By Nameserver

List the scanned domains that use a given nameserver, with totals and counts per top-level domain. Useful for finding domains registered together.

Parametersnameserverrequired

get_rdap

Get RDAP

Get registration data (RDAP) for the scanned domain and its IP addresses: registrar, registration and expiry dates, domain age, nameservers and status. A very young domain is a common phishing signal. scan_id is the UUID of a ScanMalware scan.

Parametersscan_idrequired

search_by_registrar

Search By Registrar

List scans of domains registered through a given registrar (paginated), with the total. Common registrars match very many domains.

Parameterspagelimitregistrar_namerequired

submit_scan_report

Submit Scan Report

Vote on a scan, as the Mark as Safe and Mark as Malicious buttons on its result page do: report_type 'positive_feedback' marks the scanned page as safe and 'malware' marks it as malicious. report_details is an optional note of up to 1000 characters. Votes are recorded as crowd feedback on the scan and are rate-limited per client IP. The website's other report types (phishing, spam, copyright and so on) need a captcha and are not available here.

Parametersscan_idrequiredreport_typerequiredreport_details

get_ocr_stats

Get OCR Stats

Get OCR statistics across the archive: scans with OCR text, average confidence and length, language distribution and daily counts.

Takes no parameters.

get_ocr_by_scan

Get OCR By Scan

Get the text read by OCR from the scan's screenshot, with language, confidence, word and character counts and any regions flagged as suspicious. Useful when page text is drawn as images. scan_id is the UUID of a ScanMalware scan.

Parametersscan_idrequired

get_open_graph

Get Open Graph

Get the Open Graph and Twitter card metadata the scanned page declared (title, description, image, site name). Phishing pages often copy a brand's metadata. scan_id is the UUID of a ScanMalware scan.

Parametersscan_idrequired

get_pastejacking

Get Pastejacking

Get pastejacking findings for one scan: attempts by the page to replace what a visitor copies, a common trick for making victims paste malicious commands. Includes a detected flag and a note. scan_id is the UUID of a ScanMalware scan.

Parametersscan_idrequired

get_netlog

Get Network Log Info

Describe the network log (Chrome NetLog) for a scan_id: whether one exists, its size, and its encoding. The log itself is not returned - these are routinely tens of megabytes gzipped.

Parametersscan_idrequired

get_pcap_metadata

Get PCAP Metadata

Describe the packet capture (PCAP) recorded during one scan: whether it exists, its size, compression and content type. The capture itself is not returned. scan_id is the UUID of a ScanMalware scan.

Parametersscan_idrequired

search_favicon_mmh3

Search Favicon MMH3

List scans whose favicon has this mmh3 hash (the same convention as Shodan's http.favicon.hash), each with the page URL, title and favicon details; paginated. Phishing kits often reuse one favicon across many hosts.

Parameterspagelimitmmh3_hashrequired

get_js_runtime_behaviour

Get Runtime JS Behaviour

Get the runtime JavaScript behaviour recorded for one scan: overall risk, risk scores, number of scripts, eval and Function-constructor calls and high-risk events, with a behavioural signature and composite hash. include_detailed_events adds the individual events. scan_id is the UUID of a ScanMalware scan.

Parametersscan_idrequiredinclude_detailed_events

get_js_runtime_stats

Get Runtime JS Behaviour Stats

Get platform-wide statistics for runtime JavaScript analysis: risk distribution, averages and totals of eval calls and high-risk events. Describes the service, not a scan.

Takes no parameters.

get_js_runtime_health

Check Runtime JS Analysis Health

Check whether the runtime JavaScript analysis service is up, with its version.

Takes no parameters.

get_js_runtime_coverage

Get Runtime JS Analysis Coverage

Get how many scans have runtime JavaScript fingerprints: coverage percentage and the number of unique composite hashes and signatures. Describes the service, not a scan.

Takes no parameters.

search_js_obfuscation

Search JS Obfuscation

List scans by the obfuscation signals their runtime JavaScript showed, newest analysis first: overall risk, maximum and average risk score, eval and Function constructor calls and high-risk events. Optional filters are risk_level (such as 'high' or 'critical'), min_risk_score (0-100) and has_eval; with none, the most recently analysed scans are listed.

Parameterslimithas_evalrisk_levelmin_risk_score

search_js_malware_families

Search JS Malware Families

List groups of scans whose runtime JavaScript behaves alike (possible malware families), with clusters of at least min_cluster_size scans (default 2) at similarity_threshold or above (0 to 1, default 0.95). When the service has clustering switched off, status is 'disabled' and no families are returned.

Parameterslimitmin_cluster_sizesimilarity_threshold

search_js_runtime_by_composite_hash

Search Runtime JS Behaviour by Composite Hash

Find scans whose runtime JavaScript behaviour has this composite hash, each with the target URL, overall risk and time. The same composite hash across hosts usually means the same kit.

Parameterslimitcomposite_hashrequired

search_js_runtime_by_signature

Search Runtime JS Behaviour by Signature

Find scans with this behavioural signature (for example 'setTimeout:30|fetch:4|complex'), each with the target URL, overall risk and time. An uncached query can take up to 90 seconds by default.

Parameterslimitsignaturerequired

search_js_runtime_similar

Find Similar Runtime JS Behaviour

Find scans whose runtime JavaScript behaviour is similar to this scan's, above min_similarity; include_self keeps the scan itself. scan_id is the UUID of a ScanMalware scan.

Parameterslimitscan_idrequiredinclude_selfmin_similarity

get_js_segments_by_scan

Get JS Segments By Scan

List the code segments (functions and blocks) extracted from one scan's JavaScript, each with location, length, snippet and hashes; script_url narrows to one file, paginated with limit and offset. scan_id is the UUID of a ScanMalware scan.

Parameterslimitoffsetscan_idrequiredscript_url

search_js_segments_by_hash

Search JS Segments By Hash

Find code segments with this exact code hash across the archive, with the scans and scripts they appear in; paginated with limit and offset.

Parameterslimitoffsetcode_hashrequired

search_js_segments_by_normalized_hash

Search JS Segments By Normalized Hash

Find code segments with this normalized hash (formatting-independent) across the archive, with the scans and scripts they appear in; paginated with limit and offset.

Parameterslimitoffsetnormalized_hashrequired

get_js_segments_suspicious

Get JS Segments Suspicious

List the JavaScript code segments from one scan scored as suspicious, above min_risk_score, with location, snippet and risk details; paginated with limit and offset. scan_id is the UUID of a ScanMalware scan.

Parameterslimitoffsetscan_idrequiredmin_risk_score

get_js_segments_unknown

Get JS Segments Unknown

List the JavaScript code segments from one scan that match no known library, at least min_code_length long; these are usually the page's own or a kit's code. Paginated with limit and offset. scan_id is the UUID of a ScanMalware scan.

Parameterslimitoffsetscan_idrequiredmin_code_length

run_js_differential_analysis

Run JS Differential Analysis

Compare the JavaScript of one scan against known libraries and report which code segments match a library, which are unknown and which look suspicious, with a per-library breakdown. Matches below min_confidence (default 0.8) are not counted; known library code is excluded unless include_known_libraries is true. scan_id is the UUID of a ScanMalware scan.

Parametersscan_idrequiredmin_confidenceinclude_known_libraries

get_js_library_inventory

Get JS Library Inventory

List the JavaScript libraries and versions detected across the archive, with how many scans used each; library filters to one library and min_count drops rare versions. Identifiers are lowercase names such as 'react', 'jquery' or 'nextjs'.

Parameterslibrarymin_count

search_js_fingerprint_patterns

Search JS Fingerprint Patterns

List scanned JavaScript files that match code-pattern filters: has_eval, has_crypto, high_entropy, no_library and cdn_mismatch, where false selects files without the pattern and filters can be combined. With no filter given, has_eval=true is applied. Each result has the fingerprint ID, scan, script URL, code length, obfuscation score and the patterns detected.

Parameterslimithas_evalhas_cryptono_librarycdn_mismatchhigh_entropy

search_js_fingerprint_obfuscated

Search JS Fingerprint Obfuscated

List scanned JavaScript scored as obfuscated, filtered by score range, classification and minimum code length; exclude_libraries drops known library code. min_score and max_score are obfuscation scores from 0 to 1 (defaults 0.7 and 1.0). Paginated with page and per_page.

Parameterspageper_pagemax_scoremin_scoreclassificationmin_code_lengthexclude_libraries

search_js_fingerprint_by_server

Search JS Fingerprint By Server

Find JavaScript by the type of web server that served it (for example 'nginx' or 'microsoft'), with the matching scripts; include_headers adds the HTTP headers. The total can be a lower bound.

Parameterslimitserver_typerequiredinclude_headers

search_js_fingerprint_by_bundler

Search JS Fingerprint By Bundler

Find JavaScript bundles built with a given bundler (webpack, vite, rollup, esbuild and so on), optionally by bundle format and detection confidence, with totals, format breakdown and average size; paginated with page and per_page.

Parameterspageper_pagebundler_typerequiredbundle_formatmin_confidenceinclude_libraries

search_js_fingerprint_by_cdn

Search JS Fingerprint By CDN

Find JavaScript served from a given CDN (for example 'cloudflare' or 'jsdelivr'), with totals, the top serving domains and cache status; unpinned_only keeps scripts loaded without a fixed version.

Parameterslimitcdn_typerequiredunpinned_onlycdn_cache_status

search_js_fingerprint_by_library

Search JS Fingerprint By Library

Find scanned JavaScript detected as a given library (for example 'react', 'jquery' or 'nextjs'; 'Next.js' is accepted for 'nextjs'), optionally one version or a version pattern, with a version breakdown and CDN distribution; paginated with page and per_page.

Parameterspageversionper_pagelibrary_namerequiredmin_confidenceversion_patterninclude_cdn_only

search_js_fingerprint_by_library_version

Search JS Fingerprint By Library Version

Find scanned JavaScript detected as one exact library version, with the total and the matching scripts; include_deprecated and group_by_url adjust the results. Useful for finding sites running a vulnerable version.

Parameterslimitlibraryrequiredversionrequiredgroup_by_urlinclude_deprecated

search_js_fingerprint_by_fuzzy_hash

Search JS Fingerprint By Fuzzy Hash

Find JavaScript files whose fuzzy hash is close to this one, above min_similarity, up to limit results. Fuzzy hashes match files that differ in small parts, such as a kit with a changed configuration.

Parameterslimitfuzzy_hashrequiredmin_similarity

search_js_fingerprint_by_md5

Search JS Fingerprint By MD5

Look up a JavaScript file by MD5 across the archive and report its prevalence: total matches, unique scans, first and last seen, a prevalence label and the matching scripts; include_scans adds the scans, from_date and to_date limit the period.

Parameterslimitto_datefrom_datehash_valuerequiredinclude_scans

search_js_fingerprint_by_normalized_hash

Search JS Fingerprint By Normalized Hash

Look up JavaScript by normalized hash (computed after whitespace and formatting are removed, so reformatted copies still match) and report prevalence: total matches, unique scans, first and last seen and the matching scripts.

Parameterslimitto_datefrom_datehash_valuerequiredinclude_scans

search_js_fingerprint_by_sha1

Search JS Fingerprint By SHA1

Look up a JavaScript file by SHA-1 across the archive and report its prevalence: total matches, unique scans, first and last seen, a prevalence label and the matching scripts; include_scans adds the scans, from_date and to_date limit the period.

Parameterslimitto_datefrom_datehash_valuerequiredinclude_scans

search_js_fingerprint_by_sha256

Search JS Fingerprint By SHA256

Look up a JavaScript file by SHA-256 across the archive and report its prevalence: total matches, unique scans, first and last seen, a prevalence label and the matching scripts; include_scans adds the scans, from_date and to_date limit the period. A rare hash shared by several phishing pages usually means one kit.

Parameterslimitto_datefrom_datehash_valuerequiredinclude_scans

find_js_fingerprint_similar_by_hash

Find JS Fingerprint Similar By Hash

Find JavaScript files similar to the file with this content SHA-256, above threshold (default 0.7), up to limit results; exclude_exact_matches drops identical copies. Useful for finding modified versions of a known script.

Parameterslimitthresholdcontent_sha256requiredexclude_exact_matches

search_jsfingerprints_by_bundler

Search JS Fingerprints By Bundler

Paginated list (limit and offset) of archived script fingerprints built with a given bundler, each with scan, page URL and script URL.

Parameterslimitoffsetbundlerrequired

search_jsfingerprints_by_library

Search JS Fingerprints By Library

Paginated list (limit and offset) of archived script fingerprints detected as a given library, each with scan, page URL, script URL and version.

Parameterslimitoffsetlibraryrequired

search_jsfingerprints_by_library_version

Search JS Fingerprints By Library Version

Paginated list (limit and offset) of archived script fingerprints detected as one library version, each with scan, page URL and script URL.

Parameterslimitoffsetlibraryrequiredversionrequired

search_jsfingerprints_by_fuzzy_hash

Search JS Fingerprints By Fuzzy Hash

Paginated list (limit and offset) of archived script fingerprints whose fuzzy hash matches this value, each with scan, page URL and script URL. An empty list means no close match.

Parameterslimitoffsetfuzzy_hashrequired

search_jsfingerprints_by_md5

Search JS Fingerprints By MD5

Paginated list (limit and offset) of archived script fingerprints with this MD5, each with scan, page URL, scan time, script URL and hashes.

Parameterslimitoffsethash_valuerequired

search_jsfingerprints_by_normalized_hash

Search JS Fingerprints By Normalized Hash

Paginated list (limit and offset) of archived script fingerprints with this normalized hash (formatting-independent), each with scan, page URL and script URL.

Parameterslimitoffsethash_valuerequired

search_jsfingerprints_by_sha1

Search JS Fingerprints By SHA1

Paginated list (limit and offset) of archived script fingerprints with this SHA-1, each with scan, page URL, scan time, script URL and hashes.

Parameterslimitoffsethash_valuerequired

search_jsfingerprints_by_sha256

Search JS Fingerprints By SHA256

Paginated list (limit and offset) of archived script fingerprints with this SHA-256, each with scan, page URL, scan time, script URL and hashes.

Parameterslimitoffsethash_valuerequired

get_jsfingerprint

Get JS Fingerprint

Get one JavaScript fingerprint record by its numeric fingerprint_id: the script URL, scan, hashes, metrics and ML vector information; include_functions and include_http_headers add more detail.

Parametersfingerprint_idrequiredinclude_functionsinclude_http_headers

get_jsfingerprint_similar

Get JS Fingerprint Similar

Find JavaScript files whose fingerprint is similar to the one with this fingerprint_id, above threshold (0 to 1), paginated with limit and offset. exclude_same_scan drops matches from the same scan. Useful for finding variants of one script.

Parameterslimitoffsetthresholdfingerprint_idrequiredexclude_same_scan

get_jsfingerprint_similarity_counts

Get JS Fingerprint Similarity Counts

Count how many archived JavaScript files are similar to the one with this fingerprint_id, per similarity model (composite, CodeBERT, GraphCodeBERT, AST and handcrafted features), capped at max_count. This query can take up to 90 seconds by default.

Parametersmax_countthresholdfingerprint_idrequired

get_jsfingerprint_source

Get JS Fingerprint Source

Get the stored source code of one JavaScript file by its numeric fingerprint_id, with its SHA-256, URL and length. Source can be long.

Parametersfingerprint_idrequired

get_jsfingerprint_bundle_stats

Get JS Fingerprint Bundle Stats

Get statistics on bundled JavaScript across the archive for a date range: share of bundled files and the breakdown by bundler (webpack, vite, rollup and so on) and module format.

Parametersto_datefrom_date

get_jsfingerprint_library_stats

Get JS Fingerprint Library Stats

Get statistics on JavaScript library detection across the archive for a date range: total fingerprints, detection rate and the most common libraries.

Parametersto_datefrom_datemin_count

get_jsfingerprint_hash_prevalence

Get JS Fingerprint Hash Prevalence

For each script in one scan, report how common its hash is across the archive, which separates widely used library files from rare, page-specific code. scan_id is the UUID of a ScanMalware scan.

Parametersscan_idrequired

Version history

1
  1. v0.1.6LatestSep 16, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts