Files
Anthropic-Cybersecurity-Skills/skills/automating-ioc-enrichment/references/api-reference.md
T
mukul975 27c6414ca5 Add folder anatomy (scripts/agent.py + references/api-reference.md) for 648 cybersecurity skills
Complete skill folder anatomy across all cybersecurity skills:
- scripts/agent.py: 80-150 line Python agents using real libraries (impacket,
  boto3, azure-mgmt-*, kubernetes, pefile, yara, scapy, shodan, stix2, etc.)
- references/api-reference.md: real API documentation with method signatures
- LICENSE: MIT license for all skill folders
2026-03-10 21:02:12 +01:00

1.8 KiB

API Reference: Automating IOC Enrichment

VirusTotal API v3

IP Lookup

import requests
resp = requests.get(
    "https://www.virustotal.com/api/v3/ip_addresses/1.2.3.4",
    headers={"x-apikey": VT_KEY},
)
stats = resp.json()["data"]["attributes"]["last_analysis_stats"]
print(stats["malicious"], "/", sum(stats.values()))

File Hash Lookup

resp = requests.get(
    f"https://www.virustotal.com/api/v3/files/{sha256}",
    headers={"x-apikey": VT_KEY},
)

Domain Lookup

resp = requests.get(
    f"https://www.virustotal.com/api/v3/domains/{domain}",
    headers={"x-apikey": VT_KEY},
)

AbuseIPDB API v2

resp = requests.get(
    "https://api.abuseipdb.com/api/v2/check",
    headers={"Key": ABUSE_KEY, "Accept": "application/json"},
    params={"ipAddress": "1.2.3.4", "maxAgeInDays": 90},
)
data = resp.json()["data"]
print("Confidence:", data["abuseConfidenceScore"])
print("Reports:", data["totalReports"])

Shodan API

import shodan
api = shodan.Shodan(SHODAN_KEY)
info = api.host("1.2.3.4")
print("Ports:", info.get("ports"))
print("Vulns:", info.get("vulns"))

STIX 2.1 Export

from stix2 import Indicator, Bundle
indicator = Indicator(
    pattern="[ipv4-addr:value = '1.2.3.4']",
    pattern_type="stix",
    valid_from="2025-01-01T00:00:00Z",
    confidence=85,
)
bundle = Bundle(objects=[indicator])

Rate Limits

API Free Tier Enterprise
VirusTotal 4 req/min 500 req/min
AbuseIPDB 1000 req/day 5000 req/day
Shodan 1 req/sec 10 req/sec

References