Publisher Scanner - Setup Guide

File Structure

publisher-scanner/ ├── index.html # Main application (all JS built in) ├── styles.css # Application styles ├── docs-readme.html # Quick start guide ├── docs-features.html # All features explained ├── docs-improvement.html # How to fix issues ├── docs-ai-patterns.html # AI pattern detection ├── docs-deployment.html # cPanel deployment steps └── docs-setup.html # This file

Quick Start (5 Minutes)

Download all files from the zip
Log into cPanel → File Manager → public_html
Upload all files and set permissions to 644
Visit your domain, go to Settings, and enter your Anthropic API key
Click Save Settings — you're ready to scan

Deployment Scenarios

🌐 Root Domain

Upload to /public_html/

Access at:
yourdomain.com/

📁 Subdirectory

Upload to /public_html/scanner/

Access at:
yourdomain.com/scanner/

🔗 Subdomain

Create subdomain in cPanel, upload to its public_html

Access at:
scanner.yourdomain.com/

API Key Setup

Where to get it: console.anthropic.com → API Keys → Create Key

Where to enter it: Publisher Scanner → Settings tab → Anthropic API Key field → Save Settings

Security: The key is stored only in your browser's localStorage. It is never transmitted to any server other than Anthropic's API directly.

Customization

Change Application Title

Edit index.html and find:

<title>Publisher Scanner - AI Content Quality & Compliance Auditor</title>

Customize Colors

Edit styles.css and modify the :root section:

:root {
    --primary: #0f172a;   /* Dark navy — navbar, headings */
    --accent:  #3b82f6;   /* Blue — buttons, links, active states */
    --success: #10b981;   /* Green — good scores */
    --warning: #f59e0b;   /* Amber — medium scores */
    --danger:  #ef4444;   /* Red — bad scores, risks */
}

Add Custom Branding

Update the brand title in the <nav> section of index.html
Change the brand subtitle below it
Update the footer copyright text
Modify color variables in styles.css to match your palette

Features Summary

Feature	Status	Notes
Domain scanner with 7 metrics	✅	AI-powered via Anthropic API
Page analysis (11 metrics/page)	✅	Correct domain URLs enforced
Thin content detector	✅	High/Medium/Low severity
Publisher approval checker	✅	AdSense/AdX standards
Internal linking analyzer	✅	Orphan page detection
Topical authority heatmap	✅	Chart.js visualization
AI pattern detector	✅	Detects AI-generated patterns
Revenue leak scanner	✅	CTR and CTA issues
Scan history (20 scans)	✅	localStorage, click to reload
CSV & JSON export	✅	Downloads page analysis data
Documentation dropdown	✅	6 linked HTML doc pages

Performance Metrics

Metric	Value
Application Load Time	< 1 second
Scan Time (live AI)	5–15 seconds
Memory Usage	< 50MB
Storage Per Scan	5–10KB
Max History	20 scans
Browser Support	All modern browsers

Maintenance

Backup

In cPanel File Manager: right-click your app folder → Compress → download the .zip. Store a dated copy locally (e.g., publisher-scanner-2026-05.zip).

Updating

Download new version of files
Backup current files first
Upload new files to same directory (overwrite)
Clear browser cache (Ctrl+Shift+Delete)
Verify the app loads and Settings still has your API key

Troubleshooting

App Won't Load

Check both index.html and styles.css are in the same directory
File permissions must be 644
File names are case-sensitive
Try incognito/private mode to rule out extension conflicts

API Key Not Saving

Do not use private/incognito mode — it disables localStorage
Make sure you clicked Save Settings (not just typed the key)
Check browser allows localStorage for your domain

Scan History Disappears

Not using private/incognito mode (which clears localStorage on close)
Check if browser privacy settings clear localStorage on exit
History is browser-specific — different browsers have separate histories

FAQ

Do I need a database?

No. Everything runs in the browser. Scan history is stored in browser localStorage (~5–10KB per scan).

Can multiple users use this?

Yes — each user's browser maintains its own separate localStorage, API key, and scan history.

Is my data secure?

Yes. Your API key and scan data never leave your browser except for the direct Anthropic API call that performs the analysis.

Can I use this on WordPress?

Yes — upload to a subdirectory (e.g., public_html/scanner/) and access it independently of WordPress.

How do I add real website crawling?

The current version uses AI knowledge of domains. For real crawling, you'd need a server-side component — this is a planned future enhancement.

← Back to Application

⚙️ Complete Setup Guide