recker 1.0.73 → 1.0.75-next.a400152

package/dist/seo/analyzer.js

@@ -1,7 +1,7 @@
 import { parse } from '../scrape/parser/index.js';
 import { extractMeta, extractOpenGraph, extractTwitterCard, extractJsonLd, extractLinks, extractImages, } from '../scrape/extractors.js';
 import { generateKeywordCloud } from './keywords.js';
-import { createRulesEngine, SEO_THRESHOLDS, } from './rules/index.js';
+import { createRulesEngine, SEO_THRESHOLDS, calculateWeightedScore, } from './rules/index.js';
 export class SeoAnalyzer {
     root;
     options;
@@ -47,7 +47,9 @@ export class SeoAnalyzer {
         const analytics = this.analyzeAnalytics();
         const feeds = this.analyzeFeeds();
         const conversion = this.analyzeConversionElements(links, visibleText);
+        const pageType = this.detectPageType(jsonLd);
         const context = this.buildRuleContext({
+            pageType,
             meta,
             og,
             twitter,
@@ -68,7 +70,7 @@ export class SeoAnalyzer {
         });
         const ruleResults = this.rulesEngine.evaluate(context);
         const checks = this.convertToCheckResults(ruleResults);
-        const { score, grade } = this.calculateScore(checks);
+        const { score, grade } = this.calculateScore(ruleResults);
         const summary = this.buildSummary(ruleResults, checks, {
             content,
             imageAnalysis,
@@ -77,13 +79,17 @@ export class SeoAnalyzer {
             og,
             twitter,
             technical,
+            pageType,
+            timings: this.options.timings,
         });
         return {
             url,
             timestamp: new Date(),
             grade,
             score,
+            timing: this.options.timings,
             summary,
+            pageType,
             checks,
             title: meta.title
                 ? { text: meta.title, length: meta.title.length }
@@ -134,6 +140,47 @@ export class SeoAnalyzer {
             return bodies[0];
         return bodies.reduce((prev, curr) => curr.text.length > prev.text.length ? curr : prev);
     }
+    detectPageType(jsonLd) {
+        if (!this.options.baseUrl) {
+            return 'other';
+        }
+        try {
+            const parsed = new URL(this.options.baseUrl);
+            const pathname = parsed.pathname.toLowerCase();
+            const hasQueryKeyword = (value) => parsed.searchParams.has(value);
+            if (pathname === '/' || pathname === '') {
+                return 'homepage';
+            }
+            if (/(^|\/)(search|busca|s|results|query)\b/.test(pathname) ||
+                hasQueryKeyword('q') ||
+                hasQueryKeyword('query') ||
+                hasQueryKeyword('search')) {
+                return 'search';
+            }
+            const productSignals = ['product', 'produto', 'item', 'sku', 'shop'];
+            if (productSignals.some((segment) => pathname.includes(`/${segment}/`))) {
+                return 'product';
+            }
+            const articleSignals = ['article', 'post', 'blog', 'noticia', 'news'];
+            if (articleSignals.some((segment) => pathname.includes(`/${segment}/`)) ||
+                this.root.querySelectorAll('article').length > 0) {
+                return 'article';
+            }
+            if (/(^|\/)(categoria|category|tag|section|topic)\b/.test(pathname)) {
+                return 'category';
+            }
+            const hasProductJsonLd = jsonLd
+                .map((node) => node['@type'])
+                .some((type) => typeof type === 'string' && type.toLowerCase() === 'product');
+            if (hasProductJsonLd) {
+                return 'product';
+            }
+            return 'other';
+        }
+        catch {
+            return 'other';
+        }
+    }
     getVisibleText() {
         const body = this.getMainBody();
         if (!body)
@@ -159,7 +206,7 @@ export class SeoAnalyzer {
         return clone.text.replace(/\s+/g, ' ').trim();
     }
     buildRuleContext(data) {
-        const { meta, og, twitter, jsonLd, headings, content, linkAnalysis, imageAnalysis, links, keywords, resources, emailsFound, socialLinksFound, socialLinkDetails, analytics, feeds, conversion, } = data;
+        const { meta, og, twitter, jsonLd, headings, content, pageType, linkAnalysis, imageAnalysis, links, keywords, resources, emailsFound, socialLinksFound, socialLinkDetails, analytics, feeds, conversion, } = data;
         const html = this.root.querySelector('html');
         const htmlLang = html ? html.getAttribute('lang') : undefined;
         const hreflangTags = [];
@@ -198,7 +245,6 @@ export class SeoAnalyzer {
         const hasMixedContent = this.checkMixedContent();
         const h1Elements = this.root.querySelectorAll('h1');
         const h1Text = h1Elements.length > 0 ? h1Elements[0].text.trim() : '';
-        const iframeCount = this.root.querySelectorAll('iframe').length;
         const topKeywords = keywords.topKeywords.slice(0, 5).map(k => k.word);
         const mainKeyword = topKeywords.length > 0 ? topKeywords[0] : undefined;
         const keywordsInTitle = topKeywords.some(kw => meta.title?.toLowerCase().includes(kw));
@@ -234,7 +280,6 @@ export class SeoAnalyzer {
         const structuralHtml = this.analyzeStructuralHtml();
         const breadcrumbs = this.analyzeBreadcrumbs(jsonLd.map((j) => j['@type']).filter(Boolean));
         const multimedia = this.analyzeMultimedia();
-        const advancedImages = this.analyzeAdvancedImages();
         const responsiveImages = this.analyzeResponsiveImages();
         const inlineImages = this.analyzeInlineImages();
         const trustSignals = this.analyzeTrustSignals(links);
@@ -245,6 +290,7 @@ export class SeoAnalyzer {
             : 0;
         const textHtmlRatio = this.calculateTextHtmlRatio(content.characterCount);
         return {
+            pageType,
             jsFilesCount: resources.jsFilesCount,
             cssFilesCount: resources.cssFilesCount,
             unminifiedResources: resources.unminifiedResources,
@@ -774,7 +820,6 @@ export class SeoAnalyzer {
     }
     analyzeAnalytics() {
         const providers = [];
-        const html = this.root.innerHTML || '';
         const scripts = this.root.querySelectorAll('script');
         const scriptSources = [];
         const scriptContents = [];
@@ -899,21 +944,6 @@ export class SeoAnalyzer {
             hasPhoneOnPage,
         };
     }
-    analyzeAdvancedImages() {
-        let imagesWithSrcset = 0;
-        let largeBase64ImagesCount = 0;
-        const imgs = this.root.querySelectorAll('img');
-        imgs.forEach((img) => {
-            if (img.getAttribute('srcset') || (img.parentNode && img.parentNode.tagName === 'PICTURE')) {
-                imagesWithSrcset++;
-            }
-            const src = img.getAttribute('src') || '';
-            if (src.startsWith('data:image') && src.length > 5 * 1024) {
-                largeBase64ImagesCount++;
-            }
-        });
-        return { imagesWithSrcset, largeBase64ImagesCount };
-    }
     calculateTextHtmlRatio(bodyTextLength) {
         const htmlSize = this.root.innerHTML?.length;
         if (htmlSize && htmlSize > 0) {
@@ -926,6 +956,7 @@ export class SeoAnalyzer {
             id: r.id,
             name: r.name,
             category: r.category,
+            severity: r.severity,
             status: r.status,
             message: r.message,
             value: r.value,
@@ -934,6 +965,8 @@ export class SeoAnalyzer {
         }));
     }
     buildSummary(ruleResults, checks, data) {
+        const pageType = data.pageType;
+        const timings = data.timings;
         const passed = checks.filter((c) => c.status === 'pass').length;
         const warnings = checks.filter((c) => c.status === 'warn').length;
         const errors = checks.filter((c) => c.status === 'fail').length;
@@ -954,21 +987,25 @@ export class SeoAnalyzer {
             else if (result.status === 'fail')
                 issuesByCategory[cat].errors++;
         }
-        const topIssues = ruleResults
-            .filter((r) => r.status === 'fail' || r.status === 'warn')
+        const topIssues = checks
+            .filter((c) => c.status === 'fail' || c.status === 'warn')
             .sort((a, b) => {
-            if (a.status === 'fail' && b.status !== 'fail')
-                return -1;
-            if (a.status !== 'fail' && b.status === 'fail')
-                return 1;
-            return 0;
+            const severityOrder = (status) => status === 'fail' ? 2 : 1;
+            const statusDiff = severityOrder(b.status) - severityOrder(a.status);
+            if (statusDiff !== 0)
+                return statusDiff;
+            const aSeverity = a.severity || (a.status === 'fail' ? 'error' : 'warning');
+            const bSeverity = b.severity || (b.status === 'fail' ? 'error' : 'warning');
+            if (aSeverity === bSeverity)
+                return 0;
+            return aSeverity === 'error' ? -1 : 1;
         })
             .slice(0, 5)
             .map((r) => ({
             name: r.name,
             message: r.message,
             category: r.category,
-            severity: (r.status === 'fail' ? 'error' : 'warning'),
+            severity: (r.severity || (r.status === 'fail' ? 'error' : 'warning')),
         }));
         const quickWins = [];
         if (!data.meta.title)
@@ -993,8 +1030,8 @@ export class SeoAnalyzer {
         const vitals = {
             htmlSize,
             domElements,
-            ttfb: this.options.responseHeaders ? undefined : undefined,
-            totalTime: undefined,
+            ttfb: timings?.ttfb,
+            totalTime: timings?.total,
             wordCount: data.content.wordCount,
             totalWordCount: data.content.totalWordCount,
             readingTime: data.content.readingTimeMinutes,
@@ -1017,6 +1054,7 @@ export class SeoAnalyzer {
             infos,
             passRate,
             issuesByCategory,
+            pageType: pageType,
             topIssues,
             quickWins: limitedQuickWins,
             vitals,
@@ -1387,18 +1425,11 @@ export class SeoAnalyzer {
             unminifiedResourceUrls: unminified
         };
     }
-    calculateScore(checks) {
-        const weights = {
-            pass: 100,
-            warn: 50,
-            fail: 0,
-            info: 100,
-        };
-        const scoringChecks = checks.filter((c) => c.status !== 'info');
-        if (scoringChecks.length === 0)
+    calculateScore(results) {
+        if (results.length === 0)
             return { score: 100, grade: 'A' };
-        const totalWeight = scoringChecks.reduce((sum, check) => sum + weights[check.status], 0);
-        const score = Math.round(totalWeight / scoringChecks.length);
+        const { score: weightedScore } = calculateWeightedScore(results);
+        const score = weightedScore;
         let grade;
         if (score >= 90)
             grade = 'A';

package/dist/seo/index.d.ts

@@ -6,7 +6,7 @@ export type { SeoSpiderOptions, SeoPageResult, SiteWideIssue, SeoSpiderResult, }
 export { SeoRulesEngine, createRulesEngine, SEO_THRESHOLDS, ALL_SEO_RULES, } from './rules/index.js';
 export { generateSeoFilename, resolveOutputPath, writeReport, formatReportForJson, } from './output.js';
 export type { SeoOutputType, OutputOptions, WriteOptions } from './output.js';
-export type { SeoReport, SeoCheckResult, SeoStatus, SeoTiming, HeadingAnalysis, HeadingInfo, ContentMetrics, LinkAnalysis, ImageAnalysis, SocialMetaAnalysis, TechnicalSeo, SeoAnalyzerOptions, } from './types.js';
+export type { SeoReport, SeoCheckResult, SeoStatus, SeoPageType, SeoTiming, HeadingAnalysis, HeadingInfo, ContentMetrics, LinkAnalysis, ImageAnalysis, SocialMetaAnalysis, TechnicalSeo, SeoAnalyzerOptions, } from './types.js';
 export type { SeoRule, RuleContext, RuleResult, RuleEvidence, RuleCategory, RuleSeverity, RulesEngineOptions, } from './rules/index.js';
 export type { SeoAnalyzerFullOptions } from './analyzer.js';
 export { parseRobotsTxt, validateRobotsTxt, isPathAllowed, fetchAndValidateRobotsTxt, } from './validators/robots.js';
@@ -15,3 +15,5 @@ export { parseSitemap, validateSitemap, discoverSitemaps, fetchAndValidateSitema
 export type { SitemapUrl, SitemapIndex, SitemapParseResult, SitemapValidationIssue, SitemapValidationResult, } from './validators/sitemap.js';
 export { parseLlmsTxt, validateLlmsTxt, fetchAndValidateLlmsTxt, generateLlmsTxtTemplate, } from './validators/llms-txt.js';
 export type { LlmsTxtLink, LlmsTxtSection, LlmsTxtParseResult, LlmsTxtValidationIssue, LlmsTxtValidationResult, } from './validators/llms-txt.js';
+export { analyzeKeywordCampaign, extractKeywordCampaignSeedsFromReport, } from './keyword-campaign.js';
+export type { CampaignActivitySignal, CampaignResultPlacement, KeywordCampaignCompetitorResult, KeywordCampaignCompetitorSummary, KeywordCampaignExtractionOptions, KeywordCampaignOptions, KeywordCampaignPageStats, KeywordCampaignReport, KeywordCampaignResult, KeywordCampaignSeed, KeywordCampaignSeedInput, KeywordCampaignSource, KeywordCampaignSummary, } from './keyword-campaign.js';

package/dist/seo/index.js

@@ -6,3 +6,4 @@ export { generateSeoFilename, resolveOutputPath, writeReport, formatReportForJso
 export { parseRobotsTxt, validateRobotsTxt, isPathAllowed, fetchAndValidateRobotsTxt, } from './validators/robots.js';
 export { parseSitemap, validateSitemap, discoverSitemaps, fetchAndValidateSitemap, } from './validators/sitemap.js';
 export { parseLlmsTxt, validateLlmsTxt, fetchAndValidateLlmsTxt, generateLlmsTxtTemplate, } from './validators/llms-txt.js';
+export { analyzeKeywordCampaign, extractKeywordCampaignSeedsFromReport, } from './keyword-campaign.js';

package/dist/seo/keyword-campaign.d.ts

@@ -0,0 +1,107 @@
+import type { SearchTransport } from '../search/google.js';
+import type { SeoReport } from './types.js';
+export type KeywordCampaignSource = 'discovered' | 'preset';
+export type CampaignResultPlacement = 'ad' | 'organic' | 'unknown';
+export interface KeywordCampaignSeedInput {
+    keyword: string;
+    source?: KeywordCampaignSource;
+    sourcePage?: string;
+    weight?: number;
+}
+export interface KeywordCampaignSeed {
+    keyword: string;
+    normalizedKeyword: string;
+    source: KeywordCampaignSource;
+    sourcePage?: string;
+    weight: number;
+}
+export interface KeywordCampaignOptions {
+    targetUrl: string;
+    discoveredKeywords?: KeywordCampaignSeedInput[] | string[];
+    presetKeywords?: string[];
+    minKeywordLength?: number;
+    maxQueries?: number;
+    maxResultsPerQuery?: number;
+    transport?: SearchTransport;
+    timeout?: number;
+    country?: string;
+    gl?: string;
+    hl?: string;
+    minWeight?: number;
+}
+export interface KeywordCampaignCompetitorResult {
+    domain: string;
+    rank: number;
+    placement: CampaignResultPlacement;
+    placementHint?: string;
+    url: string;
+    title: string;
+}
+export interface KeywordCampaignResult {
+    keyword: string;
+    source: KeywordCampaignSource;
+    sourcePage?: string;
+    sourceWeight: number;
+    found: boolean;
+    bestPosition: number | null;
+    totalChecked: number;
+    matchedUrl?: string;
+    matchedTitle?: string;
+    matchedDisplayUrl?: string;
+    placement: CampaignResultPlacement;
+    placementHint?: string;
+    searchUrl: string;
+    searchTransport: SearchTransport;
+    competitors: KeywordCampaignCompetitorResult[];
+}
+export interface KeywordCampaignPageStats {
+    pageUrl: string;
+    tracked: number;
+    found: number;
+    avgPosition: number | null;
+    top3: number;
+    top10: number;
+}
+export interface KeywordCampaignSummary {
+    queriesRequested: number;
+    queriesExecuted: number;
+    queriesFound: number;
+    avgTopPosition: number | null;
+    top3Count: number;
+    top10Count: 0 | number;
+    topOrganicCompetitors: KeywordCampaignCompetitorSummary[];
+    topPaidCompetitors: KeywordCampaignCompetitorSummary[];
+    competitorCoverage: {
+        organicUniqueDomains: number;
+        paidUniqueDomains: number;
+    };
+}
+export interface KeywordCampaignCompetitorSummary {
+    domain: string;
+    organicQueries: number;
+    paidQueries: number;
+    bestOrganicRank: number | null;
+    bestPaidRank: number | null;
+    matchedKeywords: number;
+}
+export interface CampaignActivitySignal {
+    active: boolean;
+    confidence: 'high' | 'medium' | 'low';
+    evidence: string[];
+}
+export interface KeywordCampaignReport {
+    targetUrl: string;
+    targetDomain: string;
+    results: KeywordCampaignResult[];
+    summary: KeywordCampaignSummary;
+    pageComparison: KeywordCampaignPageStats[];
+    campaign: CampaignActivitySignal;
+}
+export interface KeywordCampaignExtractionOptions {
+    maxKeywords?: number;
+    minKeywordLength?: number;
+}
+export declare function extractKeywordCampaignSeedsFromReport(report: SeoReport, options?: KeywordCampaignExtractionOptions & {
+    sourcePage?: string;
+}): KeywordCampaignSeed[];
+export declare function analyzeKeywordCampaign(options: KeywordCampaignOptions): Promise<KeywordCampaignReport>;