LuminaScan 1.0.6__tar.gz

luminascan-1.0.6/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 marlenelopestolfo2018-cmd
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

luminascan-1.0.6/LuminaScan/main.py

@@ -0,0 +1,298 @@
+#!/usr/bin/env python3
+import sys
+import requests
+import pyfiglet
+import colorama
+from colorama import Fore, Style
+import json
+import argparse
+import time
+from requests.exceptions import (
+    MissingSchema,
+    InvalidSchema,
+    InvalidURL,
+    ConnectionError,
+    Timeout,
+    RequestException
+)
+
+# fingerprint detection function
+def detectar_fingerprint(headers):
+    h = {k.lower(): v.lower() for k, v in headers.items()}
+    resultado = []
+
+    fingerprints = {
+        "Cloudflare": ["cf-ray", "cf-cache-status", ("server", "cloudflare"), "cf-connecting-ip"],
+        "AWS (CloudFront / S3)": ["x-amz-cf-id", "x-amz-cf-pop", ("via", "amazon"), ("server", "amazons3")],
+        "Google Cloud": ["x-cloud-trace-context", ("server", "google"), ("via", "google")],
+        "Azure": ["x-azure-ref", "arr-cookie", ("server", "microsoft-iis")],
+        "Fastly": ["x-served-by", ("via", "fastly"), ("x-cache", "hit")],
+        "Vercel": ["x-vercel-id", ("server", "vercel")],
+        "Netlify": ["x-nf-request-id", ("server", "netlify")]
+    }
+
+    for nome, sinais in fingerprints.items():
+        score = 0
+        for sinal in sinais:
+            if isinstance(sinal, tuple):
+                chave, valor = sinal
+                if chave in h and valor in h[chave]:
+                    score += 1
+            else:
+                if sinal in h:
+                    score += 1
+        if score >= 2:
+            confianca = "High"
+        elif score == 1:
+            confianca = "Average"
+        else:
+            continue
+        resultado.append(f"{nome} (Trust {confianca})")
+
+    return resultado if resultado else ["Unidentified"]
+
+
+def analisar_security_headers(headers):
+    security_headers = {
+        "content-security-policy", "strict-transport-security", "x-content-type-options",
+        "x-frame-options", "x-xss-protection", "referrer-policy", "permissions-policy",
+        "cross-origin-resource-policy", "cross-origin-opener-policy", "cross-origin-embedder-policy"
+    }
+    encontrados = []
+    headers_lower = {k.lower(): v for k, v in headers.items()}
+    for sec in security_headers:
+        if sec in headers_lower:
+            encontrados.append(sec)
+    total = len(encontrados)
+    if total <= 1:
+        nivel = "Low"
+    elif total <= 3:
+        nivel = "Medium"
+    else:
+        nivel = "High"
+    return {"Found": encontrados, "Total": total, "Security Level": nivel}
+
+# Main function
+def main():
+    parser = argparse.ArgumentParser(
+        description="LuminaScan - Simple HTTP Analyzer"
+    )
+
+
+    parser.add_argument("url", help="Target URL")
+    parser.add_argument("--cookies", action="store_true", help="Show cookies")
+    parser.add_argument("--headers", action="store_true", help="Show headers")
+    parser.add_argument("--fingerprint", action="store_true", help="Detect CDN/Fingerprint")
+    parser.add_argument("--security", action="store_true", help="Analyze security headers")
+    parser.add_argument("--json", action="store_true", help="Show JSON response")
+    parser.add_argument("--redirects", action="store_true", help="Show redirects info")
+    parser.add_argument("--status", action="store_true", help="Show status code")
+    parser.add_argument("--content", action="store_true", help="Determine if API or Website")
+    parser.add_argument("--all", action="store_true", help="Show all information")
+    parser.add_argument("--method", choices=["get", "post", "put", "delete"], default="get", help="HTTP method to use (default: get)")
+    parser.add_argument("--timeout", default="easy", help="Set delay between requests: easy (1s), medium (3s), hard (5s)")
+    parser.add_argument("--data", help="JSON payload for POST/PUT requests")
+    parser.add_argument("--http-complete", action="store_true", help="Show status for all payloads")
+    parser.add_argument("--banner", action="store_true", help="Show LuminaScan Banner")
+    args = parser.parse_args()
+
+    # tempo
+    val = args.timeout.lower()
+    try:
+        if val == "easy":
+            delay = 1
+        elif val == "medium":
+            delay = 3
+        elif val == "hard":
+            delay = 5
+        else:
+            delay = 1
+    except:
+        print("Invalid timeout value, using default of 1 second.")
+        delay = 1
+
+    url = args.url
+    if not url.startswith(("http://", "https://")):
+        url = "http://" + url
+
+    # User-Agent
+    ninja = {
+        "User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64)",
+        "Accept": "*/*",
+        "Accept-Language": "en-US,en;q=0.5",
+        "Accept-Encoding": "gzip, deflate",
+        "Connection": "keep-alive"
+    }
+    # Banner
+    if args.banner:
+        alien = pyfiglet.figlet_format("LuminaScan", font="smslant")
+        print(Fore.GREEN + alien + Style.RESET_ALL)
+
+    # All flags
+    if args.all:
+        args.cookies = args.headers = args.fingerprint = args.json = args.redirects = args.status = args.security = args.content = True
+
+    # HTTP Method with payload input
+    payload = {}
+
+    if args.method.lower() in ["post", "put"]:
+        if args.data:
+            try:
+                payload = json.loads(args.data)
+            except json.JSONDecodeError:
+                print("Invalid JSON in --data, using empty payload {}")
+                payload = {}
+        else:
+            user_input = input('Enter JSON payload (e.g. {"key":"value"}): ').strip()
+            if user_input:
+                try:
+                    payload = json.loads(user_input)
+                except json.JSONDecodeError:
+                    print("Invalid JSON, using empty payload {}")
+                    payload = {}
+
+    # Requests
+    try:
+        time.sleep(delay)
+
+        if args.method.lower() == "get":
+            response = requests.get(url, headers=ninja, timeout=4)
+        elif args.method.lower() == "post":
+            response = requests.post(url, json=payload, headers=ninja, timeout=4)
+        elif args.method.lower() == "put":
+            response = requests.put(url, json=payload, headers=ninja, timeout=4)
+        elif args.method.lower() == "delete":
+            response = requests.delete(url, headers=ninja, timeout=4)
+
+    except MissingSchema:
+        print("[ERROR] Invalid URL format. Please include http:// or https://")
+        exit(1)
+    except InvalidURL:
+        print("[ERROR] Malformed URL. Check the target address.")
+        exit(1)
+    except ConnectionError:
+        print("[ERROR] Connection failed. Host unreachable or offline.")
+        exit(1)
+    except Timeout:
+        print("[ERROR] Request timeout. The server did not respond in time.")
+        exit(1)
+    except RequestException as e:
+        print(f"[ERROR] Unexpected request error: {e}")
+        exit(1)
+
+    print(f"\n-------HTTP METHOD SUMMARY: {args.method.upper()}-------")
+    print(f"Status: {response.status_code}")
+    print(f"Response Time: {response.elapsed.total_seconds()}s\n")
+
+# Payload loop guru-friendly
+    results = []
+    try:
+        payloads = payload if isinstance(payload, list) else [payload]
+
+        for i, pay in enumerate(payloads, start=1):
+            try:
+                r = requests.post(url, json=pay, timeout=delay)
+                status = r.status_code
+            except requests.exceptions.Timeout:
+                status = "TIMEOUT"
+            except requests.exceptions.RequestException:
+                status = "ERROR"
+
+            results.append((i, status))
+
+            if args.http_complete:
+                print(f"Payload {i}: Status {status}")
+    except KeyboardInterrupt:
+        print("\n[!] KeyboardInterrupt detected. Exiting...")
+        sys.exit(0)
+
+    # Cookies
+    if args.cookies:
+        time.sleep(delay)
+        print(f"\n---------COOKIES---------")
+        for c in response.cookies:
+            print(f"{c.name} = {c.value}")
+        print("\nAll cookies:", response.cookies)
+        print(f"[*] Number of cookies: {len(response.cookies)}")
+        print(f"[!] Time to receive cookies: {response.elapsed.total_seconds()} seconds")
+
+    # Status
+    if args.status:
+        time.sleep(delay)
+        print("\n---------STATUS---------")
+        try:
+            if response.status_code == 200:
+                print("[+] Active site/API - 200")
+            elif response.status_code == 404:
+                print("[!] Site/API Not Found - 404")
+            elif response.status_code == 429:
+                print("[-] Too Many Requests - 429")
+            elif response.status_code == 403:
+                print("[$] Site Blocked - 403")
+            else:
+                print("Unknown status error!!")
+        except Exception as e:
+            print(f"Error checking status: {e}")
+        print(f"[-] Time to receive response: {response.elapsed.total_seconds()} seconds")
+
+    # Headers
+    if args.headers:
+        time.sleep(delay)
+        print("\n------------HEADERS------------")
+        for chave, valor in response.headers.items():
+            print(f"[*] Key: {chave}")
+            print(f"[!] Value: {valor}")
+        print(f"[#] Number of Headers: {len(response.headers)}")
+
+    # Fingerprint
+    if args.fingerprint:
+        time.sleep(delay)
+        print("\n---------FINGERPRINT---------")
+        print(f"Possible CDN/Fingerprint: {', '.join(detectar_fingerprint(response.headers))}")
+
+    # JSON
+    if args.json:
+        time.sleep(delay)
+        print("\n--------------JSON-----------------")
+        try:
+            print(json.dumps(response.json(), indent=4))
+        except ValueError:
+            print("No JSON response found.")
+
+    # Redirects
+    if args.redirects:
+        time.sleep(delay)
+        print("\n-----------REDIRECT---------------")
+        print(f"Final URL after redirects: {response.url}")
+        print(f"Number of redirects: {len(response.history)}")
+        for resp in response.history:
+            print(f"Redirected from {resp.url} with status {resp.status_code}")
+
+    # Content type
+    if args.content:
+        time.sleep(delay)
+        print("\n----------API OR SITE---------------")
+        content_type = response.headers.get("Content-Type", "").lower()
+        if "application/json" in content_type:
+            print("[+] API detected (JSON response)")
+        elif "text/html" in content_type:
+            print("[+] Website detected (HTML)")
+        else:
+            print("[?] Unknown content type")
+
+    # Security headers
+    if args.security:
+        time.sleep(delay)
+        print("\n-------SECURITY HEADERS-------")
+        time.sleep(delay)
+        print(analisar_security_headers(response.headers))
+
+    print(f"\n[~] Avg response time: {response.elapsed.total_seconds()}s")
+    print("-----------------------------------")
+
+
+
+
+# Entry point
+if __name__ == "__main__":
+    main()

