@rivi-software/agentic-seo-check 0.1.1 → 0.2.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 +61 -5
- package/dist/cli.js +69 -26
- package/dist/cli.js.map +1 -1
- package/dist/core/aeo/audit.d.ts +44 -0
- package/dist/core/aeo/audit.js +310 -0
- package/dist/core/aeo/audit.js.map +1 -0
- package/dist/core/aeo/bots.d.ts +30 -0
- package/dist/core/aeo/bots.js +299 -0
- package/dist/core/aeo/bots.js.map +1 -0
- package/dist/core/aeo/llms-txt.d.ts +8 -0
- package/dist/core/aeo/llms-txt.js +88 -0
- package/dist/core/aeo/llms-txt.js.map +1 -0
- package/dist/core/aeo/page.d.ts +53 -0
- package/dist/core/aeo/page.js +312 -0
- package/dist/core/aeo/page.js.map +1 -0
- package/dist/core/aeo/probe.d.ts +10 -0
- package/dist/core/aeo/probe.js +53 -0
- package/dist/core/aeo/probe.js.map +1 -0
- package/dist/core/aeo/site-rules.d.ts +13 -0
- package/dist/core/aeo/site-rules.js +178 -0
- package/dist/core/aeo/site-rules.js.map +1 -0
- package/dist/core/audit.d.ts +23 -2
- package/dist/core/audit.js +47 -22
- package/dist/core/audit.js.map +1 -1
- package/dist/core/crawl.d.ts +5 -1
- package/dist/core/crawl.js +26 -7
- package/dist/core/crawl.js.map +1 -1
- package/dist/core/html/answer.d.ts +4 -0
- package/dist/core/html/answer.js +198 -0
- package/dist/core/html/answer.js.map +1 -0
- package/dist/core/html/dom.d.ts +4 -0
- package/dist/core/html/dom.js +67 -1
- package/dist/core/html/dom.js.map +1 -1
- package/dist/core/html/extract.js +5 -71
- package/dist/core/html/extract.js.map +1 -1
- package/dist/core/report/markdown.d.ts +3 -1
- package/dist/core/report/markdown.js +102 -0
- package/dist/core/report/markdown.js.map +1 -1
- package/dist/core/robots.d.ts +7 -0
- package/dist/core/robots.js +12 -1
- package/dist/core/robots.js.map +1 -1
- package/dist/core/rules/aeo.d.ts +11 -0
- package/dist/core/rules/aeo.js +423 -0
- package/dist/core/rules/aeo.js.map +1 -0
- package/dist/core/rules/index.d.ts +4 -0
- package/dist/core/rules/index.js +7 -1
- package/dist/core/rules/index.js.map +1 -1
- package/dist/core/score.d.ts +4 -2
- package/dist/core/score.js.map +1 -1
- package/dist/core/static.js +1 -0
- package/dist/core/static.js.map +1 -1
- package/dist/core/types.d.ts +177 -2
- package/dist/core/types.js.map +1 -1
- package/dist/index.d.ts +6 -2
- package/dist/index.js +4 -2
- package/dist/index.js.map +1 -1
- package/dist/mcp.js +129 -3
- package/dist/mcp.js.map +1 -1
- package/package.json +6 -2
- package/skills/seo-audit/SKILL.md +8 -2
package/README.md
CHANGED
|
@@ -8,7 +8,7 @@
|
|
|
8
8
|
</p>
|
|
9
9
|
|
|
10
10
|
<p align="center">
|
|
11
|
-
SEO analysis built for coding agents: a CLI and an MCP server that audit URLs,<br>
|
|
11
|
+
SEO and AEO analysis built for coding agents: a CLI and an MCP server that audit URLs,<br>
|
|
12
12
|
static build output or raw HTML, and return findings an agent can act on.<br>
|
|
13
13
|
Open source, from <a href="https://rivi.software">RIVI Software</a>.
|
|
14
14
|
</p>
|
|
@@ -39,13 +39,17 @@
|
|
|
39
39
|
agentic-seo-check is one core with two interfaces:
|
|
40
40
|
|
|
41
41
|
- **CLI** `agentic-seo-check` with JSON (default when piped) or Markdown output and CI-friendly exit codes.
|
|
42
|
-
- **MCP server** exposing
|
|
42
|
+
- **MCP server** exposing six tools for Claude Code, Cursor, Codex and any other MCP client.
|
|
43
43
|
|
|
44
44
|
It audits **URLs** (production, staging, `localhost` dev servers), **static build output** (`dist/`, `out/`, `build/`) and **raw HTML**, and returns findings an agent can act on: a stable rule id, severity, what is wrong, the fix, a CSS selector for where it lives, and evidence with the current values.
|
|
45
45
|
|
|
46
|
+
Two audits share that core: the **SEO audit** (`audit`, `crawl`) for search engines, and the **AEO audit** (`aeo`, answer engine optimization) for AI answer engines such as ChatGPT search, Claude, Perplexity, Google AI Overviews and AI Mode, Copilot and Gemini. Each has its own rules and its own score, so adding one never changes the other.
|
|
47
|
+
|
|
46
48
|
## What it checks
|
|
47
49
|
|
|
48
|
-
|
|
50
|
+
### SEO audit
|
|
51
|
+
|
|
52
|
+
| Area | Examples (123 rules, `agentic-seo-check rules` lists them) |
|
|
49
53
|
| --- | --- |
|
|
50
54
|
| On-page basics | title missing/long/short/placeholder ("React App"), meta description, H1 and heading outline, canonical (missing, conflicting, relative, pointing elsewhere), robots meta and `X-Robots-Tag`, `lang`, viewport, charset, doctype |
|
|
51
55
|
| Social | Open Graph completeness, absolute `og:image`, `og:url` vs canonical, Twitter card |
|
|
@@ -58,6 +62,16 @@ It audits **URLs** (production, staging, `localhost` dev servers), **static buil
|
|
|
58
62
|
| Rendering (`--render`, Playwright) | title/description/canonical/H1/content/links/structured data that only exist after JavaScript runs; noindex injected or removed by JavaScript; console errors |
|
|
59
63
|
| Performance (`--lighthouse`, Chrome) | LCP, CLS, TBT, FCP, Speed Index, TTFB with Core Web Vitals thresholds, Lighthouse opportunities with estimated savings, failed Lighthouse SEO and agentic-browsing audits |
|
|
60
64
|
|
|
65
|
+
### AEO audit
|
|
66
|
+
|
|
67
|
+
| Area | Examples (30 rules, `agentic-seo-check rules --category aeo` lists them) |
|
|
68
|
+
| --- | --- |
|
|
69
|
+
| AI crawler access | robots.txt checked per bot: search crawlers whose index AI answers draw on (Googlebot, Bingbot, Applebot; blocked is an error), answer bots (OAI-SearchBot, ChatGPT-User, Claude-SearchBot, Claude-User, PerplexityBot, Perplexity-User, Google-Extended, DuckAssistBot, MistralAI-User; a warning) and training bots (GPTBot, ClaudeBot, Applebot-Extended, CCBot, meta-externalagent; info, since opting out of training is a legitimate choice). Also an unreachable robots.txt, `Content-Signal` lines (`ai-input=no`, invalid values), the shared training opt-out `User-Agent: __usage_ai-training`, and `/llms.txt` (missing, no H1 title, no links) |
|
|
70
|
+
| Server blocks (`--ai-bots`) | requests the page with each AI bot's User-Agent and reports 403s, 429s and challenge pages that a CDN or firewall serves while robots.txt allows the bot |
|
|
71
|
+
| Snippet and AI opt-outs | noindex, `nosnippet` and `max-snippet` (Google AI Overviews and AI Mode), `noarchive` and `nocache` (Bing's controls for Copilot), `noai`/`noimageai`, `data-nosnippet` over a large share of the text; meta tags per crawler and scoped `X-Robots-Tag` values |
|
|
72
|
+
| Answer-ready content | an empty JavaScript app shell (most AI crawlers do not run JavaScript), question headings without a short direct answer, long text without subheadings, lists or tables, FAQPage/QAPage/HowTo markup whose questions, answers or steps the page does not show |
|
|
73
|
+
| Entity and freshness | article author missing or a bare name without url/sameAs, missing datePublished/dateModified, a structured-data date the page does not show, a home page without Organization or Person markup, entities without sameAs links |
|
|
74
|
+
|
|
61
75
|
## Install
|
|
62
76
|
|
|
63
77
|
Requires Node 22.19 or newer. Published on npm as [`@rivi-software/agentic-seo-check`](https://www.npmjs.com/package/@rivi-software/agentic-seo-check); the commands it installs are `agentic-seo-check` and `agentic-seo-check-mcp`.
|
|
@@ -96,11 +110,20 @@ agentic-seo-check audit https://www.example.com/widgets --keyword "blue widgets"
|
|
|
96
110
|
# CI: exit 1 when errors exist, smaller output
|
|
97
111
|
agentic-seo-check audit https://staging.example.com --crawl --fail-on error --compact --no-info
|
|
98
112
|
|
|
113
|
+
# AEO: AI crawler access, opt-outs and answer-ready content, with its own score
|
|
114
|
+
agentic-seo-check aeo https://www.example.com/guide
|
|
115
|
+
agentic-seo-check aeo https://www.example.com --crawl --max-pages 50
|
|
116
|
+
agentic-seo-check aeo https://www.example.com --ai-bots # also catch CDN/firewall blocks
|
|
117
|
+
agentic-seo-check aeo ./dist --base-url https://www.example.com # reads dist/robots.txt and dist/llms.txt
|
|
118
|
+
|
|
99
119
|
# rule reference
|
|
100
120
|
agentic-seo-check rules --category structured-data
|
|
121
|
+
agentic-seo-check rules --category aeo
|
|
101
122
|
agentic-seo-check rules --rule canonical.multiple
|
|
102
123
|
```
|
|
103
124
|
|
|
125
|
+
`aeo` takes the same targets and output, crawl and request options as `audit`, plus `--ai-bots`; it has no `--keyword`, `--render`, `--lighthouse` or `--check-external`. With `--ai-bots`, the requests come from your machine with each bot's User-Agent, not from the bots' own IP ranges: a CDN that verifies bots may treat the real crawler differently, and the findings say so. Search crawlers and robots.txt-only tokens (Google-Extended, Applebot-Extended) are never impersonated.
|
|
126
|
+
|
|
104
127
|
Exit codes: `0` success, `1` findings at or above `--fail-on`, `2` usage or runtime error. Progress goes to stderr, the report to stdout.
|
|
105
128
|
|
|
106
129
|
## MCP server
|
|
@@ -126,6 +149,7 @@ Or `claude mcp add agentic-seo-check -- npx -y @rivi-software/agentic-seo-check
|
|
|
126
149
|
| `seo_crawl_site` | Crawl and audit a site. Options: `maxPages`, `maxDepth`, `concurrency`, `delayMs`, `respectRobots`, `includeSubdomains`, `checkExternalLinks`, `includePatterns`, `excludePatterns`, `pageDetail`. |
|
|
127
150
|
| `seo_audit_directory` | Audit built HTML files in a directory. Options: `dir`, `baseUrl`, `maxPages`, `pageDetail`. |
|
|
128
151
|
| `seo_lighthouse` | Lighthouse performance + SEO + agentic-browsing for one URL. |
|
|
152
|
+
| `seo_aeo_audit` | AEO audit of one of `url` (with `crawl` for a site), `html` or `dir`. Options: `aiBots`, `baseUrl`, `maxPages`, `maxDepth`, `concurrency`, `respectRobots`, `includeSubdomains`, `pageDetail`, `includeInfo`, `disableRules`, `headers`, `format`, `detail`. |
|
|
129
153
|
| `seo_list_rules` | Rule reference, filter by `category` or `rule`. |
|
|
130
154
|
|
|
131
155
|
All tools are read-only. Results are returned both as text (JSON or Markdown) and as `structuredContent`.
|
|
@@ -164,21 +188,53 @@ All tools are read-only. Results are returned both as text (JSON or Markdown) an
|
|
|
164
188
|
|
|
165
189
|
Site audits add `crawl` stats, `robotsTxt`, `sitemaps`, `siteFindings`, `issues` (page findings rolled up per rule with example URLs) and `pages`.
|
|
166
190
|
|
|
191
|
+
An AEO audit has `kind: "aeo"` and its own score:
|
|
192
|
+
|
|
193
|
+
```jsonc
|
|
194
|
+
{
|
|
195
|
+
"schemaVersion": 1,
|
|
196
|
+
"kind": "aeo",
|
|
197
|
+
"target": "https://www.example.com/guide",
|
|
198
|
+
"url": "https://www.example.com/guide",
|
|
199
|
+
"source": "url", // or "crawl", "directory", "file", "html"
|
|
200
|
+
"score": 89, // average page score minus weighted site-wide findings
|
|
201
|
+
"counts": { "error": 0, "warning": 2, "info": 1 },
|
|
202
|
+
"summary": {
|
|
203
|
+
"pages": 1, "robotsTxt": "found", "llmsTxt": "missing",
|
|
204
|
+
"searchCrawlersBlocked": [], "answerBotsBlocked": ["Google-Extended"], "trainingBotsBlocked": ["GPTBot"],
|
|
205
|
+
"trainingPreference": "none", // the __usage_ai-training group: "allowed", "disallowed" or "none"
|
|
206
|
+
"blockedByServer": null, // with --ai-bots: the bots the server refused
|
|
207
|
+
"page": { "indexable": true, "googleSnippets": "allowed", "copilotAnswers": "allowed", "questions": 4, "...": "…" }
|
|
208
|
+
},
|
|
209
|
+
"findings": [ { "rule": "aeo.robots-blocks-answer-bot", "severity": "warning", "...": "…" } ],
|
|
210
|
+
"crawlers": { "robotsTxt": "https://www.example.com/robots.txt", "status": "found", "contentSignals": [], "bots": [
|
|
211
|
+
{ "name": "OAI-SearchBot", "operator": "OpenAI", "purpose": "answer", "usedFor": "ChatGPT search results", "robotsGroup": "wildcard", "allowed": true, "blockedPages": 0 }
|
|
212
|
+
] },
|
|
213
|
+
"llmsTxt": { "url": "https://www.example.com/llms.txt", "status": "missing", "...": "…" }
|
|
214
|
+
}
|
|
215
|
+
```
|
|
216
|
+
|
|
217
|
+
A crawl or directory adds `pages` (each page's score and summary) and `issues`. `findings` holds the site-wide findings plus every page finding, except for a site audited with `pageDetail: "summary"` (the MCP default), where page findings are only rolled up in `issues`.
|
|
218
|
+
|
|
167
219
|
## Library
|
|
168
220
|
|
|
169
221
|
```ts
|
|
170
|
-
import { auditUrl, auditSite,
|
|
222
|
+
import { auditUrl, auditSite, auditAeoUrl, renderMarkdown, renderAeoMarkdown } from '@rivi-software/agentic-seo-check';
|
|
171
223
|
|
|
172
224
|
const page = await auditUrl('https://www.example.com/', { keyword: 'example', render: true });
|
|
173
225
|
const site = await auditSite('https://www.example.com/', { maxPages: 100 });
|
|
174
226
|
console.log(renderMarkdown(site));
|
|
227
|
+
|
|
228
|
+
const aeo = await auditAeoUrl('https://www.example.com/guide', { aiBots: true });
|
|
229
|
+
console.log(renderAeoMarkdown(aeo));
|
|
175
230
|
```
|
|
176
231
|
|
|
177
232
|
## Scope of this first version
|
|
178
233
|
|
|
179
234
|
- Crawls are breadth-first, same-site, HTML only, and obey robots.txt by default. `--render`/`--lighthouse` apply to the start page only during a crawl.
|
|
180
235
|
- Scores are indicative. Thresholds (title 30-60 chars, description 70-160, thin content 300 words, slow response 2 s, deep page depth 3) are configurable through the library `thresholds` option.
|
|
181
|
-
-
|
|
236
|
+
- The AEO audit reads what answer engines document: robots.txt tokens, Content-Signal, snippet controls, structured data. Whether an engine cites a page also depends on things no audit can see from outside (its index, its ranking, the question asked), so the AEO score says how ready a site is, not how often it is cited. llms.txt is reported at info level: no major answer engine has said it reads one.
|
|
237
|
+
- Not included yet: gzip sitemaps, rendering every page in a crawl, field (CrUX) data, rank tracking, backlink data, AI-generated copy suggestions, tracking of citations in AI answers.
|
|
182
238
|
|
|
183
239
|
## Contributing
|
|
184
240
|
|
package/dist/cli.js
CHANGED
|
@@ -2,8 +2,9 @@
|
|
|
2
2
|
import { promises as fs } from "node:fs";
|
|
3
3
|
import { Command, InvalidArgumentError, Option } from "commander";
|
|
4
4
|
import { MAKER, MAKER_URL, REPOSITORY_URL } from "./brand.js";
|
|
5
|
+
import { auditAeoTarget, compactAeoAudit } from "./core/aeo/audit.js";
|
|
5
6
|
import { auditTarget, compactAudit } from "./core/audit.js";
|
|
6
|
-
import { renderMarkdown } from "./core/report/markdown.js";
|
|
7
|
+
import { renderAeoMarkdown, renderMarkdown } from "./core/report/markdown.js";
|
|
7
8
|
import { ALL_RULES } from "./core/rules/index.js";
|
|
8
9
|
import { SEVERITY_RANK } from "./core/types.js";
|
|
9
10
|
import { startMcpServer } from "./mcp.js";
|
|
@@ -11,7 +12,7 @@ import { VERSION } from "./version.js";
|
|
|
11
12
|
const program = new Command();
|
|
12
13
|
program
|
|
13
14
|
.name("agentic-seo-check")
|
|
14
|
-
.description("SEO analysis for coding agents. Audits URLs, static build output or raw HTML and prints machine-readable findings.")
|
|
15
|
+
.description("SEO and AEO analysis for coding agents. Audits URLs, static build output or raw HTML for search engines (audit, crawl) and AI answer engines (aeo), and prints machine-readable findings.")
|
|
15
16
|
.version(VERSION)
|
|
16
17
|
.addHelpText("afterAll", `\nMade by ${MAKER} (${MAKER_URL}). Docs and issues: ${REPOSITORY_URL}`)
|
|
17
18
|
.showHelpAfterError();
|
|
@@ -23,25 +24,35 @@ const intArg = (value) => {
|
|
|
23
24
|
}
|
|
24
25
|
return n;
|
|
25
26
|
};
|
|
26
|
-
const addAuditOptions = (cmd,
|
|
27
|
-
if (
|
|
27
|
+
const addAuditOptions = (cmd, mode) => {
|
|
28
|
+
if (mode !== "crawl") {
|
|
28
29
|
cmd.option("--crawl", "Crawl the whole site starting at the URL instead of auditing one page");
|
|
29
30
|
}
|
|
30
|
-
|
|
31
|
+
cmd
|
|
31
32
|
.option("--max-pages <n>", "Maximum pages to crawl", intArg, 50)
|
|
32
33
|
.option("--max-depth <n>", "Maximum link depth from the start URL", intArg, 3)
|
|
33
34
|
.option("--concurrency <n>", "Parallel requests while crawling", intArg, 5)
|
|
34
|
-
.option("--delay <ms>", "Delay between requests per worker", intArg, 0)
|
|
35
|
-
|
|
36
|
-
.option("--
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
35
|
+
.option("--delay <ms>", "Delay between requests per worker", intArg, 0);
|
|
36
|
+
if (mode === "aeo") {
|
|
37
|
+
cmd.option("--ai-bots", "Also request the page with each AI bot's User-Agent to catch CDN or firewall blocks");
|
|
38
|
+
}
|
|
39
|
+
else {
|
|
40
|
+
cmd
|
|
41
|
+
.option("-k, --keyword <keyword>", "Target keyword for keyword.* checks")
|
|
42
|
+
.option("--render", "Render with headless Chromium (Playwright) and compare with the server HTML")
|
|
43
|
+
.option("--lighthouse", "Run Lighthouse for Core Web Vitals and Lighthouse SEO audits (slow)")
|
|
44
|
+
.addOption(new Option("--form-factor <type>", "Lighthouse device emulation")
|
|
45
|
+
.choices(["mobile", "desktop"])
|
|
46
|
+
.default("mobile"));
|
|
47
|
+
}
|
|
48
|
+
cmd
|
|
41
49
|
.option("--base-url <url>", "Origin used for directories, files and stdin HTML (default http://localhost/)")
|
|
42
50
|
.option("--ignore-robots", "Do not obey robots.txt while crawling")
|
|
43
|
-
.option("--include-subdomains", "Treat subdomains as internal when crawling")
|
|
44
|
-
|
|
51
|
+
.option("--include-subdomains", "Treat subdomains as internal when crawling");
|
|
52
|
+
if (mode !== "aeo") {
|
|
53
|
+
cmd.option("--check-external", "Probe external links for 4xx/5xx while crawling");
|
|
54
|
+
}
|
|
55
|
+
return cmd
|
|
45
56
|
.option("--include <regex...>", "Only crawl URLs matching these patterns")
|
|
46
57
|
.option("--exclude <regex...>", "Skip URLs matching these patterns")
|
|
47
58
|
.addOption(new Option("-f, --format <format>", "Output format (default: json when piped, md on a terminal)").choices(["json", "md"]))
|
|
@@ -70,25 +81,33 @@ const formatOf = (opts) => {
|
|
|
70
81
|
}
|
|
71
82
|
return process.stdout.isTTY ? "md" : "json";
|
|
72
83
|
};
|
|
73
|
-
|
|
84
|
+
/** `-H "Name: value"` flags as request headers. */
|
|
85
|
+
const parseHeaders = (values = []) => {
|
|
74
86
|
const headers = {};
|
|
75
|
-
for (const h of
|
|
87
|
+
for (const h of values) {
|
|
76
88
|
const idx = h.indexOf(":");
|
|
77
89
|
if (idx === -1) {
|
|
78
90
|
throw new InvalidArgumentError(`Header "${h}" must be "Name: value".`);
|
|
79
91
|
}
|
|
80
92
|
headers[h.slice(0, idx).trim()] = h.slice(idx + 1).trim();
|
|
81
93
|
}
|
|
94
|
+
return headers;
|
|
95
|
+
};
|
|
96
|
+
const progressPrinter = (opts) => {
|
|
82
97
|
const showProgress = !opts.quiet && process.stderr.isTTY;
|
|
83
|
-
|
|
98
|
+
return (e) => {
|
|
84
99
|
if (!showProgress) {
|
|
85
100
|
return;
|
|
86
101
|
}
|
|
87
102
|
const counter = e.crawled === undefined ? "" : ` [${e.crawled}/${e.discovered}]`;
|
|
88
103
|
process.stderr.write(`\u001B[2m${e.phase}${counter}: ${e.message}\u001B[0m\n`);
|
|
89
104
|
};
|
|
105
|
+
};
|
|
106
|
+
/** Runs the audit the command asks for, and renders it in the format asked for. */
|
|
107
|
+
const auditFor = async (target, opts, mode) => {
|
|
108
|
+
const headers = parseHeaders(opts.header);
|
|
90
109
|
const options = {
|
|
91
|
-
crawl:
|
|
110
|
+
crawl: mode === "crawl" || Boolean(opts.crawl),
|
|
92
111
|
maxPages: opts.maxPages,
|
|
93
112
|
maxDepth: opts.maxDepth,
|
|
94
113
|
concurrency: opts.concurrency,
|
|
@@ -111,14 +130,33 @@ const runAudit = async (target, opts, forceCrawl) => {
|
|
|
111
130
|
userAgent: opts.userAgent,
|
|
112
131
|
headers: Object.keys(headers).length ? headers : undefined,
|
|
113
132
|
},
|
|
114
|
-
onProgress,
|
|
133
|
+
onProgress: progressPrinter(opts),
|
|
115
134
|
};
|
|
135
|
+
const format = formatOf(opts);
|
|
136
|
+
if (mode === "aeo") {
|
|
137
|
+
let aeo = await auditAeoTarget(target, {
|
|
138
|
+
...options,
|
|
139
|
+
aiBots: opts.aiBots,
|
|
140
|
+
});
|
|
141
|
+
if (opts.compact) {
|
|
142
|
+
aeo = compactAeoAudit(aeo);
|
|
143
|
+
}
|
|
144
|
+
return {
|
|
145
|
+
counts: aeo.counts,
|
|
146
|
+
output: format === "md" ? renderAeoMarkdown(aeo) : JSON.stringify(aeo, null, 2),
|
|
147
|
+
};
|
|
148
|
+
}
|
|
116
149
|
let audit = await auditTarget(target, options);
|
|
117
150
|
if (opts.compact) {
|
|
118
151
|
audit = compactAudit(audit);
|
|
119
152
|
}
|
|
120
|
-
|
|
121
|
-
|
|
153
|
+
return {
|
|
154
|
+
counts: audit.counts,
|
|
155
|
+
output: format === "md" ? renderMarkdown(audit) : JSON.stringify(audit, null, 2),
|
|
156
|
+
};
|
|
157
|
+
};
|
|
158
|
+
const runAudit = async (target, opts, mode) => {
|
|
159
|
+
const { counts, output } = await auditFor(target, opts, mode);
|
|
122
160
|
if (opts.out) {
|
|
123
161
|
await fs.writeFile(opts.out, `${output}\n`, "utf-8");
|
|
124
162
|
if (!opts.quiet) {
|
|
@@ -130,7 +168,6 @@ const runAudit = async (target, opts, forceCrawl) => {
|
|
|
130
168
|
}
|
|
131
169
|
if (opts.failOn !== "none") {
|
|
132
170
|
const threshold = SEVERITY_RANK[opts.failOn];
|
|
133
|
-
const { counts } = audit;
|
|
134
171
|
const hits = ["error", "warning", "info"]
|
|
135
172
|
.filter((s) => SEVERITY_RANK[s] >= threshold)
|
|
136
173
|
.reduce((n, s) => n + counts[s], 0);
|
|
@@ -145,14 +182,20 @@ const runAudit = async (target, opts, forceCrawl) => {
|
|
|
145
182
|
addAuditOptions(program
|
|
146
183
|
.command("audit")
|
|
147
184
|
.argument("<target>", 'URL, directory of HTML files, .html file, or "-" for HTML on stdin')
|
|
148
|
-
.description("Audit a page, a site (--crawl), a build directory or raw HTML"),
|
|
149
|
-
await runAudit(target, opts,
|
|
185
|
+
.description("Audit a page, a site (--crawl), a build directory or raw HTML"), "audit").action(async (target, opts) => {
|
|
186
|
+
await runAudit(target, opts, "audit");
|
|
150
187
|
});
|
|
151
188
|
addAuditOptions(program
|
|
152
189
|
.command("crawl")
|
|
153
190
|
.argument("<url>", "Start URL")
|
|
154
|
-
.description('Crawl a site and audit every page (same as "audit --crawl")'),
|
|
155
|
-
await runAudit(url, opts,
|
|
191
|
+
.description('Crawl a site and audit every page (same as "audit --crawl")'), "crawl").action(async (url, opts) => {
|
|
192
|
+
await runAudit(url, opts, "crawl");
|
|
193
|
+
});
|
|
194
|
+
addAuditOptions(program
|
|
195
|
+
.command("aeo")
|
|
196
|
+
.argument("<target>", 'URL, directory of HTML files, .html file, or "-" for HTML on stdin')
|
|
197
|
+
.description("Answer engine optimization audit: AI crawler access (robots.txt, llms.txt), snippet and AI opt-outs, answer-ready content, entities and freshness, with its own score"), "aeo").action(async (target, opts) => {
|
|
198
|
+
await runAudit(target, opts, "aeo");
|
|
156
199
|
});
|
|
157
200
|
program
|
|
158
201
|
.command("rules")
|
package/dist/cli.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,SAAS,CAAC;AAEzC,OAAO,EAAE,OAAO,EAAE,oBAAoB,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAElE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC9D,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;
|
|
1
|
+
{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,44 @@
|
|
|
1
|
+
import type { ProgressEvent } from "../audit.js";
|
|
2
|
+
import type { FetchOptions } from "../fetch.js";
|
|
3
|
+
import type { AeoAudit } from "../types.js";
|
|
4
|
+
export interface AeoOptions {
|
|
5
|
+
/** Crawl the site from a URL target instead of auditing one page. */
|
|
6
|
+
crawl?: boolean;
|
|
7
|
+
maxPages?: number;
|
|
8
|
+
maxDepth?: number;
|
|
9
|
+
concurrency?: number;
|
|
10
|
+
delayMs?: number;
|
|
11
|
+
respectRobots?: boolean;
|
|
12
|
+
includeSubdomains?: boolean;
|
|
13
|
+
includePatterns?: string[];
|
|
14
|
+
excludePatterns?: string[];
|
|
15
|
+
/** Base URL for inline HTML, files and directories (default http://localhost/). */
|
|
16
|
+
baseUrl?: string;
|
|
17
|
+
/** Also request the page with each AI bot's User-Agent, to catch CDN or firewall blocks. */
|
|
18
|
+
aiBots?: boolean;
|
|
19
|
+
/** Include info-level findings (default true). */
|
|
20
|
+
includeInfo?: boolean;
|
|
21
|
+
/** Rule ids to skip. */
|
|
22
|
+
disableRules?: string[];
|
|
23
|
+
/** Site audits: "summary" keeps page findings out of `findings`; they stay rolled up in `issues`. */
|
|
24
|
+
pageDetail?: "full" | "summary";
|
|
25
|
+
fetch?: FetchOptions;
|
|
26
|
+
onProgress?: (event: ProgressEvent) => void;
|
|
27
|
+
}
|
|
28
|
+
/** AEO audit of an HTML string. `url` is where the HTML would be served, for links and display. */
|
|
29
|
+
export declare const auditAeoHtml: (html: string, input?: {
|
|
30
|
+
url?: string;
|
|
31
|
+
target?: string;
|
|
32
|
+
}, options?: AeoOptions) => Promise<AeoAudit>;
|
|
33
|
+
/** AEO audit of one live page, with its site's robots.txt and llms.txt. */
|
|
34
|
+
export declare const auditAeoUrl: (url: string, options?: AeoOptions) => Promise<AeoAudit>;
|
|
35
|
+
/** AEO audit of a site, crawled from `startUrl`. */
|
|
36
|
+
export declare const auditAeoSite: (startUrl: string, options?: AeoOptions) => Promise<AeoAudit>;
|
|
37
|
+
/** AEO audit of a directory of built HTML, with the robots.txt and llms.txt in it. */
|
|
38
|
+
export declare const auditAeoDirectory: (dir: string, options?: AeoOptions) => Promise<AeoAudit>;
|
|
39
|
+
/** AEO audit of a URL (a crawl with `crawl`), a directory, an .html file, or "-" for stdin. */
|
|
40
|
+
export declare const auditAeoTarget: (target: string, options?: AeoOptions & {
|
|
41
|
+
stdinHtml?: string;
|
|
42
|
+
}) => Promise<AeoAudit>;
|
|
43
|
+
/** Drops bulky detail to save tokens when an LLM reads the result. */
|
|
44
|
+
export declare const compactAeoAudit: (audit: AeoAudit) => AeoAudit;
|