shodanapi.py

# ----------------------------------------
# Shodan API method lookups
# ----------------------------------------

import requests
import os

# Base URL
baseURL = "https://api.shodan.io"


def cve(cveStr: str):
    cve = requests.get(f"https://cvedb.shodan.io/cve/{cveStr}").json()
    print("=" * 120)
    print(f"CVE Summary: {cve["summary"]}")
    print("=" * 120)
    print(f"Reference: {cve["references"][0]}")


def search(q: str):
    apikey = os.getenv("SHODAN_API_KEY")
    r: dict = requests.get(
        f"{baseURL}/shodan/host/search?key={apikey}&query={q}"
    ).json()

    print(f"Total Results: {r.get('total', 0)}")
    for m in r.get("matches", []):
        ip = m.get("ip_str", "N/A")
        port = m.get("port", "N/A")
        product = m.get("product", "Unknown")
        org = m.get("org", "Unknown")
        print(f"IP: {ip}:{port}")
        print(f"Product: {product}")
        print(f"Organization: {org}")
        print("-" * 40)


def iplookup(ip: str):
    apikey = os.getenv("SHODAN_API_KEY")
    r: dict = requests.get(f"{baseURL}/shodan/host/{ip}?key={apikey}").json()
    print(f"IP: {r.get('ip_str', 'N/A')}")
    print(f"Organization: {r.get('org', 'N/A')}")
    print(f"Operating System: {r.get('os', 'N/A')}")
    for port in r.get("ports", []):
        print(f"Open port: {port}")


def api_info():
    apikey = os.getenv("SHODAN_API_KEY")
    r: dict = requests.get(f"{baseURL}/api-info?key={apikey}").json()
    print(f"Shodan API Plan: {r.get("plan", "N/A")}")
    print(f"Scan Credits: {r.get('scan_credits', "N/A")}")
    print(f"Queries Remaining: {r.get('query_credits', "N/A")}")
    print(f"Number of IP's Monitored: {r.get("monitored_ips")}")


def myip():
    apikey = os.getenv("SHODAN_API_KEY")
    r: dict = requests.get(f"{baseURL}/tools/myip?key={apikey}").json()
    print(f"{r}")