luminascan-1.0.6/LuminaScan.egg-info/PKG-INFO

@@ -0,0 +1,29 @@
+Metadata-Version: 2.4
+Name: LuminaScan
+Version: 1.0.6
+Summary: Tool to analyze website and APIs via HTTP requests
+Home-page: https://github.com/PixelPirate-bit/LuminaScan
+Author: PixelPirate-bit-2
+License: MIT
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests>=2.25.1
+Requires-Dist: pyfiglet>=0.8.post1
+Requires-Dist: colorama>=0.4.4
+Dynamic: author
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: license
+Dynamic: license-file
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+LuminaScan
+
+LuminaScan is a Python tool created to analyze websites and APIs in a fast and practical way. It allows you to check headers, status codes, cookies, JSON responses, and much more, all directly from the terminal.
+
+Installation
+pip install luminascan

luminascan-1.0.6/LuminaScan.egg-info/SOURCES.txt

@@ -0,0 +1,11 @@
+LICENSE
+README.md
+setup.py
+LuminaScan/__init__.py
+LuminaScan/main.py
+LuminaScan.egg-info/PKG-INFO
+LuminaScan.egg-info/SOURCES.txt
+LuminaScan.egg-info/dependency_links.txt
+LuminaScan.egg-info/entry_points.txt
+LuminaScan.egg-info/requires.txt
+LuminaScan.egg-info/top_level.txt

