711b9b3146
- website_scanner.py: multi-page crawl, 20+ service patterns (tracking, CDN, chatbots, payment, fonts, captcha, video), AI text detection - dse_service_extractor.py: LLM extracts services from privacy policy text - agent_scan_routes.py: POST /agent/scan — combines scan + DSE comparison, generates findings (undocumented, outdated, third-country transfer), auto-corrections via Qwen in pre-launch mode Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
249 lines
10 KiB
Python
249 lines
10 KiB
Python
"""
|
|
Website Scanner — scans multiple pages of a website for third-party services,
|
|
chatbots, tracking, AI indicators, and compares against privacy policy.
|
|
|
|
Used by the Compliance Agent for SOLL/IST analysis.
|
|
"""
|
|
|
|
import logging
|
|
import re
|
|
from dataclasses import dataclass, field
|
|
from urllib.parse import urljoin, urlparse
|
|
|
|
import httpx
|
|
|
|
logger = logging.getLogger(__name__)
|
|
|
|
USER_AGENT = "BreakPilot-Compliance-Agent/1.0"
|
|
|
|
|
|
@dataclass
|
|
class DetectedService:
|
|
id: str
|
|
name: str
|
|
category: str # "tracking", "chatbot", "cdn", "payment", "marketing", "other"
|
|
provider: str
|
|
country: str
|
|
eu_adequate: bool
|
|
requires_consent: bool
|
|
legal_ref: str
|
|
found_on: str = "" # URL where detected
|
|
|
|
|
|
@dataclass
|
|
class ScanResult:
|
|
pages_scanned: list[str] = field(default_factory=list)
|
|
detected_services: list[DetectedService] = field(default_factory=list)
|
|
ai_mentions: list[str] = field(default_factory=list)
|
|
chatbot_detected: bool = False
|
|
chatbot_provider: str = ""
|
|
missing_pages: dict = field(default_factory=dict) # url -> status_code
|
|
|
|
|
|
# ── Service Registry ──────────────────────────────────────────────────────────
|
|
# Each entry: regex pattern -> service metadata
|
|
SERVICE_REGISTRY: dict[str, dict] = {
|
|
# --- Tracking & Analytics ---
|
|
r"google.?analytics|gtag\(|UA-\d+|G-\w{5,}": {
|
|
"id": "google_analytics", "name": "Google Analytics", "category": "tracking",
|
|
"provider": "Google LLC", "country": "US", "eu_adequate": False,
|
|
"requires_consent": True, "legal_ref": "Art. 44-49 DSGVO, §25 TDDDG",
|
|
},
|
|
r"googletagmanager|gtm\.js": {
|
|
"id": "google_tag_manager", "name": "Google Tag Manager", "category": "tracking",
|
|
"provider": "Google LLC", "country": "US", "eu_adequate": False,
|
|
"requires_consent": True, "legal_ref": "Art. 44-49 DSGVO",
|
|
},
|
|
r"facebook\.net/.*fbevents|fbq\(": {
|
|
"id": "facebook_pixel", "name": "Meta/Facebook Pixel", "category": "marketing",
|
|
"provider": "Meta Platforms", "country": "US", "eu_adequate": False,
|
|
"requires_consent": True, "legal_ref": "Art. 44-49 DSGVO, §25 TDDDG",
|
|
},
|
|
r"hotjar\.com|_hjSettings": {
|
|
"id": "hotjar", "name": "Hotjar", "category": "tracking",
|
|
"provider": "Hotjar Ltd", "country": "MT", "eu_adequate": True,
|
|
"requires_consent": True, "legal_ref": "§25 TDDDG (Session Recording)",
|
|
},
|
|
r"clarity\.ms": {
|
|
"id": "ms_clarity", "name": "Microsoft Clarity", "category": "tracking",
|
|
"provider": "Microsoft", "country": "US", "eu_adequate": False,
|
|
"requires_consent": True, "legal_ref": "§25 TDDDG (Session Replay), Art. 44 DSGVO",
|
|
},
|
|
r"matomo|piwik": {
|
|
"id": "matomo", "name": "Matomo", "category": "tracking",
|
|
"provider": "InnoCraft/Self-hosted", "country": "EU/Self", "eu_adequate": True,
|
|
"requires_consent": False, "legal_ref": "Cookieless moeglich, §25 TDDDG",
|
|
},
|
|
r"plausible\.io": {
|
|
"id": "plausible", "name": "Plausible Analytics", "category": "tracking",
|
|
"provider": "Plausible Insights", "country": "EE", "eu_adequate": True,
|
|
"requires_consent": False, "legal_ref": "EU-Anbieter, cookieless",
|
|
},
|
|
# --- CDN & Fonts ---
|
|
r"fonts\.googleapis\.com|fonts\.gstatic\.com": {
|
|
"id": "google_fonts", "name": "Google Fonts (remote)", "category": "cdn",
|
|
"provider": "Google LLC", "country": "US", "eu_adequate": False,
|
|
"requires_consent": True, "legal_ref": "LG Muenchen I, Az. 3 O 17493/20",
|
|
},
|
|
r"cdn\.cloudflare\.com|cdnjs\.cloudflare\.com": {
|
|
"id": "cloudflare_cdn", "name": "Cloudflare CDN", "category": "cdn",
|
|
"provider": "Cloudflare Inc", "country": "US", "eu_adequate": False,
|
|
"requires_consent": False, "legal_ref": "Art. 44-49 DSGVO, berechtigtes Interesse",
|
|
},
|
|
# --- Chatbots ---
|
|
r"widget\.intercom\.io|intercomcdn": {
|
|
"id": "intercom", "name": "Intercom", "category": "chatbot",
|
|
"provider": "Intercom Inc", "country": "US", "eu_adequate": False,
|
|
"requires_consent": True, "legal_ref": "Art. 44-49 DSGVO, KI-gestuetzt",
|
|
},
|
|
r"tidio\.co|tidioChatApi": {
|
|
"id": "tidio", "name": "Tidio Chat", "category": "chatbot",
|
|
"provider": "Tidio LLC", "country": "PL", "eu_adequate": True,
|
|
"requires_consent": False, "legal_ref": "EU-Anbieter",
|
|
},
|
|
r"zendesk\.com/embeddable|zdassets": {
|
|
"id": "zendesk", "name": "Zendesk", "category": "chatbot",
|
|
"provider": "Zendesk Inc", "country": "US", "eu_adequate": False,
|
|
"requires_consent": True, "legal_ref": "Art. 44-49 DSGVO",
|
|
},
|
|
# --- Payment ---
|
|
r"js\.stripe\.com|stripe\.com/v3": {
|
|
"id": "stripe", "name": "Stripe", "category": "payment",
|
|
"provider": "Stripe Inc", "country": "US", "eu_adequate": False,
|
|
"requires_consent": False, "legal_ref": "Art. 6(1)(b) Vertragserfuellung, SCCs",
|
|
},
|
|
r"paypal\.com/sdk|paypalobjects": {
|
|
"id": "paypal", "name": "PayPal", "category": "payment",
|
|
"provider": "PayPal Holdings", "country": "US", "eu_adequate": False,
|
|
"requires_consent": False, "legal_ref": "Art. 6(1)(b) Vertragserfuellung",
|
|
},
|
|
r"klarna\.com|klarna-payments": {
|
|
"id": "klarna", "name": "Klarna", "category": "payment",
|
|
"provider": "Klarna AB", "country": "SE", "eu_adequate": True,
|
|
"requires_consent": False, "legal_ref": "EU, aber Art. 22 DSGVO bei Bonitaetspruefung!",
|
|
},
|
|
# --- Captcha ---
|
|
r"recaptcha|grecaptcha": {
|
|
"id": "recaptcha", "name": "Google reCAPTCHA", "category": "other",
|
|
"provider": "Google LLC", "country": "US", "eu_adequate": False,
|
|
"requires_consent": True, "legal_ref": "Art. 44-49 DSGVO, §25 TDDDG",
|
|
},
|
|
# --- Video ---
|
|
r"youtube\.com/embed|youtube-nocookie|ytimg": {
|
|
"id": "youtube", "name": "YouTube", "category": "other",
|
|
"provider": "Google LLC", "country": "US", "eu_adequate": False,
|
|
"requires_consent": True, "legal_ref": "Art. 44-49 DSGVO, 2-Klick empfohlen",
|
|
},
|
|
# --- Consent Management ---
|
|
r"didomi|cookiebot|onetrust|usercentrics|consentmanager|quantcast": {
|
|
"id": "cmp", "name": "Consent Management Platform", "category": "other",
|
|
"provider": "Various", "country": "EU", "eu_adequate": True,
|
|
"requires_consent": False, "legal_ref": "CMP vorhanden — gut",
|
|
},
|
|
}
|
|
|
|
AI_TEXT_PATTERNS = [
|
|
r"k(?:ue|ü)nstliche.?intelligenz",
|
|
r"artificial.?intelligence",
|
|
r"machine.?learning",
|
|
r"maschinelles.?lernen",
|
|
r"KI.?gest(?:ue|ü)tzt",
|
|
r"AI.?powered",
|
|
r"chatgpt|openai",
|
|
r"deep.?learning",
|
|
r"neural.?net",
|
|
r"automatisierte.?entscheidung",
|
|
]
|
|
|
|
FOOTER_LINK_PATTERNS = [
|
|
(r'href="([^"]*(?:impressum|imprint|legal-notice)[^"]*)"', "impressum"),
|
|
(r'href="([^"]*(?:datenschutz|privacy|dsgvo)[^"]*)"', "datenschutz"),
|
|
(r'href="([^"]*(?:agb|terms|nutzungsbedingungen)[^"]*)"', "agb"),
|
|
(r'href="([^"]*(?:cookie)[^"]*)"', "cookies"),
|
|
]
|
|
|
|
|
|
async def scan_website(base_url: str) -> ScanResult:
|
|
"""Scan a website: start page + footer links for services and AI indicators."""
|
|
result = ScanResult()
|
|
parsed = urlparse(base_url)
|
|
origin = f"{parsed.scheme}://{parsed.netloc}"
|
|
|
|
async with httpx.AsyncClient(timeout=10.0, follow_redirects=True) as client:
|
|
# 1. Fetch start page
|
|
start_html = await _fetch_page(client, origin, result)
|
|
if not start_html:
|
|
return result
|
|
|
|
# 2. Discover footer links
|
|
page_urls = {origin}
|
|
page_urls.add(base_url) # Also scan the provided URL
|
|
for pattern, _ in FOOTER_LINK_PATTERNS:
|
|
for match in re.finditer(pattern, start_html, re.IGNORECASE):
|
|
href = match.group(1)
|
|
if href.startswith("/"):
|
|
href = urljoin(origin, href)
|
|
if href.startswith(origin):
|
|
page_urls.add(href)
|
|
|
|
# 3. Scan all pages (max 10)
|
|
for url in list(page_urls)[:10]:
|
|
html = start_html if url == origin else await _fetch_page(client, url, result)
|
|
if html:
|
|
_detect_services(html, url, result)
|
|
_detect_ai_mentions(html, url, result)
|
|
|
|
# Deduplicate services
|
|
seen = set()
|
|
unique = []
|
|
for svc in result.detected_services:
|
|
if svc.id not in seen:
|
|
seen.add(svc.id)
|
|
unique.append(svc)
|
|
result.detected_services = unique
|
|
|
|
result.chatbot_detected = any(s.category == "chatbot" for s in result.detected_services)
|
|
if result.chatbot_detected:
|
|
result.chatbot_provider = next(
|
|
s.name for s in result.detected_services if s.category == "chatbot"
|
|
)
|
|
|
|
return result
|
|
|
|
|
|
async def _fetch_page(
|
|
client: httpx.AsyncClient, url: str, result: ScanResult,
|
|
) -> str:
|
|
"""Fetch a single page. Returns HTML or empty string on failure."""
|
|
try:
|
|
resp = await client.get(url, headers={"User-Agent": USER_AGENT})
|
|
result.pages_scanned.append(url)
|
|
if resp.status_code >= 400:
|
|
result.missing_pages[url] = resp.status_code
|
|
return ""
|
|
return resp.text
|
|
except Exception as e:
|
|
logger.warning("Failed to fetch %s: %s", url, e)
|
|
return ""
|
|
|
|
|
|
def _detect_services(html: str, url: str, result: ScanResult) -> None:
|
|
"""Detect third-party services in HTML."""
|
|
for pattern, meta in SERVICE_REGISTRY.items():
|
|
if re.search(pattern, html, re.IGNORECASE):
|
|
result.detected_services.append(DetectedService(
|
|
found_on=url, **meta,
|
|
))
|
|
|
|
|
|
def _detect_ai_mentions(html: str, url: str, result: ScanResult) -> None:
|
|
"""Detect AI/ML text mentions in page content."""
|
|
# Strip scripts/styles first for text-only search
|
|
clean = re.sub(r"<(script|style)[^>]*>.*?</\1>", "", html, flags=re.DOTALL | re.IGNORECASE)
|
|
clean = re.sub(r"<[^>]+>", " ", clean)
|
|
for pattern in AI_TEXT_PATTERNS:
|
|
match = re.search(pattern, clean, re.IGNORECASE)
|
|
if match:
|
|
context = clean[max(0, match.start() - 40):match.end() + 40].strip()
|
|
result.ai_mentions.append(f"{url}: ...{context}...")
|