Developers

Site crawl

POST /api/site-audit
{"url":"https://www.example.com","maxPages":25}

Public, same-origin HTML sample. Up to 25 pages, 3 sitemap files and 40 seconds. Includes coverage, findings, link sources and explicit exclusions. Robots permission must be established before crawling. POST only; failures use problem JSON. Search Console and citation imports in the SEO page stay in the browser.

Report API

GET /api/v1/agentic/report?url=lightmark.app

JSON by default. Request text/markdown for Markdown.

CLI

npx --yes --package=https://www.lightmark.app/downloads/lightmark-agentic-0.1.0.tgz lightmark lightmark.app --json

Install the standalone CLI directly. Use --read-only to prevent new scans. npm registry publication is pending.

MCP

Streamable HTTP. Read reports and evidence. Compatible MCP Apps hosts display an interactive scorecard.

Reviewed repository fixes

node scripts/repository-fix.js --help

Run from a Lightmark source checkout. Apply an approved patch in an isolated Git worktree, run explicit checks, verify a public deployment marker and rescan, or create a tested revert. Deployment is a separate operator step.

Errors and limits

400: invalid request. 404: scan first. 429: honor Retry-After. 503: retry later. Report reads: 120 requests per IP per minute, advertised in RateLimit headers. Ora scan quotas are separate.