luminascan-1.0.6/LuminaScan.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

luminascan-1.0.6/LuminaScan.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+luminascan = LuminaScan.main:main

luminascan-1.0.6/LuminaScan.egg-info/requires.txt

@@ -0,0 +1,3 @@
+requests>=2.25.1
+pyfiglet>=0.8.post1
+colorama>=0.4.4

luminascan-1.0.6/LuminaScan.egg-info/top_level.txt

@@ -0,0 +1 @@
+LuminaScan

luminascan-1.0.6/PKG-INFO

@@ -0,0 +1,29 @@
+Metadata-Version: 2.4
+Name: LuminaScan
+Version: 1.0.6
+Summary: Tool to analyze website and APIs via HTTP requests
+Home-page: https://github.com/PixelPirate-bit/LuminaScan
+Author: PixelPirate-bit-2
+License: MIT
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests>=2.25.1
+Requires-Dist: pyfiglet>=0.8.post1
+Requires-Dist: colorama>=0.4.4
+Dynamic: author
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: license
+Dynamic: license-file
+Dynamic: requires-dist
+Dynamic: requires-python
+Dynamic: summary
+
+LuminaScan
+
+LuminaScan is a Python tool created to analyze websites and APIs in a fast and practical way. It allows you to check headers, status codes, cookies, JSON responses, and much more, all directly from the terminal.
+
+Installation
+pip install luminascan

luminascan-1.0.6/README.md

@@ -0,0 +1,6 @@
+LuminaScan
+
+LuminaScan is a Python tool created to analyze websites and APIs in a fast and practical way. It allows you to check headers, status codes, cookies, JSON responses, and much more, all directly from the terminal.
+
+Installation
+pip install luminascan

luminascan-1.0.6/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

luminascan-1.0.6/setup.py

@@ -0,0 +1,25 @@
+from setuptools import setup, find_packages
+
+setup(
+    name="LuminaScan",
+    version="1.0.6",
+    author="PixelPirate-bit-2",
+    description="Tool to analyze website and APIs via HTTP requests",
+    long_description=open("README.md", encoding="utf-8").read(),
+    long_description_content_type="text/markdown",
+    url="https://github.com/PixelPirate-bit/LuminaScan",
+    license="MIT",
+    packages=find_packages(),
+    install_requires=[
+        "requests>=2.25.1",
+        "pyfiglet>=0.8.post1",
+        "colorama>=0.4.4"
+    ],
+    entry_points={
+        "console_scripts": [
+            "luminascan=LuminaScan.main:main"
+        ]
+    },
+    python_requires='>=3.8',
+
+)