{"_id":"@zero-strategie/zero-audit-core","_rev":"4-f1b74976693bc31ee4f6dd04d156ff31","name":"@zero-strategie/zero-audit-core","dist-tags":{"latest":"1.1.0"},"versions":{"0.0.0-stage":{"name":"@zero-strategie/zero-audit-core","version":"0.0.0-stage","_id":"@zero-strategie/zero-audit-core@0.0.0-stage","stub":true,"maintainers":[{"name":"zero-strategie-org","email":"lobamo@proton.me"}],"dist":{"shasum":"e904a7fc834160edf2240018f5cf028cf4fb6a4d","tarball":"https://registry.npmjs.org/@zero-strategie/zero-audit-core/-/zero-audit-core-0.0.0-stage.tgz","fileCount":2,"integrity":"sha512-f9Ew8IWDN3wCmJEDH2PyWZ2vu6Y426fd9JYkoj2Q6Wt+VkLI1OPl0HeaOiRMJP868kqFipU6zlhUt7ifEv5SSw==","signatures":[{"sig":"MEUCIQDd8zqCZcYom44JxYBDkwEUSJCffIOoYy1oD9YXoggzXwIgSZLr5soiWIg5uj4oBswEmJ8HtWYq87r5aGHA8T51FmU=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":353},"_npmUser":{"name":"zero-strategie-org","email":"lobamo@proton.me"},"description":"Temporary package placeholder for staged publishing","directories":{}},"1.0.0":{"name":"@zero-strategie/zero-audit-core","version":"1.0.0","license":"AGPL-3.0-only","_id":"@zero-strategie/zero-audit-core@1.0.0","maintainers":[{"name":"zero-strategie-org","email":"lobamo@proton.me"}],"homepage":"https://github.com/zero-strategie/zero-audit#readme","bugs":{"url":"https://github.com/zero-strategie/zero-audit/issues"},"bin":{"zero-audit":"dist/cli/main.js"},"dist":{"shasum":"b9c1e9956bf338c834f095f6f00fd53d809aa50e","tarball":"https://registry.npmjs.org/@zero-strategie/zero-audit-core/-/zero-audit-core-1.0.0.tgz","fileCount":261,"integrity":"sha512-2JH1urwNu7QG2q19DyZD9ruQnpJ2Yju0InKzv4py3FXUkHRLLMr0cwIN3Gpz2pq9bottt1i8EeWuVUmxC0qzlw==","signatures":[{"sig":"MEUCIQDBbXuGFxJ2cDRTcRZzAwg65Olx9S1SsRY7rHOnxSppLwIgIo8uX5dnVUzkJPtYynsQOyg07dTS40jiMZ8KjS/XrTQ=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEUCIQDW2blp1ghQoz+Rn+Z0wMfab4djzxlIoZpaJxK1VRCh3AIgfvn02ucr0CbRMpYw7lJATT/1/aar5L9/J6sheZWeyAY=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@zero-strategie%2fzero-audit-core@1.0.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":326581},"main":"dist/index.js","pnpm":{"onlyBuiltDependencies":["better-sqlite3","esbuild"]},"type":"module","types":"dist/index.d.ts","engines":{"node":">=22"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"gitHead":"1188801d8f20d6c50eba4ecbe7a7e7df7521b10e","scripts":{"lint":"eslint .","test":"vitest run","audit":"tsx src/cli/main.ts","build":"tsc -p tsconfig.build.json && cp -R src/infrastructure/sqlite/migrations dist/infrastructure/sqlite/ && cp -R src/infrastructure/postgres/migrations dist/infrastructure/postgres/","format":"prettier --write .","typecheck":"tsc --noEmit","pack:check":"tsx scripts/check-pack.ts","pack:smoke":"tsx scripts/smoke-pack.ts","zero-audit":"tsx src/cli/main.ts","prepublishOnly":"pnpm build"},"_npmUser":{"name":"zero-strategie-org","email":"lobamo@proton.me"},"repository":{"url":"git+https://github.com/zero-strategie/zero-audit.git","type":"git"},"_npmVersion":"10.9.9","description":"Technical SEO audit engine: crawler, checks, scoring, storage and worker, with a CLI.","directories":{},"_nodeVersion":"22.23.3","dependencies":{"pg":"^8.23.1","undici":"^8.12.2","cheerio":"^1.2.0","@types/pg":"^8.23.1","robots-parser":"^3.0.1","better-sqlite3":"^13.0.3","fast-xml-parser":"^5.11.2","fast-xml-validator":"^1.4.2","@types/better-sqlite3":"^9.6.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"packageManager":"pnpm@10.24.0","devDependencies":{"tsx":"^4.23.15","eslint":"^10.13.0","vitest":"^5.0.5","prettier":"^3.9.10","@eslint/js":"^10.0.1","typescript":"^6.0.3","@types/node":"^26.6.5","typescript-eslint":"^8.71.2"},"_npmOperationalInternal":{"tmp":"tmp/zero-audit-core_1.0.0_1792669145265_0.7785544190982079","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"@zero-strategie/zero-audit-core","version":"1.0.1","license":"AGPL-3.0-only","_id":"@zero-strategie/zero-audit-core@1.0.1","maintainers":[{"name":"zero-strategie-org","email":"lobamo@proton.me"}],"homepage":"https://github.com/zero-strategie/zero-audit#readme","bugs":{"url":"https://github.com/zero-strategie/zero-audit/issues"},"bin":{"zero-audit":"dist/cli/main.js"},"dist":{"shasum":"5a652e0d007f95786191fe5fc986dffff09ba5f6","tarball":"https://registry.npmjs.org/@zero-strategie/zero-audit-core/-/zero-audit-core-1.0.1.tgz","fileCount":261,"integrity":"sha512-UWtPZdKpla9h9S8LEQGAPlbHpuZnq2x56Kr0s1lY6m624diZSNPYVyAxOGh+W4WQjUy6WW3IemTO3dUhReIgCw==","signatures":[{"sig":"MEYCIQDsmEdQaIDSnekNFtv4HNJz1QrJ50AX4gmcwrtZR406WwIhANdDMB92jsHldkejwKHEkjeGNClvsqflk2aaDbv6PdrH","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"sig":"MEUCIQCHHMH2L6AkaUyIqgJUB1Xd5JRJhcwvBXbOLpSl5eayagIgIh2O56VqgAr9N06fOxXq/WvTKNbQp1mImynZZLOvDpM=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@zero-strategie%2fzero-audit-core@1.0.1","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":326478},"main":"dist/index.js","pnpm":{"onlyBuiltDependencies":["better-sqlite3","esbuild"]},"type":"module","types":"dist/index.d.ts","engines":{"node":">=22"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"gitHead":"527e1c0a13884bfa1de4dabac208f5d19e0f8947","scripts":{"lint":"eslint .","test":"vitest run","audit":"tsx src/cli/main.ts","build":"tsc -p tsconfig.build.json && cp -R src/infrastructure/sqlite/migrations dist/infrastructure/sqlite/ && cp -R src/infrastructure/postgres/migrations dist/infrastructure/postgres/","format":"prettier --write .","typecheck":"tsc --noEmit","pack:check":"tsx scripts/check-pack.ts","pack:smoke":"tsx scripts/smoke-pack.ts","zero-audit":"tsx src/cli/main.ts","prepublishOnly":"pnpm build"},"_npmUser":{"name":"zero-strategie-org","email":"lobamo@proton.me"},"repository":{"url":"git+https://github.com/zero-strategie/zero-audit.git","type":"git"},"_npmVersion":"10.9.9","description":"Technical SEO audit engine: crawler, checks, scoring, storage and worker, with a CLI.","directories":{},"_nodeVersion":"22.23.3","dependencies":{"pg":"^8.23.1","undici":"^8.12.2","cheerio":"^1.2.0","@types/pg":"^8.23.1","robots-parser":"^3.0.1","better-sqlite3":"^13.0.3","fast-xml-parser":"^5.11.2","fast-xml-validator":"^1.4.2","@types/better-sqlite3":"^9.6.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"packageManager":"pnpm@10.24.0","devDependencies":{"tsx":"^4.23.15","eslint":"^10.13.0","vitest":"^5.0.5","prettier":"^3.9.10","@eslint/js":"^10.0.1","typescript":"^6.0.3","@types/node":"^26.6.5","typescript-eslint":"^8.71.2"},"_npmOperationalInternal":{"tmp":"tmp/zero-audit-core_1.0.1_1792672834919_0.6425904313968418","host":"s3://npm-registry-packages-npm-production"}},"1.1.0":{"_id":"@zero-strategie/zero-audit-core@1.1.0","bin":{"zero-audit":"dist/cli/main.js"},"bugs":{"url":"https://github.com/zero-strategie/zero-audit/issues"},"dist":{"shasum":"46ea20e421df1ff54b42a531613c198086895296","tarball":"https://registry.npmjs.org/@zero-strategie/zero-audit-core/-/zero-audit-core-1.1.0.tgz","fileCount":327,"integrity":"sha512-fGI/+5wn7MQVZYXb2Ji4b05sPVrNRqpCPhLuNP3UMqf/a4X13jXlCK4MBo5Xk3CQxU7WSmpZ+AfZTfd0QNLR9A==","signatures":[{"sig":"MEUCIBAHtMzy3NwW9aQSZiHimfD2ZLxg95XDienTemGmGb9RAiEAseJ0SJeG2OgbfQ5yNBmArFasnkacAYMJo2qtwfDFb/E=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCID8uL5iGT8XbtWoSD8XkgyBlHgJdDXBY2JAziamH7R5HAiARIsJQgHr0K8fYdo9SZX40mClOIP9CJg1PICrICC/W9A=="}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@zero-strategie%2fzero-audit-core@1.1.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":360569},"main":"dist/index.js","name":"@zero-strategie/zero-audit-core","pnpm":{"onlyBuiltDependencies":["better-sqlite3","esbuild"]},"type":"module","types":"dist/index.d.ts","engines":{"node":">=22"},"exports":{".":{"types":"./dist/index.d.ts","import":"./dist/index.js"}},"gitHead":"1c8e4df462dac1a5c5e167eda1088364e36eff3b","license":"AGPL-3.0-only","scripts":{"lint":"eslint .","test":"vitest run","audit":"tsx src/cli/main.ts","build":"tsc -p tsconfig.build.json && cp -R src/infrastructure/sqlite/migrations dist/infrastructure/sqlite/ && cp -R src/infrastructure/postgres/migrations dist/infrastructure/postgres/","format":"prettier --write .","typecheck":"tsc --noEmit","pack:check":"tsx scripts/check-pack.ts","pack:smoke":"tsx scripts/smoke-pack.ts","zero-audit":"tsx src/cli/main.ts","prepublishOnly":"pnpm build"},"version":"1.1.0","_npmUser":{"name":"zero-strategie-org","email":"lobamo@proton.me"},"homepage":"https://github.com/zero-strategie/zero-audit#readme","repository":{"url":"git+https://github.com/zero-strategie/zero-audit.git","type":"git"},"_npmVersion":"10.9.9","description":"Technical SEO audit engine: crawler, checks, scoring, storage and worker, with a CLI.","directories":{},"maintainers":[{"name":"zero-strategie-org","email":"lobamo@proton.me"}],"_nodeVersion":"22.23.3","dependencies":{"pg":"^8.23.1","undici":"^8.12.2","cheerio":"^1.2.0","@types/pg":"^8.23.1","robots-parser":"^3.0.1","better-sqlite3":"^13.0.3","fast-xml-parser":"^5.11.2","fast-xml-validator":"^1.4.2","@types/better-sqlite3":"^9.6.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"packageManager":"pnpm@10.24.0","devDependencies":{"tsx":"^4.23.15","eslint":"^10.13.0","vitest":"^5.0.5","prettier":"^3.9.10","@eslint/js":"^10.0.1","typescript":"^6.0.3","@types/node":"^26.6.5","typescript-eslint":"^8.71.2"},"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/zero-audit-core_1.1.0_1792700630326_0.3830507397998817"}}},"time":{"created":"2026-10-22T11:36:20.482Z","modified":"2026-10-22T20:23:50.769Z","0.0.0-stage":"2026-10-22T11:36:20.482Z","1.0.0":"2026-10-22T11:39:05.374Z","1.0.1":"2026-10-22T12:40:35.006Z","1.1.0":"2026-10-22T20:23:50.417Z"},"bugs":{"url":"https://github.com/zero-strategie/zero-audit/issues"},"license":"AGPL-3.0-only","homepage":"https://github.com/zero-strategie/zero-audit#readme","repository":{"url":"git+https://github.com/zero-strategie/zero-audit.git","type":"git"},"description":"Technical SEO audit engine: crawler, checks, scoring, storage and worker, with a CLI.","maintainers":[{"name":"zero-strategie-org","email":"lobamo@proton.me"}],"readme":"# zero-audit\n\n`@zero-strategie/zero-audit-core` is the open-source engine of zero-audit, a technical SEO audit tool. It crawls a website, runs [44 checks](docs/checks.md), scores the site's health and keeps every audit as an immutable snapshot so that you can see what changed between two audits.\n\nIt ships as a library and as a command-line tool. A hosted product built on this engine is available at [https://audit.zero-strategie.dev](https://audit.zero-strategie.dev).\n\n- **Crawler**: honours robots.txt and sitemaps, runs breadth-first with a politeness delay, follows redirects and probes URL variants.\n- **Checks**: 44 checks in five themes (see below), each with a severity (error, warning or notice) and the list of affected pages.\n- **Scores**: site health and per-theme scores (crawlability, https, linking, on-page, other), with the variation since the previous audit.\n- **History**: new and fixed issues between two audits, and a `compare` command.\n- **Storage**: SQLite out of the box, or Postgres.\n- **Queue and worker**: audits can be queued and processed by one or several worker processes.\n\nOnly audit sites you own or are allowed to crawl.\n\n## What it checks\n\n| Theme | Checks | Examples |\n|---|---:|---|\n| Crawlability | 19 | 4xx and 5xx pages, unreachable pages and timeouts, redirect chains and loops, temporary redirects, pages blocked by robots.txt or `X-Robots-Tag: noindex`, pages more than 3 clicks deep, duplicate content, canonicals pointing to broken pages, long or parameter-heavy URLs, missing robots.txt or sitemap, duplicate URL variants |\n| On-page | 11 | missing, duplicate, too short or too long titles, missing or duplicate meta descriptions, missing or multiple `<h1>`, thin content, low text-to-HTML ratio |\n| Linking | 8 | broken internal links, pages with a single incoming link, too many links on a page, nofollow links, empty or generic anchor text (\"click here\"), files linked as pages |\n| HTTPS | 3 | pages served over http, http links on an https site, missing HSTS |\n| Other | 3 | slow responses, uncompressed pages, missing `llms.txt` |\n\nThe [checks reference](docs/checks.md) lists every check with its threshold and how to fix it. Since 1.1.0 an audit runs 44 checks instead of 20: comparing an audit made with 1.0 to one made with 1.1 shows the new checks' findings as new issues, even if the site did not change.\n\n## Installation\n\nRequires Node.js 22 or later.\n\n```sh\nnpm install @zero-strategie/zero-audit-core\n```\n\n## Command line\n\nWithout installing anything:\n\n```sh\nnpx @zero-strategie/zero-audit-core https://example.com --direct --json report.json\n```\n\nOnce the package is installed, it provides a `zero-audit` binary:\n\n```sh\nnpx zero-audit https://example.com --direct --json report.json\n```\n\n`--direct` crawls inside the current process and writes the full snapshot to `report.json`. Without it, `zero-audit https://example.com` puts the audit in a queue and prints its identifier; a worker started with `zero-audit worker` then processes it, and `--wait` waits for the result.\n\n```sh\nzero-audit https://example.com --wait          # queue, then wait for a worker\nzero-audit worker                              # process queued audits\nzero-audit compare <A> <B>                     # compare two completed snapshots\nzero-audit migrate --store postgres            # apply storage migrations (needs DATABASE_URL)\n```\n\nRun `zero-audit --help` for every option. The messages of the CLI (help, progress and errors) are in French.\n\n## Library\n\n```ts\nimport { createStorage, createRunAudit, migrateStorage } from '@zero-strategie/zero-audit-core';\n\nconst config = { store: 'sqlite', dbPath: './.zero-audit/audit.db', databaseUrl: null } as const;\n\nawait migrateStorage(config);\nconst storage = await createStorage(config);\n\nconst runAudit = createRunAudit({\n  storage,\n  events: { started: () => undefined, finished: () => undefined, failed: () => undefined },\n});\n\nconst { snapshot } = await runAudit.execute({\n  rootUrl: 'https://example.com',\n  limit: 100,\n  delayMs: 1000,\n});\nconsole.log(snapshot.id, snapshot.pagesCrawled);\n\nawait storage.close();\n```\n\n`createRunAudit` refuses private network addresses by default (SSRF guard). The package also exports the use cases, ports, checks and scoring functions; the exported names are listed in `src/index.ts`.\n\n## Documentation\n\n- [User guide](docs/user-guide.md): install, run audits, read scores, storage.\n- [Checks reference](docs/checks.md): what each check flags and how to fix it.\n- [Developer guide](docs/developer-guide.md): architecture, adding a check, storage, tests, CI.\n- [Contributing](CONTRIBUTING.md)\n\n## About\n\nzero-audit is built by [Zero Stratégie](https://zero-strategie.dev). Its feature set is inspired by commercial site-audit tools such as Semrush's Site Audit, and the numeric identifiers of its checks follow the numbering used by Semrush's Site Audit, so that results can be compared. It is an independent project, not affiliated with or endorsed by Semrush. Zero Stratégie has no link with Ahrefs or Screaming Frog either. The check wording is original.\n\n## Licence\n\nzero-audit is free software, released under the [GNU Affero General Public License v3.0](LICENSE) (`AGPL-3.0-only`).\n\nYou can use it freely, including inside a company, and you can modify it. If you offer a modified version to users over a network, for example as a hosted service, you must make your modified source code available to them under the same licence.\n\nCopyright © 2026 Zero Stratégie. See [COPYRIGHT](COPYRIGHT).\n\n## Commercial licence\n\nTo embed zero-audit in a proprietary product, or to host a modified version without publishing your changes, a commercial licence is available from [Zero Stratégie](https://zero-strategie.dev). Contributions are accepted under the [CLA](CLA.md), which keeps this dual licensing possible.\n","readmeFilename":"README.md"}