@casoon/auditmysite
Version:
Professional website analysis suite with robust accessibility testing, Core Web Vitals performance monitoring, SEO analysis, and content optimization insights. Features isolated browser contexts, retry mechanisms, and comprehensive API endpoints for profe
1,061 lines • 46.2 kB
JavaScript
;
/**
* 🔍 Enhanced SEO Analyzer
*
* Comprehensive SEO analysis including:
* - Meta tags optimization
* - Heading structure validation
* - Social media meta tags
* - Technical SEO factors
* - Content quality analysis
* - Readability scoring
*/
Object.defineProperty(exports, "__esModule", { value: true });
exports.SEOAnalyzer = void 0;
const logging_1 = require("../core/logging");
class SEOAnalyzer {
constructor(options = {}) {
this.options = options;
}
/**
* Perform comprehensive SEO analysis of a webpage
*/
async analyzeSEO(page, url) {
// Extract URL string from URL object if needed
const urlString = (typeof url === 'object' && url.loc ? url.loc : url);
const startTime = Date.now();
try {
// Use already loaded content - navigation is handled by main test flow
// Skip navigation completely to preserve page context for comprehensive analysis
// Collect all SEO metrics in parallel
const [metaTags, headingStructure, socialTags, technicalSEO, contentMetrics] = await Promise.all([
this.analyzeMetaTags(page),
this.analyzeHeadingStructure(page),
this.options.includeSocialAnalysis ? this.analyzeSocialTags(page) : this.getDefaultSocialTags(),
this.options.includeTechnicalSEO ? this.analyzeTechnicalSEO(page, urlString) : this.getDefaultTechnicalSEO(),
this.analyzeContentQuality(page)
]);
// Get page content for advanced analysis
const pageContent = await page.evaluate(() => {
return {
textContent: document.body?.textContent || '',
title: document.title || ''
};
});
// Advanced SEO analysis
const semanticSEO = this.analyzeSemanticSEO(pageContent.textContent, pageContent.title);
const voiceSearchOptimization = this.analyzeVoiceSearchOptimization(pageContent.textContent, headingStructure);
const eatAnalysis = this.analyzeEAT(pageContent.textContent, metaTags);
const coreWebVitalsSEO = this.analyzeCoreWebVitalsSEOImpact(null); // Performance data would be passed if available
// Calculate SEO scores (including advanced metrics)
const overallSEOScore = this.calculateOverallSEOScore({
metaTags,
headingStructure,
socialTags,
technicalSEO,
...contentMetrics,
semanticSEO,
voiceSearchOptimization,
eatAnalysis,
coreWebVitalsSEO
});
const seoGrade = this.calculateSEOGrade(overallSEOScore);
const recommendations = this.generateSEORecommendations({
metaTags,
headingStructure,
socialTags,
technicalSEO,
...contentMetrics
});
const searchVisibility = this.estimateSearchVisibility(overallSEOScore, contentMetrics.wordCount);
const opportunityAreas = this.identifyOpportunityAreas({
metaTags,
headingStructure,
socialTags,
technicalSEO,
...contentMetrics
});
const seoMetrics = {
metaTags,
headingStructure,
socialTags,
technicalSEO,
wordCount: contentMetrics.wordCount,
readabilityScore: contentMetrics.readabilityScore,
contentQuality: contentMetrics.contentQuality,
contentUniqueness: contentMetrics.contentUniqueness,
overallSEOScore,
seoGrade,
recommendations,
searchVisibility,
opportunityAreas,
// Advanced SEO analysis results
semanticSEO,
voiceSearchOptimization,
eatAnalysis,
coreWebVitalsSEO
};
return seoMetrics;
}
catch (error) {
console.error('❌ SEO analysis failed:', error);
throw new Error(`SEO analysis failed: ${error}`);
}
}
/**
* Analyze meta tags
*/
async analyzeMetaTags(page) {
const metaData = await page.evaluate(() => {
const titleElement = document.querySelector('title');
const descriptionElement = document.querySelector('meta[name="description"]');
const keywordsElement = document.querySelector('meta[name="keywords"]');
const robotsElement = document.querySelector('meta[name="robots"]');
const canonicalElement = document.querySelector('link[rel="canonical"]');
const viewportElement = document.querySelector('meta[name="viewport"]');
return {
title: titleElement ? titleElement.textContent : null,
description: descriptionElement ? descriptionElement.getAttribute('content') : null,
keywords: keywordsElement ? keywordsElement.getAttribute('content') : null,
robots: robotsElement ? robotsElement.getAttribute('content') : null,
canonical: canonicalElement ? canonicalElement.getAttribute('href') : null,
viewport: viewportElement ? viewportElement.getAttribute('content') : null
};
});
// Analyze title tag
const titleAnalysis = {
present: !!metaData.title,
content: metaData.title || undefined,
length: metaData.title ? metaData.title.length : 0,
optimal: false,
issues: []
};
if (!metaData.title) {
titleAnalysis.issues.push('Title tag is missing');
}
else {
if (metaData.title.length < 30) {
titleAnalysis.issues.push('Title is too short (< 30 characters)');
}
else if (metaData.title.length > 60) {
titleAnalysis.issues.push('Title is too long (> 60 characters)');
}
else {
// Length is fine, now check for redundancy/repetition (e.g., "Brand - Brand")
const rawTitle = metaData.title.trim();
const sepRegex = /\s*[-|:•·—–]\s*/; // common separators
const parts = rawTitle.split(sepRegex).map(p => p.trim()).filter(Boolean);
let hasRepetition = false;
let repeatedSegment = '';
if (parts.length >= 2) {
const norm = (s) => s.replace(/\s+/g, ' ').toLowerCase();
const seen = new Set();
for (const p of parts) {
const n = norm(p);
if (seen.has(n)) {
hasRepetition = true;
repeatedSegment = p;
break;
}
seen.add(n);
}
// Special case: A - A (exact duplicate around a hyphen)
if (!hasRepetition && parts.length === 2 && norm(parts[0]) === norm(parts[1])) {
hasRepetition = true;
repeatedSegment = parts[0];
}
}
if (hasRepetition) {
titleAnalysis.issues.push(`Title contains repeated segment: "${repeatedSegment}"`);
titleAnalysis.optimal = false;
}
else {
titleAnalysis.optimal = true;
}
}
}
// Analyze description tag
const descriptionAnalysis = {
present: !!metaData.description,
content: metaData.description || undefined,
length: metaData.description ? metaData.description.length : 0,
optimal: false,
issues: []
};
if (!metaData.description) {
descriptionAnalysis.issues.push('Meta description is missing');
}
else {
if (metaData.description.length < 120) {
descriptionAnalysis.issues.push('Meta description is too short (< 120 characters)');
}
else if (metaData.description.length > 160) {
descriptionAnalysis.issues.push('Meta description is too long (> 160 characters)');
}
else {
descriptionAnalysis.optimal = true;
}
}
return {
title: titleAnalysis,
description: descriptionAnalysis,
keywords: metaData.keywords ? {
present: true,
content: metaData.keywords,
relevant: this.assessKeywordRelevance(metaData.keywords, metaData.title || '')
} : { present: false, relevant: false },
robots: metaData.robots ? {
present: true,
content: metaData.robots,
indexable: !metaData.robots.includes('noindex')
} : { present: false, indexable: true },
canonical: metaData.canonical ? {
present: true,
url: metaData.canonical,
valid: this.isValidUrl(metaData.canonical)
} : { present: false, valid: false },
viewport: metaData.viewport ? {
present: true,
mobileOptimized: metaData.viewport.includes('width=device-width')
} : { present: false, mobileOptimized: false }
};
}
/**
* Analyze heading structure
*/
async analyzeHeadingStructure(page) {
const headingData = await page.evaluate(() => {
const h1s = document.querySelectorAll('h1');
const h2s = document.querySelectorAll('h2');
const h3s = document.querySelectorAll('h3');
const h4s = document.querySelectorAll('h4');
const h5s = document.querySelectorAll('h5');
const h6s = document.querySelectorAll('h6');
// Get heading hierarchy
const allHeadings = Array.from(document.querySelectorAll('h1, h2, h3, h4, h5, h6'));
const headingLevels = allHeadings.map(h => parseInt(h.tagName.charAt(1)));
return {
h1Count: h1s.length,
h2Count: h2s.length,
h3Count: h3s.length,
h4Count: h4s.length,
h5Count: h5s.length,
h6Count: h6s.length,
headingLevels,
h1Text: h1s.length > 0 ? Array.from(h1s).map(h => h.textContent || '').join(' | ') : ''
};
});
// Validate heading structure
const issues = [];
let structureValid = true;
if (headingData.h1Count === 0) {
issues.push('No H1 tag found');
structureValid = false;
}
else if (headingData.h1Count > 1) {
issues.push(`Multiple H1 tags found (${headingData.h1Count})`);
structureValid = false;
}
// Check hierarchy
if (headingData.headingLevels.length > 1) {
for (let i = 1; i < headingData.headingLevels.length; i++) {
const current = headingData.headingLevels[i];
const previous = headingData.headingLevels[i - 1];
if (current > previous + 1) {
issues.push(`Heading hierarchy skips levels (H${previous} followed by H${current})`);
structureValid = false;
}
}
}
if (headingData.h2Count === 0 && headingData.h1Count > 0) {
issues.push('H1 exists but no H2 tags found - consider adding subheadings');
}
return {
h1Count: headingData.h1Count,
h2Count: headingData.h2Count,
h3Count: headingData.h3Count,
h4Count: headingData.h4Count,
h5Count: headingData.h5Count,
h6Count: headingData.h6Count,
structureValid,
issues
};
}
/**
* Analyze social media meta tags
*/
async analyzeSocialTags(page) {
const socialData = await page.evaluate(() => {
// Open Graph tags
const ogTitle = document.querySelector('meta[property="og:title"]');
const ogDescription = document.querySelector('meta[property="og:description"]');
const ogImage = document.querySelector('meta[property="og:image"]');
const ogUrl = document.querySelector('meta[property="og:url"]');
const ogType = document.querySelector('meta[property="og:type"]');
const ogSiteName = document.querySelector('meta[property="og:site_name"]');
const ogLocale = document.querySelector('meta[property="og:locale"]');
// Twitter Card tags
const twitterCard = document.querySelector('meta[name="twitter:card"]');
const twitterTitle = document.querySelector('meta[name="twitter:title"]');
const twitterDescription = document.querySelector('meta[name="twitter:description"]');
const twitterImage = document.querySelector('meta[name="twitter:image"]');
const twitterSite = document.querySelector('meta[name="twitter:site"]');
const twitterCreator = document.querySelector('meta[name="twitter:creator"]');
return {
og: {
title: ogTitle ? ogTitle.getAttribute('content') : undefined,
description: ogDescription ? ogDescription.getAttribute('content') : undefined,
image: ogImage ? ogImage.getAttribute('content') : undefined,
url: ogUrl ? ogUrl.getAttribute('content') : undefined,
type: ogType ? ogType.getAttribute('content') : undefined,
siteName: ogSiteName ? ogSiteName.getAttribute('content') : undefined,
locale: ogLocale ? ogLocale.getAttribute('content') : undefined
},
twitter: {
card: twitterCard ? twitterCard.getAttribute('content') : undefined,
title: twitterTitle ? twitterTitle.getAttribute('content') : undefined,
description: twitterDescription ? twitterDescription.getAttribute('content') : undefined,
image: twitterImage ? twitterImage.getAttribute('content') : undefined,
site: twitterSite ? twitterSite.getAttribute('content') : undefined,
creator: twitterCreator ? twitterCreator.getAttribute('content') : undefined
}
};
});
// Calculate completeness score
const ogFields = Object.keys(socialData.og).filter(key => socialData.og[key]);
const twitterFields = Object.keys(socialData.twitter).filter(key => socialData.twitter[key]);
const totalFields = 13; // 7 OG + 6 Twitter
const completenessScore = Math.round(((ogFields.length + twitterFields.length) / totalFields) * 100);
return {
openGraph: {
title: socialData.og.title || undefined,
description: socialData.og.description || undefined,
image: socialData.og.image || undefined,
url: socialData.og.url || undefined,
type: socialData.og.type || undefined,
siteName: socialData.og.siteName || undefined,
locale: socialData.og.locale || undefined,
},
twitterCard: {
card: socialData.twitter.card || undefined,
title: socialData.twitter.title || undefined,
description: socialData.twitter.description || undefined,
image: socialData.twitter.image || undefined,
site: socialData.twitter.site || undefined,
creator: socialData.twitter.creator || undefined,
},
completenessScore
};
}
/**
* Analyze technical SEO factors
*/
async analyzeTechnicalSEO(page, url) {
// Check if page context is still valid before proceeding
try {
await page.title(); // Quick test to see if context is still valid
}
catch (error) {
// Always show this fallback - indicates page context issues that need investigation
logging_1.log.fallback('Technical SEO', 'page context unavailable', 'using minimal data');
return this.getFallbackTechnicalSEO(url);
}
let technicalData;
try {
technicalData = await page.evaluate(() => {
const links = Array.from(document.querySelectorAll('a[href]'));
const internalLinks = links.filter(link => {
const href = link.getAttribute('href');
return href && (href.startsWith('/') || href.includes(window.location.hostname));
});
const externalLinks = links.filter(link => {
const href = link.getAttribute('href');
return href && !href.startsWith('/') && !href.includes(window.location.hostname) && href.startsWith('http');
});
// Check for schema markup
const schemaScripts = Array.from(document.querySelectorAll('script[type="application/ld+json"]'));
const schemaTypes = schemaScripts.map(script => {
try {
const data = JSON.parse(script.textContent || '');
return data['@type'] || 'Unknown';
}
catch {
return 'Invalid';
}
});
return {
internalLinkCount: internalLinks.length,
externalLinkCount: externalLinks.length,
schemaTypes,
allLinks: links.map(link => link.getAttribute('href')).filter((href) => href !== null)
};
});
}
catch (error) {
// Always show this fallback - indicates technical SEO evaluation issues
logging_1.log.fallback('Technical SEO', 'page evaluation failed', 'using minimal data', error);
return this.getFallbackTechnicalSEO(url);
}
// Enhanced Technical SEO Analysis
const httpsEnabled = url.startsWith('https://');
const domain = new URL(url).origin;
// Analyze page structure and technical elements
const technicalAnalysis = await page.evaluate(() => {
const viewport = document.querySelector('meta[name="viewport"]');
const charset = document.querySelector('meta[charset]');
const language = document.documentElement.lang;
// Check for duplicate content indicators
const canonicalLinks = Array.from(document.querySelectorAll('link[rel="canonical"]'));
const metaRobots = document.querySelector('meta[name="robots"]');
// Analyze images
const images = Array.from(document.querySelectorAll('img'));
const imagesWithoutAlt = images.filter(img => !img.getAttribute('alt')).length;
const imagesWithoutTitle = images.filter(img => !img.getAttribute('title')).length;
// Check for accessibility and SEO indicators
const hasSkipLinks = document.querySelectorAll('a[href^="#main"], a[href^="#content"]').length > 0;
const hasLangAttribute = !!language;
// Analyze text-to-HTML ratio
const textContent = document.body?.textContent || '';
const htmlContent = document.body?.innerHTML || '';
const textToHtmlRatio = htmlContent.length > 0 ? (textContent.length / htmlContent.length) * 100 : 0;
return {
hasViewport: !!viewport,
viewportContent: viewport?.getAttribute('content') || '',
hasCharset: !!charset,
charsetValue: charset?.getAttribute('charset') || '',
hasLang: hasLangAttribute,
langValue: language || '',
canonicalCount: canonicalLinks.length,
canonicalUrl: canonicalLinks[0]?.getAttribute('href') || '',
robotsDirective: metaRobots?.getAttribute('content') || '',
totalImages: images.length,
imagesWithoutAlt,
imagesWithoutTitle,
hasSkipLinks,
textToHtmlRatio: Math.round(textToHtmlRatio)
};
});
// Advanced schema markup analysis
const schemaAnalysis = this.analyzeSchemaMarkup(technicalData.schemaTypes);
// Link analysis
const linkAnalysis = this.analyzeLinkStructure(technicalData.internalLinkCount, technicalData.externalLinkCount, technicalData.allLinks);
// Page speed estimation (would be enhanced with actual metrics)
const pageSpeedScore = 75;
let mobileFriendly = technicalAnalysis.hasViewport &&
technicalAnalysis.viewportContent.includes('width=device-width');
try {
// More robust check - first verify page context is still valid
await page.title(); // Quick context check
mobileFriendly = await page.evaluate(() => {
const viewport = document.querySelector('meta[name="viewport"]');
return !!(viewport && viewport.getAttribute('content')?.includes('width=device-width'));
});
}
catch (error) {
logging_1.log.fallback('SEO Mobile Check', 'page context destroyed during check', 'assuming mobile-unfriendly', error);
mobileFriendly = false;
}
// Check for broken links (simplified)
const brokenLinks = 0; // In real implementation, would test each link
return {
httpsEnabled,
mobileFriendly,
pageSpeedScore,
schemaMarkup: technicalData.schemaTypes,
linkAnalysis,
sitemapPresent: false, // Would be enhanced with actual HTTP request
robotsTxtPresent: false // Would be enhanced with actual HTTP request
};
}
/**
* Analyze content quality including images and alt text
*/
async analyzeContentQuality(page) {
const contentData = await page.evaluate(() => {
const bodyText = document.body?.innerText || '';
const words = bodyText.trim().split(/\s+/).filter(word => word.length > 0);
const sentences = bodyText.split(/[.!?]+/).filter(s => s.trim().length > 0);
const paragraphs = bodyText.split(/\n\s*\n/).filter(p => p.trim().length > 0);
// Calculate average words per sentence
const avgWordsPerSentence = sentences.length > 0 ? words.length / sentences.length : 0;
// Calculate average syllables per word (simplified)
const avgSyllablesPerWord = 1.5; // Simplified: average English word has ~1.5 syllables
// NEW: Analyze images and alt text
const images = document.querySelectorAll('img');
let imagesWithAlt = 0;
let imagesWithoutAlt = 0;
let emptyAltImages = 0;
let decorativeImages = 0;
images.forEach(img => {
const alt = img.getAttribute('alt');
if (alt === null) {
// No alt attribute at all
imagesWithoutAlt++;
}
else if (alt.trim() === '') {
// Empty alt (decorative image)
emptyAltImages++;
decorativeImages++;
}
else {
// Has meaningful alt text
imagesWithAlt++;
}
});
console.log(`🖼️ SEO Image Analysis: ${images.length} total images, ${imagesWithAlt} with alt, ${imagesWithoutAlt} missing alt, ${emptyAltImages} empty alt`);
return {
wordCount: words.length,
sentenceCount: sentences.length,
paragraphCount: paragraphs.length,
avgWordsPerSentence,
avgSyllablesPerWord,
fullText: bodyText,
// Image analysis results
imageAnalysis: {
totalImages: images.length,
imagesWithAlt,
imagesWithoutAlt,
emptyAltImages,
decorativeImages
}
};
});
// Calculate Flesch Reading Ease Score (simplified)
const readabilityScore = this.calculateReadabilityScore(contentData.avgWordsPerSentence, contentData.avgSyllablesPerWord);
// Determine content quality
let contentQuality;
if (contentData.wordCount < 300) {
contentQuality = 'poor';
}
else if (contentData.wordCount < 500) {
contentQuality = 'fair';
}
else if (contentData.wordCount < 1000) {
contentQuality = 'good';
}
else {
contentQuality = 'excellent';
}
// Estimate content uniqueness (simplified - would need external API for real analysis)
const contentUniqueness = Math.min(100, Math.max(60, 80 + Math.random() * 20));
// Add keyword analysis
const title = contentData.fullText.split('\n')[0] || ''; // Simple title extraction
const keywordAnalysis = this.analyzeKeywordDensity(contentData.fullText, title);
return {
wordCount: contentData.wordCount,
readabilityScore,
contentQuality,
contentUniqueness,
imageAnalysis: contentData.imageAnalysis
};
}
/**
* Calculate overall SEO score
*/
calculateOverallSEOScore(seoData) {
let score = 100;
// Meta tags scoring (30%)
if (!seoData.metaTags.title.present)
score -= 15;
else if (!seoData.metaTags.title.optimal)
score -= 5;
if (!seoData.metaTags.description.present)
score -= 15;
else if (!seoData.metaTags.description.optimal)
score -= 5;
// Heading structure scoring (20%)
if (!seoData.headingStructure.structureValid)
score -= 10;
if (seoData.headingStructure.h1Count !== 1)
score -= 10;
// Technical SEO scoring (25%)
if (!seoData.technicalSEO.httpsEnabled)
score -= 5;
if (!seoData.technicalSEO.mobileFriendly)
score -= 10;
if (seoData.technicalSEO.schemaMarkup.length === 0)
score -= 5;
if (seoData.technicalSEO.linkAnalysis.internalLinks === 0)
score -= 5;
// Content quality scoring (25%)
if (seoData.wordCount < 300)
score -= 15;
else if (seoData.wordCount < 500)
score -= 10;
else if (seoData.wordCount < 800)
score -= 5;
if (seoData.readabilityScore < 30)
score -= 10;
else if (seoData.readabilityScore < 50)
score -= 5;
// Advanced SEO features scoring (10%)
if (seoData.semanticSEO) {
// Add points for good semantic analysis
if (seoData.semanticSEO.semanticScore > 70)
score += 3;
if (seoData.semanticSEO.contentDepthScore > 80)
score += 2;
}
if (seoData.voiceSearchOptimization) {
// Add points for voice search optimization
if (seoData.voiceSearchOptimization.voiceSearchScore > 60)
score += 2;
if (seoData.voiceSearchOptimization.conversationalContent)
score += 1;
}
if (seoData.eatAnalysis) {
// Add points for E-A-T signals
if (seoData.eatAnalysis.eatScore > 70)
score += 3;
if (seoData.eatAnalysis.authorPresence)
score += 1;
}
return Math.max(0, Math.min(100, score));
}
/**
* Calculate SEO grade from score
*/
calculateSEOGrade(score) {
if (score >= 90)
return 'A';
if (score >= 80)
return 'B';
if (score >= 70)
return 'C';
if (score >= 60)
return 'D';
return 'F';
}
/**
* Generate SEO recommendations
*/
generateSEORecommendations(seoData) {
const recommendations = [];
// Title recommendations
if (!seoData.metaTags.title.present) {
recommendations.push('📝 Add a title tag to your page');
}
else if (!seoData.metaTags.title.optimal) {
recommendations.push(`📏 Optimize title length (current: ${seoData.metaTags.title.length} chars, optimal: 30-60)`);
}
// Description recommendations
if (!seoData.metaTags.description.present) {
recommendations.push('📄 Add a meta description to your page');
}
else if (!seoData.metaTags.description.optimal) {
recommendations.push(`📝 Optimize meta description length (current: ${seoData.metaTags.description.length} chars, optimal: 120-160)`);
}
// Heading structure recommendations
if (seoData.headingStructure.h1Count === 0) {
recommendations.push('🏷️ Add an H1 tag for better content hierarchy');
}
else if (seoData.headingStructure.h1Count > 1) {
recommendations.push('🏷️ Use only one H1 tag per page');
}
if (seoData.headingStructure.issues.length > 0) {
recommendations.push(`🔧 Fix heading structure: ${seoData.headingStructure.issues.join(', ')}`);
}
// Technical SEO recommendations
if (!seoData.technicalSEO.httpsEnabled) {
recommendations.push('🔒 Enable HTTPS for better security and SEO');
}
if (!seoData.technicalSEO.mobileFriendly) {
recommendations.push('📱 Make your site mobile-friendly with responsive design');
}
if (seoData.technicalSEO.schemaMarkup.length === 0) {
recommendations.push('📋 Add structured data (schema.org) for better search results');
}
// Content recommendations
if (seoData.wordCount < 300) {
recommendations.push(`📖 Add more content (current: ${seoData.wordCount} words, recommended: 300+)`);
}
if (seoData.readabilityScore < 50) {
recommendations.push('📚 Improve content readability with shorter sentences and simpler words');
}
// Social media recommendations
if (seoData.socialTags.completenessScore < 50) {
recommendations.push('📱 Add Open Graph and Twitter Card tags for better social media sharing');
}
return recommendations;
}
/**
* Analyze schema markup in detail
*/
analyzeSchemaMarkup(schemaTypes) {
const recommendations = [];
let score = 0;
if (schemaTypes.length === 0) {
recommendations.push('Add structured data (JSON-LD) for better search results');
score = 0;
}
else {
score = Math.min(100, schemaTypes.length * 25);
// Check for common schema types
const commonTypes = ['Organization', 'LocalBusiness', 'Product', 'Article', 'BlogPosting'];
const hasCommonTypes = schemaTypes.some(type => commonTypes.includes(type));
if (!hasCommonTypes) {
recommendations.push('Consider adding common schema types like Organization, Article, or Product');
}
}
return {
present: schemaTypes.length > 0,
types: schemaTypes,
score,
recommendations
};
}
/**
* Analyze link structure for SEO
*/
analyzeLinkStructure(internalCount, externalCount, allLinks) {
const recommendations = [];
const totalLinks = internalCount + externalCount;
const linkRatio = totalLinks > 0 ? (internalCount / totalLinks) * 100 : 0;
if (internalCount === 0) {
recommendations.push('Add internal links to improve site structure and SEO');
}
else if (internalCount < 3) {
recommendations.push('Consider adding more internal links for better navigation');
}
if (externalCount > internalCount * 2) {
recommendations.push('Too many external links - consider reducing or adding more internal links');
}
if (totalLinks === 0) {
recommendations.push('Add both internal and external links to provide value to users');
}
return {
internalLinks: internalCount,
externalLinks: externalCount,
linkRatio: Math.round(linkRatio),
brokenLinks: 0, // Would be enhanced with actual link checking
recommendations
};
}
/**
* Enhanced keyword density analysis
*/
analyzeKeywordDensity(text, title) {
const words = text.toLowerCase().split(/\s+/).filter(word => word.length > 3 && !/^\d+$/.test(word));
const wordFrequency = {};
words.forEach(word => {
const cleanWord = word.replace(/[^a-zA-Z0-9]/g, '');
if (cleanWord.length > 3) {
wordFrequency[cleanWord] = (wordFrequency[cleanWord] || 0) + 1;
}
});
const topKeywords = Object.entries(wordFrequency)
.sort(([, a], [, b]) => b - a)
.slice(0, 10)
.map(([word, count]) => ({
word,
count,
density: Math.round((count / words.length) * 10000) / 100
}));
// Analyze title-content keyword overlap
const titleWords = title.toLowerCase().split(/\s+/);
const overlap = titleWords.filter(word => text.toLowerCase().includes(word) && word.length > 3).length;
const titleKeywordOverlap = titleWords.length > 0 ? (overlap / titleWords.length) * 100 : 0;
const recommendations = [];
if (titleKeywordOverlap < 30) {
recommendations.push('Improve keyword consistency between title and content');
}
const highDensityKeywords = topKeywords.filter(kw => kw.density > 3);
if (highDensityKeywords.length > 0) {
recommendations.push('Some keywords may be over-optimized (density > 3%)');
}
return {
topKeywords,
titleKeywordOverlap: Math.round(titleKeywordOverlap),
recommendations
};
}
/**
* Analyze semantic SEO and content depth
*/
analyzeSemanticSEO(content, title) {
const words = content.toLowerCase().split(/\s+/).filter(word => word.length > 3);
const recommendations = [];
// Topic clustering (simplified)
const topicClusters = this.identifyTopicClusters(words);
// LSI keyword detection
const lsiKeywords = this.extractLSIKeywords(words, title);
// Content depth scoring
let contentDepthScore = 50;
if (words.length > 1500)
contentDepthScore += 30;
if (topicClusters.length > 3)
contentDepthScore += 10;
if (lsiKeywords.length > 8)
contentDepthScore += 10;
// Semantic relevance scoring
const semanticScore = this.calculateSemanticScore(words, title, topicClusters);
// Recommendations
if (contentDepthScore < 60) {
recommendations.push('Add more comprehensive content to improve topic coverage');
}
if (lsiKeywords.length < 5) {
recommendations.push('Include more semantically related keywords (LSI)');
}
if (topicClusters.length < 2) {
recommendations.push('Expand content to cover related topics and subtopics');
}
return {
semanticScore: Math.min(100, semanticScore),
topicClusters,
contentDepthScore: Math.min(100, contentDepthScore),
lsiKeywords,
recommendations
};
}
/**
* Analyze Core Web Vitals SEO impact
*/
analyzeCoreWebVitalsSEOImpact(performanceData) {
const vitalsCritical = [];
const seoRecommendations = [];
let seoImpactScore = 100;
// LCP impact on SEO
if (performanceData?.lcp > 2500) {
seoImpactScore -= 25;
vitalsCritical.push('LCP (Largest Contentful Paint)');
seoRecommendations.push('Optimize LCP for better search rankings - current: ' + performanceData.lcp + 'ms');
}
// CLS impact on SEO
if (performanceData?.cls > 0.1) {
seoImpactScore -= 20;
vitalsCritical.push('CLS (Cumulative Layout Shift)');
seoRecommendations.push('Reduce layout shifts - current CLS: ' + performanceData.cls);
}
// FCP impact
if (performanceData?.fcp > 1800) {
seoImpactScore -= 15;
seoRecommendations.push('Improve First Contentful Paint for better user experience');
}
return {
seoImpactScore: Math.max(0, seoImpactScore),
vitalsCritical,
seoRecommendations
};
}
/**
* Analyze voice search optimization potential
*/
analyzeVoiceSearchOptimization(content, headings) {
const recommendations = [];
let voiceSearchScore = 0;
// Count question-based content
const questionWords = ['what', 'how', 'why', 'when', 'where', 'who'];
const questionPhrases = questionWords.reduce((count, word) => {
const regex = new RegExp(`\\b${word}\\b`, 'gi');
return count + (content.match(regex) || []).length;
}, 0);
// Check for conversational tone
const conversationalIndicators = ['you', 'your', 'we', 'our', 'let\'s', 'here\'s'];
const conversationalCount = conversationalIndicators.reduce((count, word) => {
const regex = new RegExp(`\\b${word}\\b`, 'gi');
return count + (content.match(regex) || []).length;
}, 0);
const conversationalContent = conversationalCount > content.split(' ').length * 0.02;
// Calculate score
if (questionPhrases > 5)
voiceSearchScore += 30;
if (conversationalContent)
voiceSearchScore += 25;
if (headings?.h2?.length > 2)
voiceSearchScore += 20; // FAQ-style headings
// Recommendations
if (questionPhrases < 3) {
recommendations.push('Add more question-based content for voice search optimization');
}
if (!conversationalContent) {
recommendations.push('Use more conversational tone to match voice search queries');
}
return {
voiceSearchScore: Math.min(100, voiceSearchScore),
questionPhrases,
conversationalContent,
recommendations
};
}
/**
* Analyze E-A-T (Expertise, Authoritativeness, Trustworthiness)
*/
analyzeEAT(content, metaTags) {
const expertiseIndicators = [];
const trustSignals = [];
const recommendations = [];
let eatScore = 50;
// Author presence
const authorPresence = content.toLowerCase().includes('author') ||
content.toLowerCase().includes('by:') ||
metaTags?.author !== undefined;
if (authorPresence) {
eatScore += 20;
expertiseIndicators.push('Author attribution found');
}
else {
recommendations.push('Add clear author attribution for better E-A-T');
}
// Trust signals
const trustWords = ['research', 'study', 'expert', 'professional', 'certified', 'verified'];
trustWords.forEach(word => {
if (content.toLowerCase().includes(word)) {
trustSignals.push(word);
eatScore += 5;
}
});
// Expertise indicators
const expertiseWords = ['years of experience', 'degree', 'certification', 'award', 'published'];
expertiseWords.forEach(word => {
if (content.toLowerCase().includes(word)) {
expertiseIndicators.push(word);
eatScore += 5;
}
});
if (trustSignals.length === 0) {
recommendations.push('Add trust signals (research, certifications, awards)');
}
if (expertiseIndicators.length < 2) {
recommendations.push('Include more expertise indicators to establish authority');
}
return {
eatScore: Math.min(100, eatScore),
authorPresence,
expertiseIndicators,
trustSignals,
recommendations
};
}
// Helper methods for semantic analysis
identifyTopicClusters(words) {
// Simplified topic clustering using word co-occurrence
const wordFreq = {};
words.forEach(word => {
if (word.length > 4) { // Only meaningful words
wordFreq[word] = (wordFreq[word] || 0) + 1;
}
});
return Object.entries(wordFreq)
.filter(([, freq]) => freq > 2)
.sort(([, a], [, b]) => b - a)
.slice(0, 8)
.map(([word]) => word);
}
extractLSIKeywords(words, title) {
// Simplified LSI keyword extraction
const titleWords = title.toLowerCase().split(/\s+/);
const contextualWords = words.filter(word => {
return word.length > 4 &&
!titleWords.includes(word) &&
words.filter(w => w === word).length > 1;
});
return [...new Set(contextualWords)].slice(0, 10);
}
calculateSemanticScore(words, title, topicClusters) {
let score = 50;
// Title-content semantic alignment
const titleWords = title.toLowerCase().split(/\s+/);
const alignment = titleWords.filter(word => words.includes(word) || topicClusters.includes(word)).length / titleWords.length;
score += alignment * 30;
// Topic coverage depth
score += Math.min(20, topicClusters.length * 3);
return Math.round(score);
}
/**
* Estimate search visibility based on SEO score
*/
estimateSearchVisibility(seoScore, wordCount) {
let visibility = seoScore * 0.7; // Base on SEO score
// Adjust for content length
if (wordCount > 1000)
visibility += 10;
else if (wordCount < 300)
visibility -= 20;
return Math.max(0, Math.min(100, visibility));
}
/**
* Identify key opportunity areas for improvement
*/
identifyOpportunityAreas(seoData) {
const opportunities = [];
if (!seoData.metaTags.title.optimal)
opportunities.push('Title Optimization');
if (!seoData.metaTags.description.optimal)
opportunities.push('Meta Description');
if (!seoData.headingStructure.structureValid)
opportunities.push('Content Structure');
if (seoData.socialTags.completenessScore < 70)
opportunities.push('Social Media Tags');
if (!seoData.technicalSEO.mobileFriendly)
opportunities.push('Mobile Optimization');
if (seoData.wordCount < 500)
opportunities.push('Content Depth');
if (seoData.readabilityScore < 50)
opportunities.push('Content Readability');
return opportunities;
}
/**
* Helper methods
*/
assessKeywordRelevance(keywords, title) {
if (!keywords || !title)
return false;
const keywordList = keywords.toLowerCase().split(',').map(k => k.trim());
const titleWords = title.toLowerCase().split(/\s+/);
return keywordList.some(keyword => titleWords.some(word => word.includes(keyword)));
}
isValidUrl(url) {
try {
new URL(url);
return true;
}
catch {
return false;
}
}
calculateReadabilityScore(avgWordsPerSentence, avgSyllablesPerWord) {
// Simplified Flesch Reading Ease Score
// Score = 206.835 - 1.015 × (average words per sentence) - 84.6 × (average syllables per word)
const score = 206.835 - (1.015 * avgWordsPerSentence) - (84.6 * avgSyllablesPerWord);
return Math.max(0, Math.min(100, score));
}
getDefaultSocialTags() {
return {
openGraph: {},
twitterCard: {},
completenessScore: 0
};
}
getFallbackTechnicalSEO(url) {
return {
httpsEnabled: url.startsWith('https://'),
sitemapPresent: false,
robotsTxtPresent: false,
schemaMarkup: [],
pageSpeedScore: 75, // Default score when can't measure
mobileFriendly: true, // Assume modern sites are mobile-friendly
linkAnalysis: {
internalLinks: 0,
externalLinks: 0,
brokenLinks: 0
}
};
}
getDefaultTechnicalSEO() {
return {
httpsEnabled: false,
sitemapPresent: false,
robotsTxtPresent: false,
schemaMarkup: [],
pageSpeedScore: 0,
mobileFriendly: false,
linkAnalysis: {
internalLinks: 0,
externalLinks: 0,
brokenLinks: 0
}
};
}
}
exports.SEOAnalyzer = SEOAnalyzer;
//# sourceMappingURL=seo-analyzer.js.map