@rivi-software/agentic-seo-check 0.0.0-stage → 0.1.1
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/LICENSE +21 -0
- package/README.md +210 -2
- package/dist/brand.d.ts +11 -0
- package/dist/brand.js +22 -0
- package/dist/brand.js.map +1 -0
- package/dist/cli.d.ts +2 -0
- package/dist/cli.js +194 -0
- package/dist/cli.js.map +1 -0
- package/dist/core/audit.d.ts +72 -0
- package/dist/core/audit.js +452 -0
- package/dist/core/audit.js.map +1 -0
- package/dist/core/concurrency.d.ts +4 -0
- package/dist/core/concurrency.js +39 -0
- package/dist/core/concurrency.js.map +1 -0
- package/dist/core/crawl.d.ts +40 -0
- package/dist/core/crawl.js +324 -0
- package/dist/core/crawl.js.map +1 -0
- package/dist/core/fetch.d.ts +27 -0
- package/dist/core/fetch.js +186 -0
- package/dist/core/fetch.js.map +1 -0
- package/dist/core/html/dom.d.ts +13 -0
- package/dist/core/html/dom.js +17 -0
- package/dist/core/html/dom.js.map +1 -0
- package/dist/core/html/extract.d.ts +10 -0
- package/dist/core/html/extract.js +207 -0
- package/dist/core/html/extract.js.map +1 -0
- package/dist/core/html/structured-data.d.ts +21 -0
- package/dist/core/html/structured-data.js +220 -0
- package/dist/core/html/structured-data.js.map +1 -0
- package/dist/core/html/text.d.ts +23 -0
- package/dist/core/html/text.js +152 -0
- package/dist/core/html/text.js.map +1 -0
- package/dist/core/lighthouse.d.ts +50 -0
- package/dist/core/lighthouse.js +216 -0
- package/dist/core/lighthouse.js.map +1 -0
- package/dist/core/performance-rules.d.ts +3 -0
- package/dist/core/performance-rules.js +125 -0
- package/dist/core/performance-rules.js.map +1 -0
- package/dist/core/render-rules.d.ts +8 -0
- package/dist/core/render-rules.js +144 -0
- package/dist/core/render-rules.js.map +1 -0
- package/dist/core/render.d.ts +22 -0
- package/dist/core/render.js +79 -0
- package/dist/core/render.js.map +1 -0
- package/dist/core/report/markdown.d.ts +2 -0
- package/dist/core/report/markdown.js +131 -0
- package/dist/core/report/markdown.js.map +1 -0
- package/dist/core/robots.d.ts +11 -0
- package/dist/core/robots.js +48 -0
- package/dist/core/robots.js.map +1 -0
- package/dist/core/rules/canonical.d.ts +2 -0
- package/dist/core/rules/canonical.js +141 -0
- package/dist/core/rules/canonical.js.map +1 -0
- package/dist/core/rules/content.d.ts +1 -0
- package/dist/core/rules/content.js +55 -0
- package/dist/core/rules/content.js.map +1 -0
- package/dist/core/rules/document.d.ts +1 -0
- package/dist/core/rules/document.js +83 -0
- package/dist/core/rules/document.js.map +1 -0
- package/dist/core/rules/headings.d.ts +1 -0
- package/dist/core/rules/headings.js +81 -0
- package/dist/core/rules/headings.js.map +1 -0
- package/dist/core/rules/hreflang.d.ts +1 -0
- package/dist/core/rules/hreflang.js +100 -0
- package/dist/core/rules/hreflang.js.map +1 -0
- package/dist/core/rules/images.d.ts +1 -0
- package/dist/core/rules/images.js +77 -0
- package/dist/core/rules/images.js.map +1 -0
- package/dist/core/rules/index.d.ts +14 -0
- package/dist/core/rules/index.js +77 -0
- package/dist/core/rules/index.js.map +1 -0
- package/dist/core/rules/indexing.d.ts +10 -0
- package/dist/core/rules/indexing.js +75 -0
- package/dist/core/rules/indexing.js.map +1 -0
- package/dist/core/rules/keyword.d.ts +1 -0
- package/dist/core/rules/keyword.js +111 -0
- package/dist/core/rules/keyword.js.map +1 -0
- package/dist/core/rules/links.d.ts +1 -0
- package/dist/core/rules/links.js +107 -0
- package/dist/core/rules/links.js.map +1 -0
- package/dist/core/rules/meta.d.ts +1 -0
- package/dist/core/rules/meta.js +81 -0
- package/dist/core/rules/meta.js.map +1 -0
- package/dist/core/rules/response.d.ts +1 -0
- package/dist/core/rules/response.js +93 -0
- package/dist/core/rules/response.js.map +1 -0
- package/dist/core/rules/rule.d.ts +42 -0
- package/dist/core/rules/rule.js +51 -0
- package/dist/core/rules/rule.js.map +1 -0
- package/dist/core/rules/social.d.ts +1 -0
- package/dist/core/rules/social.js +115 -0
- package/dist/core/rules/social.js.map +1 -0
- package/dist/core/rules/structured-data.d.ts +25 -0
- package/dist/core/rules/structured-data.js +381 -0
- package/dist/core/rules/structured-data.js.map +1 -0
- package/dist/core/rules/title.d.ts +1 -0
- package/dist/core/rules/title.js +74 -0
- package/dist/core/rules/title.js.map +1 -0
- package/dist/core/score.d.ts +3 -0
- package/dist/core/score.js +17 -0
- package/dist/core/score.js.map +1 -0
- package/dist/core/site-rules.d.ts +64 -0
- package/dist/core/site-rules.js +462 -0
- package/dist/core/site-rules.js.map +1 -0
- package/dist/core/sitemap.d.ts +13 -0
- package/dist/core/sitemap.js +140 -0
- package/dist/core/sitemap.js.map +1 -0
- package/dist/core/static.d.ts +9 -0
- package/dist/core/static.js +281 -0
- package/dist/core/static.js.map +1 -0
- package/dist/core/summary.d.ts +2 -0
- package/dist/core/summary.js +33 -0
- package/dist/core/summary.js.map +1 -0
- package/dist/core/types.d.ts +296 -0
- package/dist/core/types.js +33 -0
- package/dist/core/types.js.map +1 -0
- package/dist/core/url.d.ts +20 -0
- package/dist/core/url.js +191 -0
- package/dist/core/url.js.map +1 -0
- package/dist/index.d.ts +11 -0
- package/dist/index.js +10 -0
- package/dist/index.js.map +1 -0
- package/dist/mcp-bin.d.ts +2 -0
- package/dist/mcp-bin.js +10 -0
- package/dist/mcp-bin.js.map +1 -0
- package/dist/mcp.d.ts +5 -0
- package/dist/mcp.js +380 -0
- package/dist/mcp.js.map +1 -0
- package/dist/version.d.ts +1 -0
- package/dist/version.js +6 -0
- package/dist/version.js.map +1 -0
- package/package.json +107 -3
- package/skills/seo-audit/SKILL.md +53 -0
|
@@ -0,0 +1,452 @@
|
|
|
1
|
+
import { promises as fs } from "node:fs";
|
|
2
|
+
import path from "node:path";
|
|
3
|
+
import { crawlSite } from "./crawl.js";
|
|
4
|
+
import { DEFAULT_USER_AGENT, fetchPage, toResponseInfo } from "./fetch.js";
|
|
5
|
+
import { extractPage } from "./html/extract.js";
|
|
6
|
+
import { runLighthouse, LighthouseUnavailableError } from "./lighthouse.js";
|
|
7
|
+
import { performanceFindings } from "./performance-rules.js";
|
|
8
|
+
import { compareRender } from "./render-rules.js";
|
|
9
|
+
import { renderPage, RenderUnavailableError } from "./render.js";
|
|
10
|
+
import { runPageRules, sortFindings } from "./rules/index.js";
|
|
11
|
+
import { pageScore, siteScore } from "./score.js";
|
|
12
|
+
import { runSiteRules } from "./site-rules.js";
|
|
13
|
+
import { scanDirectory } from "./static.js";
|
|
14
|
+
import { buildSummary } from "./summary.js";
|
|
15
|
+
import { countFindings, DEFAULT_THRESHOLDS } from "./types.js";
|
|
16
|
+
import { isHttpUrl } from "./url.js";
|
|
17
|
+
export const DEFAULT_CRAWL = {
|
|
18
|
+
maxPages: 50,
|
|
19
|
+
maxDepth: 3,
|
|
20
|
+
concurrency: 5,
|
|
21
|
+
delayMs: 0,
|
|
22
|
+
maxLinkChecks: 200,
|
|
23
|
+
};
|
|
24
|
+
const toolFinding = (rule, message, url) => ({
|
|
25
|
+
rule,
|
|
26
|
+
severity: "info",
|
|
27
|
+
category: "tool",
|
|
28
|
+
message,
|
|
29
|
+
recommendation: "Install the optional dependency (see message) or run without this option. The rest of the audit is complete.",
|
|
30
|
+
url,
|
|
31
|
+
});
|
|
32
|
+
// The raw HTML is not kept on the audit (too large); re-fetch it for the render comparison.
|
|
33
|
+
const rawHtmlFor = async (audit, options) => {
|
|
34
|
+
const res = await fetchPage(audit.response?.finalUrl ?? audit.url, options.fetch ?? {});
|
|
35
|
+
return res.body ?? "";
|
|
36
|
+
};
|
|
37
|
+
/** Renders the page in Chromium and compares it with the server HTML, on `audit.rendering`. */
|
|
38
|
+
const renderFindings = async (audit, options, url) => {
|
|
39
|
+
options.onProgress?.({
|
|
40
|
+
phase: "render",
|
|
41
|
+
message: `Rendering ${url} with Playwright`,
|
|
42
|
+
});
|
|
43
|
+
try {
|
|
44
|
+
const rendered = await renderPage(url, {
|
|
45
|
+
timeoutMs: Math.max(options.fetch?.timeoutMs ?? 0, 30_000),
|
|
46
|
+
userAgent: options.fetch?.userAgent,
|
|
47
|
+
headers: options.fetch?.headers,
|
|
48
|
+
});
|
|
49
|
+
const rawPage = extractPage(await rawHtmlFor(audit, options), {
|
|
50
|
+
url,
|
|
51
|
+
includeSubdomains: options.includeSubdomains,
|
|
52
|
+
});
|
|
53
|
+
const renderedPage = extractPage(rendered.html, {
|
|
54
|
+
url: rendered.finalUrl,
|
|
55
|
+
siteHost: new URL(url).hostname,
|
|
56
|
+
includeSubdomains: options.includeSubdomains,
|
|
57
|
+
});
|
|
58
|
+
const { comparison, findings } = compareRender(rawPage, renderedPage, rendered.finalUrl, rendered.consoleErrors, audit.response);
|
|
59
|
+
audit.rendering = comparison;
|
|
60
|
+
return findings;
|
|
61
|
+
}
|
|
62
|
+
catch (error) {
|
|
63
|
+
return [
|
|
64
|
+
toolFinding("tool.render-unavailable", error instanceof RenderUnavailableError
|
|
65
|
+
? error.message
|
|
66
|
+
: `Rendering failed: ${error instanceof Error ? error.message : String(error)}`, url),
|
|
67
|
+
];
|
|
68
|
+
}
|
|
69
|
+
};
|
|
70
|
+
/** Runs Lighthouse on the page, on `audit.performance`. */
|
|
71
|
+
const lighthouseFindings = async (audit, options, url) => {
|
|
72
|
+
options.onProgress?.({
|
|
73
|
+
phase: "lighthouse",
|
|
74
|
+
message: `Running Lighthouse (${options.formFactor ?? "mobile"}) on ${url}`,
|
|
75
|
+
});
|
|
76
|
+
try {
|
|
77
|
+
const perf = await runLighthouse(url, {
|
|
78
|
+
formFactor: options.formFactor ?? "mobile",
|
|
79
|
+
userAgent: options.fetch?.userAgent,
|
|
80
|
+
headers: options.fetch?.headers,
|
|
81
|
+
});
|
|
82
|
+
audit.performance = perf;
|
|
83
|
+
return performanceFindings(perf);
|
|
84
|
+
}
|
|
85
|
+
catch (error) {
|
|
86
|
+
return [
|
|
87
|
+
toolFinding("tool.lighthouse-unavailable", error instanceof LighthouseUnavailableError
|
|
88
|
+
? error.message
|
|
89
|
+
: `Lighthouse failed: ${error instanceof Error ? error.message : String(error)}`, url),
|
|
90
|
+
];
|
|
91
|
+
}
|
|
92
|
+
};
|
|
93
|
+
const enrichPage = async (audit, options) => {
|
|
94
|
+
const url = audit.response?.finalUrl ?? audit.url;
|
|
95
|
+
const extra = [];
|
|
96
|
+
if (options.render) {
|
|
97
|
+
extra.push(...(await renderFindings(audit, options, url)));
|
|
98
|
+
}
|
|
99
|
+
if (options.lighthouse) {
|
|
100
|
+
extra.push(...(await lighthouseFindings(audit, options, url)));
|
|
101
|
+
}
|
|
102
|
+
if (extra.length) {
|
|
103
|
+
const filtered = options.includeInfo === false
|
|
104
|
+
? extra.filter((f) => f.severity !== "info")
|
|
105
|
+
: extra;
|
|
106
|
+
audit.findings = sortFindings([...audit.findings, ...filtered]);
|
|
107
|
+
audit.counts = countFindings(audit.findings);
|
|
108
|
+
audit.score = pageScore(audit.counts);
|
|
109
|
+
}
|
|
110
|
+
};
|
|
111
|
+
const auditRecord = (record, source, options) => {
|
|
112
|
+
const thresholds = { ...DEFAULT_THRESHOLDS, ...options.thresholds };
|
|
113
|
+
let findings = runPageRules({
|
|
114
|
+
page: record.page,
|
|
115
|
+
source,
|
|
116
|
+
response: record.response,
|
|
117
|
+
keyword: options.keyword,
|
|
118
|
+
thresholds,
|
|
119
|
+
depth: record.depth,
|
|
120
|
+
}, { disable: new Set(options.disableRules) });
|
|
121
|
+
if (options.includeInfo === false) {
|
|
122
|
+
findings = findings.filter((f) => f.severity !== "info");
|
|
123
|
+
}
|
|
124
|
+
const audit = {
|
|
125
|
+
schemaVersion: 1,
|
|
126
|
+
kind: "page",
|
|
127
|
+
target: record.file ?? record.requestedUrl,
|
|
128
|
+
url: record.file ?? record.url,
|
|
129
|
+
source,
|
|
130
|
+
auditedAt: new Date().toISOString(),
|
|
131
|
+
summary: buildSummary(record.page, record.response),
|
|
132
|
+
findings,
|
|
133
|
+
counts: countFindings(findings),
|
|
134
|
+
score: 0,
|
|
135
|
+
depth: record.depth,
|
|
136
|
+
};
|
|
137
|
+
if (record.response) {
|
|
138
|
+
audit.response = record.response;
|
|
139
|
+
}
|
|
140
|
+
audit.score = pageScore(audit.counts);
|
|
141
|
+
return audit;
|
|
142
|
+
};
|
|
143
|
+
export const rollupIssues = (pages) => {
|
|
144
|
+
const map = new Map();
|
|
145
|
+
for (const page of pages) {
|
|
146
|
+
const seenHere = new Set();
|
|
147
|
+
for (const f of page.findings) {
|
|
148
|
+
if (seenHere.has(f.rule)) {
|
|
149
|
+
continue;
|
|
150
|
+
}
|
|
151
|
+
seenHere.add(f.rule);
|
|
152
|
+
let entry = map.get(f.rule);
|
|
153
|
+
if (!entry) {
|
|
154
|
+
entry = {
|
|
155
|
+
rule: f.rule,
|
|
156
|
+
severity: f.severity,
|
|
157
|
+
category: f.category,
|
|
158
|
+
pages: 0,
|
|
159
|
+
message: f.message,
|
|
160
|
+
recommendation: f.recommendation,
|
|
161
|
+
examples: [],
|
|
162
|
+
urls: new Set(),
|
|
163
|
+
};
|
|
164
|
+
map.set(f.rule, entry);
|
|
165
|
+
}
|
|
166
|
+
entry.pages += 1;
|
|
167
|
+
entry.urls.add(page.url);
|
|
168
|
+
}
|
|
169
|
+
}
|
|
170
|
+
const rank = { error: 0, warning: 1, info: 2 };
|
|
171
|
+
return [...map.values()]
|
|
172
|
+
.toSorted((a, b) => rank[a.severity] - rank[b.severity] || b.pages - a.pages)
|
|
173
|
+
.map(({ urls, ...rest }) => ({
|
|
174
|
+
...rest,
|
|
175
|
+
examples: [...urls].slice(0, 10),
|
|
176
|
+
}));
|
|
177
|
+
};
|
|
178
|
+
export const recomputeSite = (site) => {
|
|
179
|
+
const counts = countFindings(site.siteFindings);
|
|
180
|
+
for (const p of site.pages) {
|
|
181
|
+
counts.error += p.counts.error;
|
|
182
|
+
counts.warning += p.counts.warning;
|
|
183
|
+
counts.info += p.counts.info;
|
|
184
|
+
}
|
|
185
|
+
site.counts = counts;
|
|
186
|
+
site.issues = rollupIssues(site.pages);
|
|
187
|
+
site.score = siteScore(site.pages, site.siteFindings);
|
|
188
|
+
};
|
|
189
|
+
const buildSiteAudit = (result, source, target, options) => {
|
|
190
|
+
options.onProgress?.({
|
|
191
|
+
phase: "rules",
|
|
192
|
+
message: `Evaluating rules for ${result.records.length} pages`,
|
|
193
|
+
});
|
|
194
|
+
const thresholds = { ...DEFAULT_THRESHOLDS, ...options.thresholds };
|
|
195
|
+
const pages = result.records.map((record) => auditRecord(record, source === "directory" ? "file" : "url", options));
|
|
196
|
+
let siteFindings = runSiteRules({
|
|
197
|
+
startUrl: result.startUrl,
|
|
198
|
+
source,
|
|
199
|
+
pages: result.records,
|
|
200
|
+
linkChecks: result.linkChecks,
|
|
201
|
+
linkSources: result.linkSources,
|
|
202
|
+
externalChecks: result.externalChecks,
|
|
203
|
+
externalSources: result.externalSources,
|
|
204
|
+
robots: result.robots,
|
|
205
|
+
robotsAllows: result.robotsAllows,
|
|
206
|
+
blockedByRobots: result.blockedByRobots,
|
|
207
|
+
sitemaps: result.sitemaps,
|
|
208
|
+
probes: result.probes,
|
|
209
|
+
crawl: result.stats,
|
|
210
|
+
thresholds,
|
|
211
|
+
pathOnly: source === "directory",
|
|
212
|
+
unlinkedPages: result.unlinkedPages,
|
|
213
|
+
});
|
|
214
|
+
const disabled = new Set(options.disableRules);
|
|
215
|
+
siteFindings = sortFindings(siteFindings.filter((f) => !disabled.has(f.rule)));
|
|
216
|
+
if (options.includeInfo === false) {
|
|
217
|
+
siteFindings = siteFindings.filter((f) => f.severity !== "info");
|
|
218
|
+
}
|
|
219
|
+
const site = {
|
|
220
|
+
schemaVersion: 1,
|
|
221
|
+
kind: "site",
|
|
222
|
+
target,
|
|
223
|
+
source,
|
|
224
|
+
auditedAt: new Date().toISOString(),
|
|
225
|
+
crawl: result.stats,
|
|
226
|
+
robotsTxt: result.robots,
|
|
227
|
+
sitemaps: { ...result.sitemaps, urls: result.sitemaps.urls.slice(0, 200) },
|
|
228
|
+
pages: pages.toSorted((a, b) => (a.depth ?? 0) - (b.depth ?? 0) || a.score - b.score),
|
|
229
|
+
siteFindings,
|
|
230
|
+
issues: [],
|
|
231
|
+
counts: { error: 0, warning: 0, info: 0 },
|
|
232
|
+
score: 0,
|
|
233
|
+
};
|
|
234
|
+
recomputeSite(site);
|
|
235
|
+
return site;
|
|
236
|
+
};
|
|
237
|
+
/** Keeps only each page's summary when the caller asked for `pageDetail: "summary"`. */
|
|
238
|
+
const applyPageDetail = (site, options) => {
|
|
239
|
+
if (options.pageDetail === "summary") {
|
|
240
|
+
site.pages = site.pages.map((p) => ({
|
|
241
|
+
...p,
|
|
242
|
+
findings: [],
|
|
243
|
+
summary: { ...p.summary, headings: [], openGraph: {} },
|
|
244
|
+
}));
|
|
245
|
+
}
|
|
246
|
+
return site;
|
|
247
|
+
};
|
|
248
|
+
const readStdin = async () => {
|
|
249
|
+
const chunks = [];
|
|
250
|
+
for await (const chunk of process.stdin) {
|
|
251
|
+
chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));
|
|
252
|
+
}
|
|
253
|
+
return Buffer.concat(chunks).toString("utf-8");
|
|
254
|
+
};
|
|
255
|
+
/** Audit an HTML string. `url` is used to resolve links and for display. */
|
|
256
|
+
// oxlint-disable-next-line eslint/require-await -- public API: it returns a promise like the other audit functions, so a throw reaches callers as a rejection
|
|
257
|
+
export const auditHtml = async (html, input = {}, options = {}) => {
|
|
258
|
+
const url = input.url ?? options.baseUrl ?? "http://localhost/";
|
|
259
|
+
const page = extractPage(html, {
|
|
260
|
+
url,
|
|
261
|
+
includeSubdomains: options.includeSubdomains,
|
|
262
|
+
});
|
|
263
|
+
const source = input.source ?? "html";
|
|
264
|
+
const thresholds = { ...DEFAULT_THRESHOLDS, ...options.thresholds };
|
|
265
|
+
let findings = runPageRules({
|
|
266
|
+
page,
|
|
267
|
+
source,
|
|
268
|
+
response: input.response,
|
|
269
|
+
keyword: options.keyword,
|
|
270
|
+
thresholds,
|
|
271
|
+
depth: input.depth,
|
|
272
|
+
}, { disable: new Set(options.disableRules) });
|
|
273
|
+
if (options.includeInfo === false) {
|
|
274
|
+
findings = findings.filter((f) => f.severity !== "info");
|
|
275
|
+
}
|
|
276
|
+
const audit = {
|
|
277
|
+
schemaVersion: 1,
|
|
278
|
+
kind: "page",
|
|
279
|
+
target: input.target ?? url,
|
|
280
|
+
url: input.response?.finalUrl ?? url,
|
|
281
|
+
source,
|
|
282
|
+
auditedAt: new Date().toISOString(),
|
|
283
|
+
summary: buildSummary(page, input.response),
|
|
284
|
+
findings,
|
|
285
|
+
counts: countFindings(findings),
|
|
286
|
+
score: 0,
|
|
287
|
+
};
|
|
288
|
+
if (input.response) {
|
|
289
|
+
audit.response = input.response;
|
|
290
|
+
}
|
|
291
|
+
if (input.depth !== undefined) {
|
|
292
|
+
audit.depth = input.depth;
|
|
293
|
+
}
|
|
294
|
+
audit.score = pageScore(audit.counts);
|
|
295
|
+
return audit;
|
|
296
|
+
};
|
|
297
|
+
/** Fetch and audit one URL. Optionally render and/or run Lighthouse. */
|
|
298
|
+
export const auditUrl = async (url, options = {}) => {
|
|
299
|
+
const res = await fetchPage(url, options.fetch ?? {});
|
|
300
|
+
const response = toResponseInfo(res);
|
|
301
|
+
const audit = await auditHtml(res.body ?? "", { url: res.finalUrl, response, source: "url", target: url }, options);
|
|
302
|
+
if (res.error) {
|
|
303
|
+
audit.findings.unshift({
|
|
304
|
+
rule: "response.fetch-failed",
|
|
305
|
+
severity: "error",
|
|
306
|
+
category: "response",
|
|
307
|
+
message: `Could not fetch ${url}: ${res.error}`,
|
|
308
|
+
recommendation: "Check that the URL is reachable from this machine (DNS, TLS, firewall, dev server running) and that it responds within the timeout.",
|
|
309
|
+
url,
|
|
310
|
+
evidence: { error: res.error, redirectChain: res.redirectChain },
|
|
311
|
+
});
|
|
312
|
+
audit.counts = countFindings(audit.findings);
|
|
313
|
+
audit.score = pageScore(audit.counts);
|
|
314
|
+
return audit;
|
|
315
|
+
}
|
|
316
|
+
await enrichPage(audit, options);
|
|
317
|
+
return audit;
|
|
318
|
+
};
|
|
319
|
+
/** Audit a single .html file from disk. */
|
|
320
|
+
export const auditFile = async (filePath, options = {}) => {
|
|
321
|
+
const html = await fs.readFile(filePath, "utf-8");
|
|
322
|
+
const base = options.baseUrl ?? "http://localhost/";
|
|
323
|
+
const url = new URL(`/${path.basename(filePath)}`, base.endsWith("/") ? base : `${base}/`).href;
|
|
324
|
+
return auditHtml(html, { url, source: "file", target: filePath }, options);
|
|
325
|
+
};
|
|
326
|
+
/** Crawl a site and audit every page plus site-level checks. */
|
|
327
|
+
export const auditSite = async (startUrl, options = {}) => {
|
|
328
|
+
const fetchOpts = { ...options.fetch };
|
|
329
|
+
fetchOpts.userAgent ??= DEFAULT_USER_AGENT;
|
|
330
|
+
const internal = {
|
|
331
|
+
maxPages: options.maxPages ?? DEFAULT_CRAWL.maxPages,
|
|
332
|
+
maxDepth: options.maxDepth ?? DEFAULT_CRAWL.maxDepth,
|
|
333
|
+
concurrency: options.concurrency ?? DEFAULT_CRAWL.concurrency,
|
|
334
|
+
delayMs: options.delayMs ?? DEFAULT_CRAWL.delayMs,
|
|
335
|
+
respectRobots: options.respectRobots ?? true,
|
|
336
|
+
includeSubdomains: options.includeSubdomains ?? false,
|
|
337
|
+
checkExternalLinks: options.checkExternalLinks ?? false,
|
|
338
|
+
maxLinkChecks: options.maxLinkChecks ?? DEFAULT_CRAWL.maxLinkChecks,
|
|
339
|
+
// oxlint-disable-next-line eslint/require-unicode-regexp -- the user's own patterns, in JavaScript's default syntax; the u flag would reject some of them
|
|
340
|
+
includePatterns: (options.includePatterns ?? []).map((p) => new RegExp(p)),
|
|
341
|
+
// oxlint-disable-next-line eslint/require-unicode-regexp -- the user's own patterns, in JavaScript's default syntax; the u flag would reject some of them
|
|
342
|
+
excludePatterns: (options.excludePatterns ?? []).map((p) => new RegExp(p)),
|
|
343
|
+
fetch: fetchOpts,
|
|
344
|
+
onProgress: options.onProgress,
|
|
345
|
+
};
|
|
346
|
+
const result = await crawlSite(startUrl, internal);
|
|
347
|
+
const site = buildSiteAudit(result, "crawl", startUrl, options);
|
|
348
|
+
// Render/Lighthouse are expensive: apply them to the start page only.
|
|
349
|
+
const startPage = site.pages.find((p) => p.depth === 0) ?? site.pages[0];
|
|
350
|
+
if (startPage && (options.render || options.lighthouse)) {
|
|
351
|
+
await enrichPage(startPage, options);
|
|
352
|
+
recomputeSite(site);
|
|
353
|
+
}
|
|
354
|
+
return applyPageDetail(site, options);
|
|
355
|
+
};
|
|
356
|
+
/** Audit a directory of built HTML files (dist/, out/, build/). */
|
|
357
|
+
export const auditDirectory = async (dir, options = {}) => {
|
|
358
|
+
const result = await scanDirectory(dir, {
|
|
359
|
+
baseUrl: options.baseUrl ?? "http://localhost/",
|
|
360
|
+
includeSubdomains: options.includeSubdomains ?? false,
|
|
361
|
+
maxPages: options.maxPages ?? 500,
|
|
362
|
+
userAgent: options.fetch?.userAgent,
|
|
363
|
+
});
|
|
364
|
+
const site = buildSiteAudit(result, "directory", dir, options);
|
|
365
|
+
return applyPageDetail(site, options);
|
|
366
|
+
};
|
|
367
|
+
/**
|
|
368
|
+
* Auto-detect the target type: http(s) URL, directory, .html file, or "-" for stdin.
|
|
369
|
+
* `crawl` forces a site crawl for URLs.
|
|
370
|
+
*/
|
|
371
|
+
export const auditTarget = async (target, options = {}) => {
|
|
372
|
+
if (target === "-" || options.stdinHtml !== undefined) {
|
|
373
|
+
const html = options.stdinHtml ?? (await readStdin());
|
|
374
|
+
return auditHtml(html, { url: options.baseUrl, source: "html", target: "stdin" }, options);
|
|
375
|
+
}
|
|
376
|
+
if (isHttpUrl(target)) {
|
|
377
|
+
return options.crawl
|
|
378
|
+
? auditSite(target, options)
|
|
379
|
+
: auditUrl(target, options);
|
|
380
|
+
}
|
|
381
|
+
if (/^localhost(?::\d+)?(?:\/|$)/iu.test(target) ||
|
|
382
|
+
/^[\w.-]+\.[a-z]{2,}(?:\/|$)/iu.test(target)) {
|
|
383
|
+
const url = `http${/^localhost/iu.test(target) ? "" : "s"}://${target}`;
|
|
384
|
+
return options.crawl ? auditSite(url, options) : auditUrl(url, options);
|
|
385
|
+
}
|
|
386
|
+
const stat = await fs.stat(target).catch(() => null);
|
|
387
|
+
if (!stat) {
|
|
388
|
+
throw new Error(`Target "${target}" is not a URL, file or directory.`);
|
|
389
|
+
}
|
|
390
|
+
if (stat.isDirectory()) {
|
|
391
|
+
return auditDirectory(target, options);
|
|
392
|
+
}
|
|
393
|
+
return auditFile(target, options);
|
|
394
|
+
};
|
|
395
|
+
/** Keeps the first three items of every evidence list. */
|
|
396
|
+
const trimFinding = (f) => {
|
|
397
|
+
if (!f.evidence) {
|
|
398
|
+
return f;
|
|
399
|
+
}
|
|
400
|
+
const evidence = {};
|
|
401
|
+
for (const [k, v] of Object.entries(f.evidence)) {
|
|
402
|
+
evidence[k] = Array.isArray(v) ? v.slice(0, 3) : v;
|
|
403
|
+
}
|
|
404
|
+
return { ...f, evidence };
|
|
405
|
+
};
|
|
406
|
+
const trimPage = (p) => {
|
|
407
|
+
const { performance, rendering, ...rest } = p;
|
|
408
|
+
const out = {
|
|
409
|
+
...rest,
|
|
410
|
+
summary: {
|
|
411
|
+
...p.summary,
|
|
412
|
+
headings: p.summary.headings.slice(0, 10),
|
|
413
|
+
openGraph: {},
|
|
414
|
+
},
|
|
415
|
+
findings: p.findings.map(trimFinding),
|
|
416
|
+
};
|
|
417
|
+
if (p.response) {
|
|
418
|
+
out.response = { ...p.response, headers: {} };
|
|
419
|
+
}
|
|
420
|
+
if (performance) {
|
|
421
|
+
out.performance = {
|
|
422
|
+
...performance,
|
|
423
|
+
opportunities: performance.opportunities.slice(0, 5),
|
|
424
|
+
agenticBrowsingAudits: [],
|
|
425
|
+
failedSeoAudits: performance.failedSeoAudits.slice(0, 5),
|
|
426
|
+
};
|
|
427
|
+
}
|
|
428
|
+
if (rendering) {
|
|
429
|
+
out.rendering = {
|
|
430
|
+
...rendering,
|
|
431
|
+
consoleErrors: rendering.consoleErrors.slice(0, 3),
|
|
432
|
+
};
|
|
433
|
+
}
|
|
434
|
+
return out;
|
|
435
|
+
};
|
|
436
|
+
/** Drop bulky, low-value fields to save tokens when the result is consumed by an LLM. */
|
|
437
|
+
export const compactAudit = (audit) => {
|
|
438
|
+
if (audit.kind === "page") {
|
|
439
|
+
// SAFETY: T is the page audit here (kind is "page"), and trimPage returns a page audit with
|
|
440
|
+
// every field it was given.
|
|
441
|
+
return trimPage(audit);
|
|
442
|
+
}
|
|
443
|
+
// SAFETY: T is the site audit here; the spread keeps every field and only shortens lists.
|
|
444
|
+
return {
|
|
445
|
+
...audit,
|
|
446
|
+
robotsTxt: audit.robotsTxt ? { ...audit.robotsTxt, text: null } : null,
|
|
447
|
+
sitemaps: { ...audit.sitemaps, urls: audit.sitemaps.urls.slice(0, 20) },
|
|
448
|
+
pages: audit.pages.map(trimPage),
|
|
449
|
+
siteFindings: audit.siteFindings.map(trimFinding),
|
|
450
|
+
};
|
|
451
|
+
};
|
|
452
|
+
//# sourceMappingURL=audit.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"audit.js","sourceRoot":"","sources":["../../src/core/audit.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,4 @@
|
|
|
1
|
+
/** Minimal promise pool: at most `concurrency` tasks run at once, the rest wait in order. */
|
|
2
|
+
export declare const createPool: (concurrency: number) => <T>(task: () => Promise<T>) => Promise<T>;
|
|
3
|
+
export declare const mapConcurrent: <T, R>(items: T[], concurrency: number, fn: (item: T, index: number) => Promise<R>) => Promise<R[]>;
|
|
4
|
+
export declare const sleep: (ms: number) => Promise<void>;
|
|
@@ -0,0 +1,39 @@
|
|
|
1
|
+
import { setTimeout as delay } from "node:timers/promises";
|
|
2
|
+
/** Minimal promise pool: at most `concurrency` tasks run at once, the rest wait in order. */
|
|
3
|
+
export const createPool = (concurrency) => {
|
|
4
|
+
let active = 0;
|
|
5
|
+
const queue = [];
|
|
6
|
+
return async (task) => {
|
|
7
|
+
if (active < Math.max(1, concurrency)) {
|
|
8
|
+
active += 1;
|
|
9
|
+
}
|
|
10
|
+
else {
|
|
11
|
+
// A finishing task hands its slot straight to the next in line, so `active` never drops
|
|
12
|
+
// and a newcomer cannot slip in ahead of the queue.
|
|
13
|
+
// oxlint-disable-next-line promise/avoid-new -- the wait ends on a callback another task calls, which only a new Promise can await
|
|
14
|
+
await new Promise((resolve) => {
|
|
15
|
+
queue.push(resolve);
|
|
16
|
+
});
|
|
17
|
+
}
|
|
18
|
+
try {
|
|
19
|
+
return await task();
|
|
20
|
+
}
|
|
21
|
+
finally {
|
|
22
|
+
const nextInLine = queue.shift();
|
|
23
|
+
if (nextInLine) {
|
|
24
|
+
nextInLine();
|
|
25
|
+
}
|
|
26
|
+
else {
|
|
27
|
+
active -= 1;
|
|
28
|
+
}
|
|
29
|
+
}
|
|
30
|
+
};
|
|
31
|
+
};
|
|
32
|
+
export const mapConcurrent = (items, concurrency, fn) => {
|
|
33
|
+
const run = createPool(concurrency);
|
|
34
|
+
return Promise.all(items.map((item, i) => run(() => fn(item, i))));
|
|
35
|
+
};
|
|
36
|
+
export const sleep = async (ms) => {
|
|
37
|
+
await delay(ms);
|
|
38
|
+
};
|
|
39
|
+
//# sourceMappingURL=concurrency.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"concurrency.js","sourceRoot":"","sources":["../../src/core/concurrency.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,IAAI,KAAK,EAAE,MAAM,sBAAsB,CAAC;AAE3D,6FAA6F;AAC7F,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,WAAmB,EAAE,EAAE;IAChD,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,MAAM,KAAK,GAAmB,EAAE,CAAC;IAEjC,OAAO,KAAK,EAAK,IAAsB,EAAc,EAAE;QACrD,IAAI,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,WAAW,CAAC,EAAE,CAAC;YACtC,MAAM,IAAI,CAAC,CAAC;QACd,CAAC;aAAM,CAAC;YACN,wFAAwF;YACxF,oDAAoD;YACpD,mIAAmI;YACnI,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;gBAClC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACtB,CAAC,CAAC,CAAC;QACL,CAAC;QAED,IAAI,CAAC;YACH,OAAO,MAAM,IAAI,EAAE,CAAC;QACtB,CAAC;gBAAS,CAAC;YACT,MAAM,UAAU,GAAG,KAAK,CAAC,KAAK,EAAE,CAAC;YAEjC,IAAI,UAAU,EAAE,CAAC;gBACf,UAAU,EAAE,CAAC;YACf,CAAC;iBAAM,CAAC;gBACN,MAAM,IAAI,CAAC,CAAC;YACd,CAAC;QACH,CAAC;IACH,CAAC,CAAC;AACJ,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,aAAa,GAAG,CAC3B,KAAU,EACV,WAAmB,EACnB,EAA0C,EAC5B,EAAE;IAChB,MAAM,GAAG,GAAG,UAAU,CAAC,WAAW,CAAC,CAAC;IAEpC,OAAO,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACrE,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,KAAK,GAAG,KAAK,EAAE,EAAU,EAAiB,EAAE;IACvD,MAAM,KAAK,CAAC,EAAE,CAAC,CAAC;AAClB,CAAC,CAAC"}
|
|
@@ -0,0 +1,40 @@
|
|
|
1
|
+
import type { FetchOptions } from "./fetch.js";
|
|
2
|
+
import type { LinkCheck, PageRecord, ProbeResults } from "./site-rules.js";
|
|
3
|
+
import type { CrawlStats, RobotsTxtInfo, SitemapInfo } from "./types.js";
|
|
4
|
+
export interface ProgressEvent {
|
|
5
|
+
phase: "robots" | "sitemap" | "crawl" | "links" | "probes" | "rules" | "render" | "lighthouse";
|
|
6
|
+
message: string;
|
|
7
|
+
crawled?: number;
|
|
8
|
+
discovered?: number;
|
|
9
|
+
url?: string;
|
|
10
|
+
}
|
|
11
|
+
export interface CrawlOptions {
|
|
12
|
+
maxPages: number;
|
|
13
|
+
maxDepth: number;
|
|
14
|
+
concurrency: number;
|
|
15
|
+
delayMs: number;
|
|
16
|
+
respectRobots: boolean;
|
|
17
|
+
includeSubdomains: boolean;
|
|
18
|
+
checkExternalLinks: boolean;
|
|
19
|
+
maxLinkChecks: number;
|
|
20
|
+
includePatterns: RegExp[];
|
|
21
|
+
excludePatterns: RegExp[];
|
|
22
|
+
fetch: FetchOptions;
|
|
23
|
+
onProgress?: (event: ProgressEvent) => void;
|
|
24
|
+
}
|
|
25
|
+
export interface CrawlResult {
|
|
26
|
+
startUrl: string;
|
|
27
|
+
records: PageRecord[];
|
|
28
|
+
linkChecks: Map<string, LinkCheck>;
|
|
29
|
+
linkSources: Map<string, Set<string>>;
|
|
30
|
+
externalChecks?: Map<string, LinkCheck>;
|
|
31
|
+
externalSources?: Map<string, Set<string>>;
|
|
32
|
+
robots: RobotsTxtInfo | null;
|
|
33
|
+
robotsAllows: ((url: string) => boolean) | null;
|
|
34
|
+
blockedByRobots: string[];
|
|
35
|
+
sitemaps: SitemapInfo;
|
|
36
|
+
probes: ProbeResults;
|
|
37
|
+
stats: CrawlStats;
|
|
38
|
+
unlinkedPages?: string[];
|
|
39
|
+
}
|
|
40
|
+
export declare const crawlSite: (startInput: string, options: CrawlOptions) => Promise<CrawlResult>;
|