Contact Detail Formatter

WHAT IT DOES

Automatically detects and formats contact details (phone numbers, email addresses, physical addresses, and URLs) on web pages using country-specific formats. The script scans page text for potential phone numbers (international and local formats), email addresses, postal addresses, and URLs. It then validates and reformats them into standardized, consistent formats for easy copying and use. The panel displays detected contact details with their type (Phone/Email/Address/URL), the original text, the formatted version, and a status indicator. You can configure phone number formatting rules (E.164, international, or national formats). Click any formatted contact to copy it to your clipboard, and export results for contact extraction and auditing purposes. Per-page detection results are saved per URL or custom identifier.

WHERE IT RUNS

Works on all websites (match pattern *://*/*), making it perfect for business directories, contact pages, procurement portals, supplier databases, real estate listings, or any web page containing contact information. Each page gets its own independent detection results set, allowing you to scan and extract contacts across multiple contexts. Results are saved per page identifier, ensuring continuity across sessions and page reloads.

HOW TO USE

Install the script and the Contact Detail Formatter appears in the panel. Click "Scan Page" to scan the current page for contact details. The script detects phone numbers, email addresses, physical addresses, and URLs. Each contact is shown with a colored type badge (Phone/Email/URL/Address), the formatted version prominently displayed, and the original text shown below for reference. Click any formatted contact to copy it to your clipboard. Configure the phone format to E.164 (+1234567890), international (+1 234 567 8900), or national (123-456-7890) format. Use the export buttons to copy results as text or JSON for contact extraction and auditing. The script can auto-scan on page load if enabled.

REAL MECHANISM: MULTI-TYPE CONTACT DETECTION WITH INTELLIGENT FORMATTING ENGINE

This script uses a comprehensive contact detection engine that combines multiple pattern types and formatting logic. The extractContacts() function applies four separate detection patterns: phone numbers (using multiple regexes for international formats like +1 234 567 8900, US formats like (123) 456-7890, UK/EU formats like 01234 567890, and general 10-15 digit numbers), email addresses (RFC 5322-compliant regex), URLs (http/https and www patterns), and postal addresses (using keyword-based patterns for street addresses, PO Boxes, and addresses with ZIP codes). Phone number formatting is handled by formatPhoneNumber(), which extracts digits and applies formatting based on the user's selected setting: "international" adds country codes and groups digits (e.g., +1 234 567 8900), "e164" uses E.164 format (e.g., +1234567890), and "national" uses local formatting with hyphens (e.g., 123-456-7890). The function attempts to detect country codes from digit patterns, handling US (+1), UK (+44), Australian (+61), and generic European formats. Email formatting standardizes to lowercase. URL formatting ensures protocols are present (adding https:// if missing). All results are deduplicated using a Set to avoid duplicates. Each detected contact is stored with its id, type, raw text, formatted version, and valid status. The render function displays results with color-coded type badges (blue for phone, green for email, amber for URL, pink for address), click-to-copy formatted text with hover effects, and raw text shown in a smaller font for reference. Click-to-copy uses GM_setClipboard. Settings (phoneFormat, autoScan) are persisted via GM_setValue. All operations are reactive, with automatic persistence through saveContactResults() and re-render.

THE PANEL

Drag the panel anywhere on screen by clicking and holding the header. It snaps to screen edges when released. Collapse it to a small bubble by clicking the minimize button, and expand it back by clicking the bubble. Resize the panel from any corner. Press Escape to close the configuration panel. Your position and size preferences are saved automatically per site.

PLEASE NOTE

This script requires the free BotGentz browser extension which provides the BGPanel framework and storage APIs. All data (detected contacts, formats, and page identifiers) is stored locally in your browser using GM_setValue and never sent anywhere. No analytics, no tracking, no external calls. The script only reads the current page content to detect contact details and never accesses user data, passwords, or sensitive information. Detection is format-based only; the script does not verify phone numbers, email addresses, or physical addresses against external databases.