aeorank 1.6.0 → 2.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +30 -28
- package/dist/browser.d.ts +1 -1
- package/dist/browser.js +334 -57
- package/dist/browser.js.map +1 -1
- package/dist/{chunk-3IJISYWT.js → chunk-PKJIKMLV.js} +2 -2
- package/dist/chunk-PKJIKMLV.js.map +1 -0
- package/dist/cli.js +331 -54
- package/dist/cli.js.map +1 -1
- package/dist/{full-site-crawler-F7J2HRL4.js → full-site-crawler-FQYO46YV.js} +2 -2
- package/dist/full-site-crawler-FQYO46YV.js.map +1 -0
- package/dist/{full-site-crawler-VFARFR2C.js → full-site-crawler-UIOMKOZA.js} +2 -2
- package/dist/index.cjs +333 -56
- package/dist/index.cjs.map +1 -1
- package/dist/index.d.cts +1 -1
- package/dist/index.d.ts +1 -1
- package/dist/index.js +334 -57
- package/dist/index.js.map +1 -1
- package/package.json +2 -2
- package/dist/chunk-3IJISYWT.js.map +0 -1
- package/dist/full-site-crawler-F7J2HRL4.js.map +0 -1
- /package/dist/{full-site-crawler-VFARFR2C.js.map → full-site-crawler-UIOMKOZA.js.map} +0 -0
package/dist/index.d.cts
CHANGED
|
@@ -233,7 +233,7 @@ interface SiteData {
|
|
|
233
233
|
redirectedTo: string | null;
|
|
234
234
|
/** Set when homepage is a parked/for-sale/lost domain */
|
|
235
235
|
parkedReason: string | null;
|
|
236
|
-
/** Sampled blog/content pages from sitemap (up to
|
|
236
|
+
/** Sampled blog/content pages from sitemap (up to 50) */
|
|
237
237
|
blogSample?: FetchResult[];
|
|
238
238
|
/** Full-crawl statistics (set when --full-crawl is used) */
|
|
239
239
|
crawlStats?: {
|
package/dist/index.d.ts
CHANGED
|
@@ -233,7 +233,7 @@ interface SiteData {
|
|
|
233
233
|
redirectedTo: string | null;
|
|
234
234
|
/** Set when homepage is a parked/for-sale/lost domain */
|
|
235
235
|
parkedReason: string | null;
|
|
236
|
-
/** Sampled blog/content pages from sitemap (up to
|
|
236
|
+
/** Sampled blog/content pages from sitemap (up to 50) */
|
|
237
237
|
blogSample?: FetchResult[];
|
|
238
238
|
/** Full-crawl statistics (set when --full-crawl is used) */
|
|
239
239
|
crawlStats?: {
|
package/dist/index.js
CHANGED
|
@@ -3,7 +3,7 @@ import {
|
|
|
3
3
|
extractAllUrlsFromSitemap,
|
|
4
4
|
extractInternalLinks,
|
|
5
5
|
inferCategory
|
|
6
|
-
} from "./chunk-
|
|
6
|
+
} from "./chunk-PKJIKMLV.js";
|
|
7
7
|
|
|
8
8
|
// src/parked-domain.ts
|
|
9
9
|
var PARKING_PATHS = ["/lander", "/parking", "/park", "/sedoparking"];
|
|
@@ -195,7 +195,7 @@ async function prefetchSiteData(domain) {
|
|
|
195
195
|
sitemapForBlog = subSitemap.text;
|
|
196
196
|
}
|
|
197
197
|
}
|
|
198
|
-
const blogUrls = extractBlogUrlsFromSitemap(sitemapForBlog, domain,
|
|
198
|
+
const blogUrls = extractBlogUrlsFromSitemap(sitemapForBlog, domain, 50);
|
|
199
199
|
if (blogUrls.length > 0) {
|
|
200
200
|
const fetched = await Promise.all(blogUrls.map((url) => fetchText(url)));
|
|
201
201
|
blogSample = fetched.filter(
|
|
@@ -552,15 +552,17 @@ function checkOriginalData(data) {
|
|
|
552
552
|
findings.push({ severity: "critical", detail: "Could not fetch homepage" });
|
|
553
553
|
return { criterion: "original_data", criterion_label: "Original Data & Expert Content", score: 0, status: "not_found", findings, fix_priority: "P2" };
|
|
554
554
|
}
|
|
555
|
+
const allPages = [data.homepage, ...data.blogSample || []].filter(Boolean);
|
|
555
556
|
const html = data.homepage.text;
|
|
556
|
-
const
|
|
557
|
+
const allText = allPages.map((p) => p.text.replace(/<[^>]*>/g, " ").replace(/\s+/g, " ")).join(" ");
|
|
558
|
+
const text = data.homepage.text.replace(/<[^>]*>/g, " ").replace(/\s+/g, " ");
|
|
557
559
|
let score = 0;
|
|
558
560
|
const statPatterns = /\d+%|\d+\s*(patients|clients|customers|cases|years|professionals|specialists|companies|users|businesses|domains|audits)/i;
|
|
559
|
-
if (statPatterns.test(
|
|
561
|
+
if (statPatterns.test(allText)) {
|
|
560
562
|
const researchContext = /\b(our\s+(?:study|analysis|research|data|survey|findings|report)|we\s+(?:surveyed|analyzed|studied|measured|tracked)|proprietary|methodology|original\s+research)\b/i;
|
|
561
|
-
if (researchContext.test(
|
|
563
|
+
if (researchContext.test(allText)) {
|
|
562
564
|
score += 3;
|
|
563
|
-
findings.push({ severity: "info", detail: "Proprietary statistics with research context found
|
|
565
|
+
findings.push({ severity: "info", detail: "Proprietary statistics with research context found" });
|
|
564
566
|
} else {
|
|
565
567
|
score += 1;
|
|
566
568
|
findings.push({ severity: "low", detail: 'Statistics found but without research context (e.g., "500+ clients")', fix: 'Add context about your methodology: "Our analysis of X found..." or "We surveyed Y..."' });
|
|
@@ -1075,20 +1077,24 @@ function checkFactDensity(data) {
|
|
|
1075
1077
|
findings.push({ severity: "critical", detail: "Could not fetch homepage" });
|
|
1076
1078
|
return { criterion: "fact_density", criterion_label: "Fact & Data Density", score: 0, status: "not_found", findings, fix_priority: "P2" };
|
|
1077
1079
|
}
|
|
1078
|
-
const
|
|
1080
|
+
const allPages = [data.homepage, ...data.blogSample || []].filter(Boolean);
|
|
1081
|
+
const allText = allPages.map((p) => p.text.replace(/<[^>]*>/g, " ").replace(/\s+/g, " ")).join(" ");
|
|
1082
|
+
const text = allText;
|
|
1083
|
+
const pageCount = allPages.length;
|
|
1079
1084
|
let score = 0;
|
|
1080
1085
|
const dataPoints = text.match(/\d+(?:\.\d+)?(?:\s*%|\s*\$|\s*USD|\s*EUR)/g) || [];
|
|
1081
1086
|
const countPhrases = text.match(/\d+(?:,\d{3})*\+?\s+(?:users?|clients?|customers?|companies|businesses|patients?|members?|employees?|projects?|downloads?)/gi) || [];
|
|
1082
1087
|
const totalDataPoints = dataPoints.length + countPhrases.length;
|
|
1083
|
-
|
|
1088
|
+
const avgPerPage = pageCount > 0 ? totalDataPoints / pageCount : 0;
|
|
1089
|
+
if (avgPerPage >= 4) {
|
|
1084
1090
|
score += 5;
|
|
1085
|
-
findings.push({ severity: "info", detail: `${totalDataPoints} quantitative data points found
|
|
1086
|
-
} else if (
|
|
1091
|
+
findings.push({ severity: "info", detail: `${totalDataPoints} quantitative data points found across ${pageCount} pages (avg ${avgPerPage.toFixed(1)}/page)` });
|
|
1092
|
+
} else if (avgPerPage >= 2) {
|
|
1087
1093
|
score += 3;
|
|
1088
|
-
findings.push({ severity: "info", detail: `${totalDataPoints} quantitative data points found` });
|
|
1094
|
+
findings.push({ severity: "info", detail: `${totalDataPoints} quantitative data points found across ${pageCount} pages` });
|
|
1089
1095
|
} else if (totalDataPoints >= 1) {
|
|
1090
1096
|
score += 1;
|
|
1091
|
-
findings.push({ severity: "low", detail: `Only ${totalDataPoints} quantitative data point(s) found`, fix: "Add more specific numbers, percentages, and metrics to strengthen credibility" });
|
|
1097
|
+
findings.push({ severity: "low", detail: `Only ${totalDataPoints} quantitative data point(s) found across ${pageCount} pages`, fix: "Add more specific numbers, percentages, and metrics to strengthen credibility" });
|
|
1092
1098
|
} else {
|
|
1093
1099
|
findings.push({ severity: "high", detail: "No quantitative data points found", fix: "Add specific statistics (percentages, counts, comparisons) that AI engines can cite" });
|
|
1094
1100
|
}
|
|
@@ -1194,9 +1200,9 @@ function countRecentSitemapDates(sitemapText) {
|
|
|
1194
1200
|
distinctRecentDays: recentDays.size
|
|
1195
1201
|
};
|
|
1196
1202
|
}
|
|
1197
|
-
var BLOG_PATH_PATTERNS = /\/(?:blog|articles?|insights?|guides?|resources?|news|posts?|learn|help|how-?to|tutorials?|case-stud|whitepapers?)\b/i;
|
|
1203
|
+
var BLOG_PATH_PATTERNS = /\/(?:[^/]*-?)?(?:blog|articles?|insights?|guides?|resources?|news|posts?|learn|help|how-?to|tutorials?|case-stud|whitepapers?)\b/i;
|
|
1198
1204
|
var EXCLUDE_PATH_PATTERNS = /\/(?:tag|category|author|page|feed|wp-content|wp-admin|wp-json|cart|checkout|login|search|api|static|assets|_next)\b/i;
|
|
1199
|
-
function extractBlogUrlsFromSitemap(sitemapText, domain, limit =
|
|
1205
|
+
function extractBlogUrlsFromSitemap(sitemapText, domain, limit = 50) {
|
|
1200
1206
|
const urlBlocks = sitemapText.match(/<url>([\s\S]*?)<\/url>/gi) || [];
|
|
1201
1207
|
const candidates = [];
|
|
1202
1208
|
const cleanDomain = domain.replace(/^www\./, "").toLowerCase();
|
|
@@ -1492,7 +1498,7 @@ function jaccardSimilarity(a, b) {
|
|
|
1492
1498
|
const union = a.size + b.size - intersection;
|
|
1493
1499
|
return union === 0 ? 0 : intersection / union;
|
|
1494
1500
|
}
|
|
1495
|
-
function checkContentCannibalization(data) {
|
|
1501
|
+
function checkContentCannibalization(data, topicCoherenceScore) {
|
|
1496
1502
|
const findings = [];
|
|
1497
1503
|
if (!data.homepage) {
|
|
1498
1504
|
findings.push({ severity: "critical", detail: "No homepage available for cannibalization analysis" });
|
|
@@ -1502,7 +1508,7 @@ function checkContentCannibalization(data) {
|
|
|
1502
1508
|
{ html: data.homepage.text, url: data.homepage.finalUrl || `https://${data.domain}/` }
|
|
1503
1509
|
];
|
|
1504
1510
|
if (data.blogSample) {
|
|
1505
|
-
for (const page of data.blogSample
|
|
1511
|
+
for (const page of data.blogSample) {
|
|
1506
1512
|
pages.push({ html: page.text, url: page.finalUrl || "" });
|
|
1507
1513
|
}
|
|
1508
1514
|
}
|
|
@@ -1512,10 +1518,29 @@ function checkContentCannibalization(data) {
|
|
|
1512
1518
|
}
|
|
1513
1519
|
const pageTitles = pages.map((p) => ({ title: extractPageTitle(p.html), url: p.url }));
|
|
1514
1520
|
const wordSets = pageTitles.map((p) => titleToWordSet(p.title));
|
|
1521
|
+
const termPageCount = /* @__PURE__ */ new Map();
|
|
1522
|
+
for (const ws of wordSets) {
|
|
1523
|
+
for (const w of ws) {
|
|
1524
|
+
termPageCount.set(w, (termPageCount.get(w) || 0) + 1);
|
|
1525
|
+
}
|
|
1526
|
+
}
|
|
1527
|
+
const commonTermThreshold = Math.max(3, pages.length * 0.4);
|
|
1528
|
+
const siteThemeTerms = /* @__PURE__ */ new Set();
|
|
1529
|
+
for (const [term, count] of termPageCount) {
|
|
1530
|
+
if (count >= commonTermThreshold) siteThemeTerms.add(term);
|
|
1531
|
+
}
|
|
1532
|
+
const filteredSets = wordSets.map((ws) => {
|
|
1533
|
+
const filtered = /* @__PURE__ */ new Set();
|
|
1534
|
+
for (const w of ws) {
|
|
1535
|
+
if (!siteThemeTerms.has(w)) filtered.add(w);
|
|
1536
|
+
}
|
|
1537
|
+
return filtered;
|
|
1538
|
+
});
|
|
1515
1539
|
const cannibalPairs = [];
|
|
1516
1540
|
for (let i = 0; i < pages.length; i++) {
|
|
1517
1541
|
for (let j = i + 1; j < pages.length; j++) {
|
|
1518
|
-
|
|
1542
|
+
if (filteredSets[i].size === 0 && filteredSets[j].size === 0) continue;
|
|
1543
|
+
const sim = jaccardSimilarity(filteredSets[i], filteredSets[j]);
|
|
1519
1544
|
if (sim > 0.6) {
|
|
1520
1545
|
cannibalPairs.push({
|
|
1521
1546
|
urlA: pageTitles[i].url.slice(0, 60),
|
|
@@ -1525,23 +1550,39 @@ function checkContentCannibalization(data) {
|
|
|
1525
1550
|
}
|
|
1526
1551
|
}
|
|
1527
1552
|
}
|
|
1553
|
+
const cannibalUrls = /* @__PURE__ */ new Set();
|
|
1554
|
+
for (const pair of cannibalPairs) {
|
|
1555
|
+
cannibalUrls.add(pair.urlA);
|
|
1556
|
+
cannibalUrls.add(pair.urlB);
|
|
1557
|
+
}
|
|
1558
|
+
const cannibalRatio = pages.length > 0 ? cannibalUrls.size / pages.length : 0;
|
|
1528
1559
|
let score;
|
|
1529
1560
|
if (cannibalPairs.length === 0) {
|
|
1530
1561
|
score = 10;
|
|
1531
1562
|
findings.push({ severity: "info", detail: `${pages.length} pages analyzed - no content cannibalization detected` });
|
|
1532
|
-
} else if (
|
|
1533
|
-
score =
|
|
1534
|
-
findings.push({ severity: "
|
|
1535
|
-
} else if (
|
|
1563
|
+
} else if (cannibalRatio <= 0.05) {
|
|
1564
|
+
score = 9;
|
|
1565
|
+
findings.push({ severity: "info", detail: `${cannibalPairs.length} pair(s) of pages with minor topic overlap (${cannibalUrls.size}/${pages.length} pages affected)` });
|
|
1566
|
+
} else if (cannibalRatio <= 0.1) {
|
|
1567
|
+
score = 7;
|
|
1568
|
+
findings.push({ severity: "low", detail: `${cannibalUrls.size} pages (${Math.round(cannibalRatio * 100)}%) have overlapping topics`, fix: "Differentiate titles and H1 headings to reduce topic overlap" });
|
|
1569
|
+
} else if (cannibalRatio <= 0.2) {
|
|
1536
1570
|
score = 5;
|
|
1537
|
-
findings.push({ severity: "medium", detail: `${
|
|
1571
|
+
findings.push({ severity: "medium", detail: `${cannibalUrls.size} pages (${Math.round(cannibalRatio * 100)}%) competing for overlapping topics`, fix: "Consolidate overlapping pages or differentiate their titles and content focus" });
|
|
1572
|
+
} else if (cannibalRatio <= 0.4) {
|
|
1573
|
+
score = 3;
|
|
1574
|
+
findings.push({ severity: "medium", detail: `${cannibalUrls.size} pages (${Math.round(cannibalRatio * 100)}%) have significant content overlap`, fix: "Many pages compete for the same topics - consolidate or clearly differentiate them" });
|
|
1538
1575
|
} else {
|
|
1539
1576
|
score = 0;
|
|
1540
|
-
findings.push({ severity: "high", detail: `${
|
|
1577
|
+
findings.push({ severity: "high", detail: `${cannibalUrls.size} pages (${Math.round(cannibalRatio * 100)}%) competing for the same topics`, fix: "Severe content cannibalization - consolidate overlapping pages or create clear topic differentiation" });
|
|
1541
1578
|
}
|
|
1542
1579
|
for (const pair of cannibalPairs.slice(0, 3)) {
|
|
1543
1580
|
findings.push({ severity: "low", detail: `Overlap (${pair.similarity}%): ${pair.urlA} vs ${pair.urlB}` });
|
|
1544
1581
|
}
|
|
1582
|
+
if (topicCoherenceScore !== void 0 && topicCoherenceScore <= 4 && score >= 8) {
|
|
1583
|
+
score = 6;
|
|
1584
|
+
findings.push({ severity: "low", detail: "Low topic overlap but content lacks coherent focus - not a strong signal for AI authority", fix: "Focus content on fewer core topics to build topical authority that AI engines can identify" });
|
|
1585
|
+
}
|
|
1545
1586
|
return { criterion: "content_cannibalization", criterion_label: "Content Cannibalization", score, status: score >= 7 ? "pass" : score >= 4 ? "partial" : "fail", findings, fix_priority: score >= 7 ? "P3" : "P1" };
|
|
1546
1587
|
}
|
|
1547
1588
|
function checkVisibleDateSignal(data) {
|
|
@@ -1767,7 +1808,233 @@ function extractRawDataSummary(data) {
|
|
|
1767
1808
|
crawl_skipped: data.crawlStats?.skipped ?? 0
|
|
1768
1809
|
};
|
|
1769
1810
|
}
|
|
1811
|
+
function getPageTopicText(html) {
|
|
1812
|
+
const titleMatch = html.match(/<title[^>]*>([^<]+)<\/title>/i);
|
|
1813
|
+
const h1Match = html.match(/<h1[^>]*>([\s\S]*?)<\/h1>/i);
|
|
1814
|
+
return [
|
|
1815
|
+
titleMatch?.[1] || "",
|
|
1816
|
+
h1Match?.[1]?.replace(/<[^>]*>/g, "") || ""
|
|
1817
|
+
].join(" ").toLowerCase().trim();
|
|
1818
|
+
}
|
|
1819
|
+
function extractBigrams(text) {
|
|
1820
|
+
const words = text.split(/[\s,.!?;:()\[\]{}"'\/&]+/).filter((w) => w.length > 2 && !STOP_WORDS.has(w) && !/^\d+$/.test(w));
|
|
1821
|
+
const bigrams = [];
|
|
1822
|
+
for (let i = 0; i < words.length - 1; i++) {
|
|
1823
|
+
bigrams.push(words[i] + " " + words[i + 1]);
|
|
1824
|
+
}
|
|
1825
|
+
return bigrams;
|
|
1826
|
+
}
|
|
1827
|
+
function checkTopicCoherence(data) {
|
|
1828
|
+
const findings = [];
|
|
1829
|
+
if (!data.homepage) {
|
|
1830
|
+
findings.push({ severity: "critical", detail: "Could not fetch homepage" });
|
|
1831
|
+
return { criterion: "topic_coherence", criterion_label: "Topic Coherence", score: 0, status: "not_found", findings, fix_priority: "P0" };
|
|
1832
|
+
}
|
|
1833
|
+
if (!data.blogSample || data.blogSample.length < 3) {
|
|
1834
|
+
findings.push({ severity: "info", detail: `Only ${data.blogSample?.length || 0} blog pages found - insufficient for topic coherence analysis` });
|
|
1835
|
+
return { criterion: "topic_coherence", criterion_label: "Topic Coherence", score: 5, status: "partial", findings, fix_priority: "P2" };
|
|
1836
|
+
}
|
|
1837
|
+
const blogPages = data.blogSample;
|
|
1838
|
+
const domainBase = data.domain.replace(/^www\./, "").replace(/\.(com|org|net|io|co|ai)$/i, "").toLowerCase();
|
|
1839
|
+
const brandWords = /* @__PURE__ */ new Set();
|
|
1840
|
+
brandWords.add(domainBase);
|
|
1841
|
+
for (const part of domainBase.split(/[-_]/)) {
|
|
1842
|
+
if (part.length > 2) brandWords.add(part);
|
|
1843
|
+
}
|
|
1844
|
+
const rawTermFreq = /* @__PURE__ */ new Map();
|
|
1845
|
+
const pageTitleTexts = [];
|
|
1846
|
+
for (const page of blogPages) {
|
|
1847
|
+
const topicText = getPageTopicText(page.text);
|
|
1848
|
+
pageTitleTexts.push(topicText);
|
|
1849
|
+
const words = topicText.split(/[\s,.!?;:()\[\]{}"'\/&]+/).filter((w) => w.length > 2 && !STOP_WORDS.has(w) && !/^\d+$/.test(w));
|
|
1850
|
+
const uniqueWords = new Set(words);
|
|
1851
|
+
for (const w of uniqueWords) {
|
|
1852
|
+
rawTermFreq.set(w, (rawTermFreq.get(w) || 0) + 1);
|
|
1853
|
+
}
|
|
1854
|
+
}
|
|
1855
|
+
for (const [term, count] of rawTermFreq) {
|
|
1856
|
+
if (count / blogPages.length >= 0.8 && domainBase.includes(term)) {
|
|
1857
|
+
brandWords.add(term);
|
|
1858
|
+
}
|
|
1859
|
+
}
|
|
1860
|
+
const termFreq = /* @__PURE__ */ new Map();
|
|
1861
|
+
for (const page of blogPages) {
|
|
1862
|
+
const topicText = getPageTopicText(page.text);
|
|
1863
|
+
const words = topicText.split(/[\s,.!?;:()\[\]{}"'\/&]+/).filter((w) => w.length > 2 && !STOP_WORDS.has(w) && !/^\d+$/.test(w) && !brandWords.has(w));
|
|
1864
|
+
const uniqueWords = new Set(words);
|
|
1865
|
+
for (const w of uniqueWords) {
|
|
1866
|
+
termFreq.set(w, (termFreq.get(w) || 0) + 1);
|
|
1867
|
+
}
|
|
1868
|
+
}
|
|
1869
|
+
const sortedTerms = [...termFreq.entries()].sort((a, b) => b[1] - a[1]);
|
|
1870
|
+
const topTerm = sortedTerms[0];
|
|
1871
|
+
const bigramFreq = /* @__PURE__ */ new Map();
|
|
1872
|
+
const pageBigrams = [];
|
|
1873
|
+
for (const topicText of pageTitleTexts) {
|
|
1874
|
+
const bigrams = extractBigrams(topicText).filter((bg) => !bg.split(" ").some((w) => brandWords.has(w)));
|
|
1875
|
+
pageBigrams.push(bigrams);
|
|
1876
|
+
const uniqueBigrams = new Set(bigrams);
|
|
1877
|
+
for (const bg of uniqueBigrams) {
|
|
1878
|
+
bigramFreq.set(bg, (bigramFreq.get(bg) || 0) + 1);
|
|
1879
|
+
}
|
|
1880
|
+
}
|
|
1881
|
+
const sortedBigrams = [...bigramFreq.entries()].sort((a, b) => b[1] - a[1]);
|
|
1882
|
+
const topBigram = sortedBigrams[0];
|
|
1883
|
+
const significantBigrams = sortedBigrams.filter(([, count]) => count >= 2);
|
|
1884
|
+
const clusterRoots = [];
|
|
1885
|
+
const assigned = /* @__PURE__ */ new Set();
|
|
1886
|
+
for (const [bg] of significantBigrams) {
|
|
1887
|
+
if (assigned.has(bg)) continue;
|
|
1888
|
+
clusterRoots.push(bg);
|
|
1889
|
+
assigned.add(bg);
|
|
1890
|
+
const [w1, w2] = bg.split(" ");
|
|
1891
|
+
for (const [otherBg] of significantBigrams) {
|
|
1892
|
+
if (assigned.has(otherBg)) continue;
|
|
1893
|
+
if (otherBg.includes(w1) || otherBg.includes(w2)) {
|
|
1894
|
+
assigned.add(otherBg);
|
|
1895
|
+
}
|
|
1896
|
+
}
|
|
1897
|
+
}
|
|
1898
|
+
const topicClusterCount = clusterRoots.length;
|
|
1899
|
+
const dominantTerm = topTerm?.[0] || "";
|
|
1900
|
+
const dominantTermCount = topTerm?.[1] || 0;
|
|
1901
|
+
const focusRatio = blogPages.length > 0 ? dominantTermCount / blogPages.length : 0;
|
|
1902
|
+
const dominantBigram = topBigram?.[0] || "";
|
|
1903
|
+
const dominantBigramCount = topBigram?.[1] || 0;
|
|
1904
|
+
const bigramFocusRatio = blogPages.length > 0 ? dominantBigramCount / blogPages.length : 0;
|
|
1905
|
+
let score = 0;
|
|
1906
|
+
const bestFocusRatio = Math.max(focusRatio, bigramFocusRatio);
|
|
1907
|
+
if (bestFocusRatio >= 0.8) {
|
|
1908
|
+
score += 7;
|
|
1909
|
+
} else if (bestFocusRatio >= 0.6) {
|
|
1910
|
+
score += 6;
|
|
1911
|
+
} else if (bestFocusRatio >= 0.45) {
|
|
1912
|
+
score += 5;
|
|
1913
|
+
} else if (bestFocusRatio >= 0.3) {
|
|
1914
|
+
score += 3;
|
|
1915
|
+
} else if (bestFocusRatio >= 0.15) {
|
|
1916
|
+
score += 2;
|
|
1917
|
+
} else {
|
|
1918
|
+
score += 1;
|
|
1919
|
+
}
|
|
1920
|
+
const clusterPenaltyReduced = focusRatio >= 0.7;
|
|
1921
|
+
if (topicClusterCount <= 3) {
|
|
1922
|
+
score += 3;
|
|
1923
|
+
findings.push({ severity: "info", detail: `${topicClusterCount} topic cluster(s) - tightly focused content` });
|
|
1924
|
+
} else if (topicClusterCount <= 6) {
|
|
1925
|
+
score += clusterPenaltyReduced ? 2 : 1;
|
|
1926
|
+
findings.push({ severity: "info", detail: `${topicClusterCount} topic clusters${clusterPenaltyReduced ? " within a focused niche" : " - moderately focused"}` });
|
|
1927
|
+
} else if (topicClusterCount <= 10) {
|
|
1928
|
+
score += clusterPenaltyReduced ? 1 : 0;
|
|
1929
|
+
if (!clusterPenaltyReduced) {
|
|
1930
|
+
findings.push({ severity: "low", detail: `${topicClusterCount} topic clusters - scattered content`, fix: "Reduce the number of distinct topics. Focus blog content on 2-3 core expertise areas." });
|
|
1931
|
+
} else {
|
|
1932
|
+
findings.push({ severity: "info", detail: `${topicClusterCount} topic clusters but strong core topic focus (${Math.round(focusRatio * 100)}%)` });
|
|
1933
|
+
}
|
|
1934
|
+
} else {
|
|
1935
|
+
score += clusterPenaltyReduced ? 0 : -2;
|
|
1936
|
+
if (!clusterPenaltyReduced) {
|
|
1937
|
+
findings.push({ severity: "medium", detail: `${topicClusterCount} topic clusters - highly scattered content`, fix: "Content covers too many unrelated topics. AI engines cannot identify your expertise. Focus on your core niche." });
|
|
1938
|
+
} else {
|
|
1939
|
+
findings.push({ severity: "low", detail: `${topicClusterCount} topic clusters despite strong core topic focus`, fix: "Consider narrowing subtopics within your niche for even stronger AI visibility." });
|
|
1940
|
+
}
|
|
1941
|
+
}
|
|
1942
|
+
score = Math.max(0, Math.min(10, score));
|
|
1943
|
+
if (dominantTerm) {
|
|
1944
|
+
const focusPct = Math.round(focusRatio * 100);
|
|
1945
|
+
findings.push({ severity: "info", detail: `Dominant topic term: "${dominantTerm}" (${focusPct}% of ${blogPages.length} pages)` });
|
|
1946
|
+
}
|
|
1947
|
+
if (dominantBigram && dominantBigramCount >= 2) {
|
|
1948
|
+
findings.push({ severity: "info", detail: `Dominant topic phrase: "${dominantBigram}" (${dominantBigramCount}/${blogPages.length} pages)` });
|
|
1949
|
+
}
|
|
1950
|
+
const offTopicExamples = [];
|
|
1951
|
+
for (let i = 0; i < pageTitleTexts.length && offTopicExamples.length < 3; i++) {
|
|
1952
|
+
if (dominantTerm && !pageTitleTexts[i].includes(dominantTerm)) {
|
|
1953
|
+
const title = blogPages[i].text.match(/<title[^>]*>([^<]+)<\/title>/i)?.[1]?.trim();
|
|
1954
|
+
if (title && title.length > 3) offTopicExamples.push(title.slice(0, 60));
|
|
1955
|
+
}
|
|
1956
|
+
}
|
|
1957
|
+
if (offTopicExamples.length > 0 && score < 8) {
|
|
1958
|
+
findings.push({ severity: "low", detail: `Off-topic examples: ${offTopicExamples.join("; ")}` });
|
|
1959
|
+
}
|
|
1960
|
+
return { criterion: "topic_coherence", criterion_label: "Topic Coherence", score, status: score >= 7 ? "pass" : score >= 4 ? "partial" : "fail", findings, fix_priority: score >= 7 ? "P3" : "P0" };
|
|
1961
|
+
}
|
|
1962
|
+
function countWords(html) {
|
|
1963
|
+
const text = html.replace(/<script[^>]*>[\s\S]*?<\/script>/gi, "").replace(/<style[^>]*>[\s\S]*?<\/style>/gi, "").replace(/<[^>]*>/g, " ").replace(/\s+/g, " ").trim();
|
|
1964
|
+
return text.split(/\s+/).filter((w) => w.length > 0).length;
|
|
1965
|
+
}
|
|
1966
|
+
function countHeadings(html) {
|
|
1967
|
+
const headings = html.match(/<h[2-6][^>]*>/gi) || [];
|
|
1968
|
+
return headings.length;
|
|
1969
|
+
}
|
|
1970
|
+
function checkContentDepth(data, topicCoherenceScore) {
|
|
1971
|
+
const findings = [];
|
|
1972
|
+
if (!data.blogSample || data.blogSample.length < 2) {
|
|
1973
|
+
findings.push({ severity: "info", detail: `Only ${data.blogSample?.length || 0} blog pages found - insufficient for depth analysis` });
|
|
1974
|
+
return { criterion: "content_depth", criterion_label: "Content Depth", score: 3, status: "partial", findings, fix_priority: "P2" };
|
|
1975
|
+
}
|
|
1976
|
+
const blogPages = data.blogSample;
|
|
1977
|
+
const wordCounts = blogPages.map((p) => countWords(p.text));
|
|
1978
|
+
const headingCounts = blogPages.map((p) => countHeadings(p.text));
|
|
1979
|
+
const avgWords = wordCounts.reduce((a, b) => a + b, 0) / wordCounts.length;
|
|
1980
|
+
const avgHeadings = headingCounts.reduce((a, b) => a + b, 0) / headingCounts.length;
|
|
1981
|
+
const deepPages = wordCounts.filter((w) => w >= 1e3).length;
|
|
1982
|
+
const thinPages = wordCounts.filter((w) => w < 300).length;
|
|
1983
|
+
const deepRatio = deepPages / blogPages.length;
|
|
1984
|
+
const thinRatio = thinPages / blogPages.length;
|
|
1985
|
+
let score = 0;
|
|
1986
|
+
if (avgWords >= 2e3) {
|
|
1987
|
+
score += 5;
|
|
1988
|
+
findings.push({ severity: "info", detail: `Average ${Math.round(avgWords)} words per page across ${blogPages.length} pages - excellent depth` });
|
|
1989
|
+
} else if (avgWords >= 1200) {
|
|
1990
|
+
score += 4;
|
|
1991
|
+
findings.push({ severity: "info", detail: `Average ${Math.round(avgWords)} words per page across ${blogPages.length} pages - good depth` });
|
|
1992
|
+
} else if (avgWords >= 800) {
|
|
1993
|
+
score += 3;
|
|
1994
|
+
findings.push({ severity: "info", detail: `Average ${Math.round(avgWords)} words per page - moderate depth` });
|
|
1995
|
+
} else if (avgWords >= 400) {
|
|
1996
|
+
score += 2;
|
|
1997
|
+
findings.push({ severity: "low", detail: `Average ${Math.round(avgWords)} words per page - shallow content`, fix: "Expand articles with more detail, examples, and expert analysis to build AI citation authority" });
|
|
1998
|
+
} else {
|
|
1999
|
+
score += 1;
|
|
2000
|
+
findings.push({ severity: "medium", detail: `Average ${Math.round(avgWords)} words per page - very thin content`, fix: "Content is too thin for AI engines to cite. Aim for 1000+ words per article with structured sections." });
|
|
2001
|
+
}
|
|
2002
|
+
if (avgHeadings >= 8) {
|
|
2003
|
+
score += 3;
|
|
2004
|
+
findings.push({ severity: "info", detail: `Average ${avgHeadings.toFixed(1)} subheadings per page - well-structured` });
|
|
2005
|
+
} else if (avgHeadings >= 5) {
|
|
2006
|
+
score += 2;
|
|
2007
|
+
findings.push({ severity: "info", detail: `Average ${avgHeadings.toFixed(1)} subheadings per page - decent structure` });
|
|
2008
|
+
} else if (avgHeadings >= 2) {
|
|
2009
|
+
score += 1;
|
|
2010
|
+
findings.push({ severity: "low", detail: `Average ${avgHeadings.toFixed(1)} subheadings per page`, fix: "Add more H2/H3 headings to break content into extractable sections" });
|
|
2011
|
+
} else {
|
|
2012
|
+
findings.push({ severity: "medium", detail: `Average ${avgHeadings.toFixed(1)} subheadings per page - minimal structure`, fix: "Add question-format H2/H3 headings so AI engines can extract specific answers" });
|
|
2013
|
+
}
|
|
2014
|
+
if (deepRatio >= 0.5) {
|
|
2015
|
+
score += 2;
|
|
2016
|
+
findings.push({ severity: "info", detail: `${deepPages}/${blogPages.length} pages (${Math.round(deepRatio * 100)}%) have 1000+ words` });
|
|
2017
|
+
} else if (deepRatio >= 0.25) {
|
|
2018
|
+
score += 1;
|
|
2019
|
+
findings.push({ severity: "info", detail: `${deepPages}/${blogPages.length} pages have 1000+ words` });
|
|
2020
|
+
}
|
|
2021
|
+
if (thinRatio >= 0.5) {
|
|
2022
|
+
score = Math.max(0, score - 2);
|
|
2023
|
+
findings.push({ severity: "medium", detail: `${thinPages}/${blogPages.length} pages (${Math.round(thinRatio * 100)}%) have under 300 words - high thin content ratio`, fix: "Remove or expand thin pages. Thin content dilutes site quality for AI engines." });
|
|
2024
|
+
} else if (thinRatio >= 0.25) {
|
|
2025
|
+
score = Math.max(0, score - 1);
|
|
2026
|
+
findings.push({ severity: "low", detail: `${thinPages}/${blogPages.length} pages have under 300 words` });
|
|
2027
|
+
}
|
|
2028
|
+
let finalScore = Math.min(10, score);
|
|
2029
|
+
if (topicCoherenceScore !== void 0 && topicCoherenceScore <= 4 && finalScore >= 8) {
|
|
2030
|
+
finalScore = 7;
|
|
2031
|
+
findings.push({ severity: "low", detail: "Deep content but low topic coherence - depth on scattered topics has reduced AI citation value", fix: "Focus content depth on your core expertise area for maximum AI visibility" });
|
|
2032
|
+
}
|
|
2033
|
+
return { criterion: "content_depth", criterion_label: "Content Depth", score: finalScore, status: finalScore >= 7 ? "pass" : finalScore >= 4 ? "partial" : "fail", findings, fix_priority: finalScore >= 7 ? "P3" : "P1" };
|
|
2034
|
+
}
|
|
1770
2035
|
function auditSiteFromData(data) {
|
|
2036
|
+
const topicCoherence = checkTopicCoherence(data);
|
|
2037
|
+
const cannibalization = checkContentCannibalization(data, topicCoherence.score);
|
|
1771
2038
|
return [
|
|
1772
2039
|
checkLlmsTxt(data),
|
|
1773
2040
|
checkSchemaMarkup(data),
|
|
@@ -1793,47 +2060,55 @@ function auditSiteFromData(data) {
|
|
|
1793
2060
|
checkSchemaCoverage(data),
|
|
1794
2061
|
checkSpeakableSchema(data),
|
|
1795
2062
|
checkQueryAnswerAlignment(data),
|
|
1796
|
-
|
|
1797
|
-
checkVisibleDateSignal(data)
|
|
2063
|
+
cannibalization,
|
|
2064
|
+
checkVisibleDateSignal(data),
|
|
2065
|
+
topicCoherence,
|
|
2066
|
+
checkContentDepth(data, topicCoherence.score)
|
|
1798
2067
|
];
|
|
1799
2068
|
}
|
|
1800
2069
|
|
|
1801
2070
|
// src/scoring.ts
|
|
1802
2071
|
var WEIGHTS = {
|
|
1803
|
-
//
|
|
1804
|
-
|
|
1805
|
-
|
|
1806
|
-
|
|
1807
|
-
|
|
1808
|
-
|
|
1809
|
-
robots_txt: 0.05,
|
|
1810
|
-
faq_section: 0.1,
|
|
1811
|
-
original_data: 0.1,
|
|
1812
|
-
internal_linking: 0.1,
|
|
1813
|
-
semantic_html: 0.05,
|
|
1814
|
-
// New 12
|
|
1815
|
-
content_freshness: 0.07,
|
|
1816
|
-
sitemap_completeness: 0.05,
|
|
1817
|
-
rss_feed: 0.03,
|
|
1818
|
-
table_list_extractability: 0.07,
|
|
1819
|
-
definition_patterns: 0.04,
|
|
2072
|
+
// ─── Core Content (high weight - these determine real AI citation quality) ──
|
|
2073
|
+
qa_content_format: 0.12,
|
|
2074
|
+
original_data: 0.12,
|
|
2075
|
+
topic_coherence: 0.14,
|
|
2076
|
+
// NEW v2.0: biggest predictor of AI citation quality
|
|
2077
|
+
fact_density: 0.08,
|
|
1820
2078
|
direct_answer_density: 0.07,
|
|
1821
|
-
|
|
2079
|
+
content_depth: 0.06,
|
|
2080
|
+
// NEW v2.0: substantive content vs thin pages
|
|
2081
|
+
// ─── Structure & Discovery (medium weight - technical readiness) ────────────
|
|
2082
|
+
schema_markup: 0.08,
|
|
2083
|
+
llms_txt: 0.08,
|
|
2084
|
+
clean_html: 0.08,
|
|
2085
|
+
entity_consistency: 0.08,
|
|
2086
|
+
faq_section: 0.08,
|
|
2087
|
+
internal_linking: 0.08,
|
|
2088
|
+
// ─── Content Signals (moderate weight) ──────────────────────────────────────
|
|
2089
|
+
content_freshness: 0.06,
|
|
2090
|
+
table_list_extractability: 0.05,
|
|
2091
|
+
query_answer_alignment: 0.06,
|
|
2092
|
+
definition_patterns: 0.04,
|
|
1822
2093
|
author_schema_depth: 0.04,
|
|
1823
|
-
fact_density: 0.05,
|
|
1824
|
-
canonical_url: 0.04,
|
|
1825
|
-
content_velocity: 0.03,
|
|
1826
|
-
schema_coverage: 0.03,
|
|
1827
|
-
speakable_schema: 0.03,
|
|
1828
|
-
query_answer_alignment: 0.08,
|
|
1829
2094
|
content_cannibalization: 0.05,
|
|
1830
|
-
visible_date_signal: 0.04
|
|
2095
|
+
visible_date_signal: 0.04,
|
|
2096
|
+
semantic_html: 0.04,
|
|
2097
|
+
// ─── Plumbing (low weight - nice to have but not what drives citations) ─────
|
|
2098
|
+
robots_txt: 0.03,
|
|
2099
|
+
sitemap_completeness: 0.03,
|
|
2100
|
+
content_velocity: 0.03,
|
|
2101
|
+
rss_feed: 0.02,
|
|
2102
|
+
content_licensing: 0.03,
|
|
2103
|
+
canonical_url: 0.02,
|
|
2104
|
+
schema_coverage: 0.02,
|
|
2105
|
+
speakable_schema: 0.02
|
|
1831
2106
|
};
|
|
1832
2107
|
function calculateOverallScore(criteria) {
|
|
1833
2108
|
let totalWeight = 0;
|
|
1834
2109
|
let weightedSum = 0;
|
|
1835
2110
|
for (const c of criteria) {
|
|
1836
|
-
const weight = WEIGHTS[c.criterion] ?? 0.
|
|
2111
|
+
const weight = WEIGHTS[c.criterion] ?? 0.05;
|
|
1837
2112
|
weightedSum += c.score / 10 * weight * 100;
|
|
1838
2113
|
totalWeight += weight;
|
|
1839
2114
|
}
|
|
@@ -1969,7 +2244,9 @@ var CRITERION_LABELS = {
|
|
|
1969
2244
|
"Speakable Schema": "Speakable Schema",
|
|
1970
2245
|
"Query-Answer Alignment": "Query-Answer Alignment",
|
|
1971
2246
|
"Content Cannibalization": "Content Cannibalization",
|
|
1972
|
-
"Visible Date Signal": "Visible Date Signal"
|
|
2247
|
+
"Visible Date Signal": "Visible Date Signal",
|
|
2248
|
+
"Topic Coherence": "Topic Coherence",
|
|
2249
|
+
"Content Depth": "Content Depth"
|
|
1973
2250
|
};
|
|
1974
2251
|
function scoreToStatus(score) {
|
|
1975
2252
|
if (score === 0) return "MISSING";
|
|
@@ -2878,7 +3155,7 @@ function extractTitle(html) {
|
|
|
2878
3155
|
function getTextContent2(html) {
|
|
2879
3156
|
return html.replace(/<script[\s\S]*?<\/script>/gi, "").replace(/<style[\s\S]*?<\/style>/gi, "").replace(/<[^>]*>/g, " ").replace(/\s+/g, " ").trim();
|
|
2880
3157
|
}
|
|
2881
|
-
function
|
|
3158
|
+
function countWords2(text) {
|
|
2882
3159
|
if (!text) return 0;
|
|
2883
3160
|
return text.split(/\s+/).filter((w) => w.length > 0).length;
|
|
2884
3161
|
}
|
|
@@ -3029,7 +3306,7 @@ function checkHasQuestionHeadings(html) {
|
|
|
3029
3306
|
function analyzePage(html, url, category) {
|
|
3030
3307
|
const title = extractTitle(html);
|
|
3031
3308
|
const textContent = getTextContent2(html);
|
|
3032
|
-
const wordCount =
|
|
3309
|
+
const wordCount = countWords2(textContent);
|
|
3033
3310
|
const issues = [];
|
|
3034
3311
|
const strengths = [];
|
|
3035
3312
|
const issueChecks = [
|
|
@@ -3109,7 +3386,7 @@ async function audit(domain, options) {
|
|
|
3109
3386
|
}
|
|
3110
3387
|
}
|
|
3111
3388
|
if (options?.fullCrawl) {
|
|
3112
|
-
const { crawlFullSite: crawlFullSite2 } = await import("./full-site-crawler-
|
|
3389
|
+
const { crawlFullSite: crawlFullSite2 } = await import("./full-site-crawler-UIOMKOZA.js");
|
|
3113
3390
|
const crawlResult = await crawlFullSite2(siteData, {
|
|
3114
3391
|
maxPages: options.maxPages ?? 200,
|
|
3115
3392
|
concurrency: options.concurrency ?? 5
|
|
@@ -3179,7 +3456,7 @@ function extractTitle2(html) {
|
|
|
3179
3456
|
function getTextContent3(html) {
|
|
3180
3457
|
return html.replace(/<script[\s\S]*?<\/script>/gi, "").replace(/<style[\s\S]*?<\/style>/gi, "").replace(/<[^>]*>/g, " ").replace(/\s+/g, " ").trim();
|
|
3181
3458
|
}
|
|
3182
|
-
function
|
|
3459
|
+
function countWords3(text) {
|
|
3183
3460
|
if (!text) return 0;
|
|
3184
3461
|
return text.split(/\s+/).filter((w) => w.length > 0).length;
|
|
3185
3462
|
}
|
|
@@ -3327,7 +3604,7 @@ function buildLinkGraph(pages, domain, homepageUrl) {
|
|
|
3327
3604
|
if (nodes.has(norm)) continue;
|
|
3328
3605
|
const title = extractTitle2(page.text);
|
|
3329
3606
|
const text = getTextContent3(page.text);
|
|
3330
|
-
const wordCount =
|
|
3607
|
+
const wordCount = countWords3(text);
|
|
3331
3608
|
nodes.set(norm, {
|
|
3332
3609
|
url: norm,
|
|
3333
3610
|
title,
|