""" HTML Feature Extractor for Phishing Detection Extracts ~50 features from HTML content including forms, links, scripts, etc. """ import re from pathlib import Path from bs4 import BeautifulSoup from urllib.parse import urlparse import pandas as pd import numpy as np class HTMLFeatureExtractor: """Extract features from HTML content for phishing detection.""" def __init__(self): # Common legitimate brand keywords self.brand_keywords = [ 'paypal', 'amazon', 'google', 'microsoft', 'apple', 'facebook', 'netflix', 'ebay', 'instagram', 'twitter', 'linkedin', 'yahoo', 'bank', 'visa', 'mastercard', 'americanexpress', 'chase', 'wells', 'citibank', 'dhl', 'fedex', 'ups', 'usps' ] # Urgency/phishing keywords self.urgency_keywords = [ 'urgent', 'verify', 'account', 'suspended', 'locked', 'confirm', 'update', 'security', 'alert', 'warning', 'expire', 'limited', 'immediately', 'click here', 'act now', 'suspended', 'unusual', 'unauthorized', 'restricted' ] def extract_features(self, html_content, url=None): """ Extract all HTML features from content. Args: html_content: HTML string content url: Optional URL for additional context Returns: Dictionary of features """ features = {} try: soup = BeautifulSoup(html_content, 'html.parser') # Basic structure features features.update(self._extract_structure_features(soup)) # Form features features.update(self._extract_form_features(soup)) # Link features features.update(self._extract_link_features(soup, url)) # Script features features.update(self._extract_script_features(soup)) # Text content features features.update(self._extract_text_features(soup)) # Meta tag features features.update(self._extract_meta_features(soup)) # External resource features features.update(self._extract_resource_features(soup, url)) # Advanced phishing indicators features.update(self._extract_advanced_features(soup)) except Exception as e: print(f"Error extracting features: {e}") # Return default features on error features = self._get_default_features() return features def _extract_structure_features(self, soup): """Extract basic HTML structure features.""" return { 'html_length': len(str(soup)), 'num_tags': len(soup.find_all()), 'num_divs': len(soup.find_all('div')), 'num_spans': len(soup.find_all('span')), 'num_paragraphs': len(soup.find_all('p')), 'num_headings': len(soup.find_all(['h1', 'h2', 'h3', 'h4', 'h5', 'h6'])), 'num_lists': len(soup.find_all(['ul', 'ol'])), 'num_images': len(soup.find_all('img')), 'num_iframes': len(soup.find_all('iframe')), 'num_tables': len(soup.find_all('table')), 'has_title': 1 if soup.find('title') else 0, } def _extract_form_features(self, soup): """Extract form-related features.""" forms = soup.find_all('form') features = { 'num_forms': len(forms), 'num_input_fields': len(soup.find_all('input')), 'num_password_fields': len(soup.find_all('input', {'type': 'password'})), 'num_email_fields': len(soup.find_all('input', {'type': 'email'})), 'num_text_fields': len(soup.find_all('input', {'type': 'text'})), 'num_submit_buttons': len(soup.find_all(['input', 'button'], {'type': 'submit'})), 'num_hidden_fields': len(soup.find_all('input', {'type': 'hidden'})), 'has_form': 1 if forms else 0, } # Check form actions if forms: form_actions = [form.get('action', '') for form in forms] features['num_external_form_actions'] = sum(1 for action in form_actions if action.startswith('http')) features['num_empty_form_actions'] = sum(1 for action in form_actions if not action or action == '#') else: features['num_external_form_actions'] = 0 features['num_empty_form_actions'] = 0 return features def _extract_link_features(self, soup, url=None): """Extract link-related features.""" links = soup.find_all('a') hrefs = [link.get('href', '') for link in links] features = { 'num_links': len(links), 'num_external_links': sum(1 for href in hrefs if href.startswith('http')), 'num_internal_links': sum(1 for href in hrefs if href.startswith('/') or href.startswith('#')), 'num_empty_links': sum(1 for href in hrefs if not href or href == '#'), 'num_mailto_links': sum(1 for href in hrefs if href.startswith('mailto:')), 'num_javascript_links': sum(1 for href in hrefs if 'javascript:' in href.lower()), } # Calculate ratio of external links if features['num_links'] > 0: features['ratio_external_links'] = features['num_external_links'] / features['num_links'] # type: ignore else: features['ratio_external_links'] = 0 # Check for suspicious link patterns features['num_ip_based_links'] = sum(1 for href in hrefs if re.search(r'http://\d+\.\d+\.\d+\.\d+', href)) return features def _extract_script_features(self, soup): """Extract JavaScript/script features.""" scripts = soup.find_all('script') features = { 'num_scripts': len(scripts), 'num_inline_scripts': sum(1 for script in scripts if script.string), 'num_external_scripts': sum(1 for script in scripts if script.get('src')), } # Check for suspicious script patterns script_content = ' '.join([script.string for script in scripts if script.string]) features['has_eval'] = 1 if 'eval(' in script_content else 0 features['has_unescape'] = 1 if 'unescape(' in script_content else 0 features['has_escape'] = 1 if 'escape(' in script_content else 0 features['has_document_write'] = 1 if 'document.write' in script_content else 0 return features def _extract_text_features(self, soup): """Extract text content features.""" # Get all visible text text = soup.get_text(separator=' ', strip=True).lower() features = { 'text_length': len(text), 'num_words': len(text.split()), } # Check for brand mentions features['num_brand_mentions'] = sum(1 for brand in self.brand_keywords if brand in text) # Check for urgency keywords features['num_urgency_keywords'] = sum(1 for keyword in self.urgency_keywords if keyword in text) # Check for specific patterns features['has_copyright'] = 1 if '©' in text or 'copyright' in text else 0 features['has_phone_number'] = 1 if re.search(r'\b\d{3}[-.]?\d{3}[-.]?\d{4}\b', text) else 0 features['has_email'] = 1 if re.search(r'\b[A-Za-z0-9._%+-]+@[A-Za-z0-9.-]+\.[A-Z|a-z]{2,}\b', text) else 0 return features def _extract_meta_features(self, soup): """Extract meta tag features.""" meta_tags = soup.find_all('meta') features = { 'num_meta_tags': len(meta_tags), 'has_description': 1 if soup.find('meta', {'name': 'description'}) else 0, 'has_keywords': 1 if soup.find('meta', {'name': 'keywords'}) else 0, 'has_author': 1 if soup.find('meta', {'name': 'author'}) else 0, 'has_viewport': 1 if soup.find('meta', {'name': 'viewport'}) else 0, } # Check for refresh meta tag (often used in phishing) refresh_meta = soup.find('meta', {'http-equiv': 'refresh'}) features['has_meta_refresh'] = 1 if refresh_meta else 0 return features def _extract_resource_features(self, soup, url=None): """Extract external resource features.""" # CSS links css_links = soup.find_all('link', {'rel': 'stylesheet'}) # Images images = soup.find_all('img') img_srcs = [img.get('src', '') for img in images] # Inline styles inline_style_tags = soup.find_all('style') inline_style_content = ''.join([tag.string or '' for tag in inline_style_tags]) features = { 'num_css_files': len(css_links), 'num_external_css': sum(1 for link in css_links if link.get('href', '').startswith('http')), 'num_external_images': sum(1 for src in img_srcs if src.startswith('http')), 'num_data_uri_images': sum(1 for src in img_srcs if src.startswith('data:')), 'num_inline_styles': len(inline_style_tags), 'inline_css_length': len(inline_style_content), 'has_favicon': 1 if soup.find('link', {'rel': 'icon'}) or soup.find('link', {'rel': 'shortcut icon'}) else 0, } return features def _extract_advanced_features(self, soup): """Extract advanced phishing indicators.""" features = {} # Suspicious element combinations has_password = len(soup.find_all('input', {'type': 'password'})) > 0 has_external_action = any( form.get('action', '').startswith('http') for form in soup.find_all('form') ) features['password_with_external_action'] = 1 if (has_password and has_external_action) else 0 # Obfuscation indicators all_text = str(soup).lower() features['has_base64'] = 1 if 'base64' in all_text else 0 features['has_atob'] = 1 if 'atob(' in all_text else 0 features['has_fromcharcode'] = 1 if 'fromcharcode' in all_text else 0 # Suspicious attributes features['num_onload_events'] = len(soup.find_all(attrs={'onload': True})) features['num_onerror_events'] = len(soup.find_all(attrs={'onerror': True})) features['num_onclick_events'] = len(soup.find_all(attrs={'onclick': True})) # Domain analysis from links external_domains = set() for link in soup.find_all('a', href=True): href = link['href'] if href.startswith('http'): try: domain = urlparse(href).netloc if domain: external_domains.add(domain) except: pass features['num_unique_external_domains'] = len(external_domains) # Suspicious patterns in forms forms = soup.find_all('form') features['num_forms_without_labels'] = sum( 1 for form in forms if len(form.find_all('label')) == 0 and len(form.find_all('input')) > 0 ) # CSS visibility hiding (phishing technique) features['has_display_none'] = 1 if 'display:none' in all_text or 'display: none' in all_text else 0 features['has_visibility_hidden'] = 1 if 'visibility:hidden' in all_text or 'visibility: hidden' in all_text else 0 # Popup/redirect indicators features['has_window_open'] = 1 if 'window.open' in all_text else 0 features['has_location_replace'] = 1 if 'location.replace' in all_text or 'location.href' in all_text else 0 return features def _get_default_features(self): """Return dictionary with all features set to 0.""" return { # Structure features (11) 'html_length': 0, 'num_tags': 0, 'num_divs': 0, 'num_spans': 0, 'num_paragraphs': 0, 'num_headings': 0, 'num_lists': 0, 'num_images': 0, 'num_iframes': 0, 'num_tables': 0, 'has_title': 0, # Form features (8) 'num_forms': 0, 'num_input_fields': 0, 'num_password_fields': 0, 'num_email_fields': 0, 'num_text_fields': 0, 'num_submit_buttons': 0, 'num_hidden_fields': 0, 'has_form': 0, 'num_external_form_actions': 0, 'num_empty_form_actions': 0, # Link features (8) 'num_links': 0, 'num_external_links': 0, 'num_internal_links': 0, 'num_empty_links': 0, 'num_mailto_links': 0, 'num_javascript_links': 0, 'ratio_external_links': 0, 'num_ip_based_links': 0, # Script features (7) 'num_scripts': 0, 'num_inline_scripts': 0, 'num_external_scripts': 0, 'has_eval': 0, 'has_unescape': 0, 'has_escape': 0, 'has_document_write': 0, # Text features (7) 'text_length': 0, 'num_words': 0, 'num_brand_mentions': 0, 'num_urgency_keywords': 0, 'has_copyright': 0, 'has_phone_number': 0, 'has_email': 0, # Meta features (6) 'num_meta_tags': 0, 'num_css_files': 0, 'num_external_css': 0, 'num_external_images': 0, 'num_data_uri_images': 0, 'num_inline_styles': 0, 'inline_css_length': 0, 'has_favicon': 0, # Advanced phishing indicators (13) 'password_with_external_action': 0, 'has_base64': 0, 'has_atob': 0, 'has_fromcharcode': 0, 'num_onload_events': 0, 'num_onerror_events': 0, 'num_onclick_events': 0, 'num_unique_external_domains': 0, 'num_forms_without_labels': 0, 'has_display_none': 0, 'has_visibility_hidden': 0, 'has_window_open': 0, 'has_location_replace': 0, # Resource features (4) 'num_css_files': 0, 'num_external_css': 0, 'num_external_images': 0, 'num_data_uri_images': 0, } def get_feature_names(self): """Return list of all feature names.""" return list(self._get_default_features().keys()) def extract_features_from_file(html_file_path, url=None): """ Extract features from a single HTML file. Args: html_file_path: Path to HTML file url: Optional URL for context Returns: Dictionary of features """ extractor = HTMLFeatureExtractor() try: with open(html_file_path, 'r', encoding='utf-8', errors='ignore') as f: html_content = f.read() return extractor.extract_features(html_content, url) except Exception as e: print(f"Error reading file {html_file_path}: {e}") return extractor._get_default_features() if __name__ == '__main__': # Test with a sample HTML file import sys if len(sys.argv) > 1: html_file = sys.argv[1] features = extract_features_from_file(html_file) print(f"\nExtracted {len(features)} features from {html_file}:") print("-" * 80) for feature, value in features.items(): print(f"{feature:30s}: {value}") else: print("Usage: python html_features.py ") print("\nAvailable features:") extractor = HTMLFeatureExtractor() for i, feature in enumerate(extractor.get_feature_names(), 1): print(f"{i:2d}. {feature}") print(f"\nTotal: {len(extractor.get_feature_names())} features")