Hosted Audit Reports
Create shareable single-page, full-site, and before/after audit reports with evidence, confidence status, PDF output, MCP, and CLI.
DeepSyte audit reports are hosted at tokenized /r/[token] links. They can be created from the dashboard, workspace share flow, campaigns, MCP tools, or CLI commands.
Reports are built from a shared evidence model before they are scored, rendered, emailed, or shared. The model reconciles SEO, schema, social metadata, performance, waterfall, LCP, network, console, accessibility, responsive checks, screenshots, run links, and page status so the final report does not contradict the captured browser evidence.
Reports also emit a canonical SeoReportModel for owner, developer, MCP, and CLI surfaces. This keeps the SEO score separate from confidence and freshness, adds weighted buckets for content, technical health, performance/UX, intent fit, SERP opportunity, local/schema, and authority/links, and maps every visible action item back to evidence sources.
Full-site reports also store market-data diagnostics. .au domains default to DataForSEO Australia 2036 with English unless an environment override is configured. If ranked keyword data is empty, DeepSyte seeds Keyword Overview and live SERP checks from business name, page titles, H1s, service URLs, and audit facts before it accepts a zero-data market result.
Report types
| Type | Use when | Scope |
|---|---|---|
single_page | You need a fast, browser-backed report for one URL. | Current page SEO, performance, accessibility, responsive, network, console, screenshots, and proof links. |
full_site | You need a stronger client-ready SEO report. | Representative public pages, sitewide findings, page proof, roadmap, technical appendix, and DataForSEO enrichment where enabled. |
| before/after | You have two audit ids for the same site. | Score delta, fixed items, regressions, remaining issues, metric changes, screenshots, and proof links. |
Confidence statuses
Every report has a confidence status:
complete: core SEO evidence, screenshots/proof, findings, and required page evidence are present.usable_with_warning: the report is share-ready, but non-critical warnings or reconciled evidence conflicts should be noted.retry_required: required evidence is missing; campaign delivery and workspace sharing should not send it.blocked: the report summary is missing or unusable.
Non-critical cleanup failures such as browser_close do not make a report partial by themselves. Missing SEO evidence, missing screenshot/proof, or missing full-site representative page evidence does.
Public report page and PDF
The hosted report page includes:
- Cover and scope summary.
- Confidence status and reasons.
- Source map with freshness, confidence, provider status, and action linkage.
- Executive summary.
- Priority findings with business impact, fix, effort, and verification steps.
- Visual proof and evidence links.
- Waterfall diagnostics and LCP proof when captured.
- DataForSEO market, status, endpoint counts, provider costs, zero-data reasons, and provider errors for full-site reports.
- Full-site page list and roadmap where available.
- Technical appendix.
- Browser print/PDF layout.
Open the hosted link and choose the page's PDF action or browser Save PDF option to produce the client-ready PDF.
MCP tools
Use these tools when an agent needs a hosted report link instead of only a local transcript:
| Tool | Purpose |
|---|---|
create_audit_report | Queue a single-page or full-site audit report and return the hosted /r link. |
get_audit_report_status | Check confidence, score, top finding, report URL, PDF action, run URL, and evidence summary. |
get_audit_report_link | Return the hosted report URL for an existing report job. |
create_audit_comparison_report | Create a before/after report link from two workspace audit ids. |
get_audit_comparison_report_link | Return a hosted comparison report link. |
create_audit_report accepts url, report_type, optional keyword, optional recipient, optional branding, and optional share.
Responses include auditId, reportType, confidenceStatus, marketDataStatus, score, topFinding, reportUrl, pdfAction, runUrl, evidenceSummary, sourceSummary, and dataforseoSummary where full-report market data exists. Full-report responses include DataForSEO market source, Google Business Profile match details, seeded keyword counts, backlink summary when enabled, and endpoint status summaries.
CLI commands
deepsyte reports run https://example.com --type single-page --share
deepsyte reports run https://example.com --type full-site --share
deepsyte reports status <auditId>
deepsyte reports link <auditId>
deepsyte reports compare --before <beforeAuditId> --after <afterAuditId> --shareAdd --json to return the same structured fields as MCP.
Sharing rules
Dashboard sharing, campaign delivery, MCP report tools, and CLI report commands should refuse retry_required and blocked reports unless an explicit debug path is used. This keeps cold campaign recipients and customers from receiving evidence-free or contradictory reports.