check

type A11yAdvancedCheck ¶

type A11yAdvancedCheck struct{}

A11yAdvancedCheck implements WCAG 2.1/2.2 rules beyond basics: ARIA validation, focus management, landmark completeness, color contrast hints.

type A11yCheck ¶

type A11yCheck struct{}

A11yCheck detects accessibility violations: missing alt text, ARIA issues, heading hierarchy problems, and missing landmarks.

func (a *A11yCheck) Name() string

func (a *A11yCheck) Run(ctx context.Context, pages []*crawler.Page) []Finding

type AIReadyCheck ¶

type AIReadyCheck struct{}

AIReadyCheck verifies that a site is AI-agent-friendly by checking for emerging standards and best practices that help LLMs and AI agents understand and navigate the site effectively.

Checks performed:

• /llms.txt endpoint (emerging standard for LLM-readable site descriptions)
• <link rel="alternate" type="text/markdown"> for markdown alternatives
• Structured data (JSON-LD, microdata)
• Clean semantic HTML (proper heading hierarchy, landmarks)
• Sitemap.xml accessibility

func (a *AIReadyCheck) Name() string

func (a *AIReadyCheck) Run(ctx context.Context, pages []*crawler.Page) []Finding

type Checker ¶

type Checker interface {
	Name() string
	Run(ctx context.Context, pages []*crawler.Page) []Finding
}

Checker is the interface that all checks implement.

type Finding ¶

type Finding struct {
	Severity Severity
	URL      string
	Element  string
	Message  string
	Fix      string
	Evidence string
}

Finding is an internal finding produced by a check.

func RunAdvancedA11y(ctx context.Context, pages []*crawler.Page) []Finding

type FormsCheck ¶

type FormsCheck struct{}

FormsCheck detects form-related issues: missing actions, CSRF tokens, method problems.

func (f *FormsCheck) Name() string

func (f *FormsCheck) Run(ctx context.Context, pages []*crawler.Page) []Finding

type LinksCheck ¶

type LinksCheck struct {
	// AcceptedStatusCodes is the set of HTTP status codes considered acceptable.
	// If empty, defaults to 200-399.
	AcceptedStatusCodes []int

	// Soft404Detection enables detection of pages that return HTTP 200 for
	// non-existent URLs (soft 404s). When enabled, 200 OK external links are
	// probed to determine if the server is returning real content.
	Soft404Detection bool
	// contains filtered or unexported fields
}

LinksCheck detects broken links, redirect chains, and dead anchors.

func (l *LinksCheck) Name() string

func (l *LinksCheck) Run(ctx context.Context, pages []*crawler.Page) []Finding

type PerfCheck ¶

type PerfCheck struct{}

PerfCheck detects performance issues: large resources, render-blocking scripts, missing compression, excessive DOM size.

func (p *PerfCheck) Name() string

func (p *PerfCheck) Run(ctx context.Context, pages []*crawler.Page) []Finding

type ReachabilityCheck ¶ added in v0.1.1

type ReachabilityCheck struct{}

ReachabilityCheck verifies that embedded resources (images, scripts, stylesheets, fonts, media) referenced in HTML are actually reachable.

func (r *ReachabilityCheck) Name() string

func (r *ReachabilityCheck) Run(ctx context.Context, pages []*crawler.Page) []Finding

type Registry ¶

type Registry struct {
	// contains filtered or unexported fields
}

Registry holds all registered checks.

func DefaultRegistry() *Registry

func (r *Registry) All() []Checker

func (r *Registry) Filter(enabled []string) []Checker

func (r *Registry) Register(c Checker)

type SEOCheck ¶

type SEOCheck struct{}

SEOCheck detects SEO issues: missing meta tags, duplicate titles, missing canonical URLs, and robots directives.

func (s *SEOCheck) Name() string

func (s *SEOCheck) Run(ctx context.Context, pages []*crawler.Page) []Finding

type SRICheck ¶

type SRICheck struct{}

SRICheck validates that cross-origin scripts and stylesheets have Subresource Integrity (SRI) attributes with strong hashes.

func (s *SRICheck) Name() string

func (s *SRICheck) Run(ctx context.Context, pages []*crawler.Page) []Finding

type SecurityCheck ¶

type SecurityCheck struct{}

SecurityCheck detects missing security headers, mixed content, and exposed secrets.

func (s *SecurityCheck) Name() string

func (s *SecurityCheck) Run(ctx context.Context, pages []*crawler.Page) []Finding

type Severity ¶

type Severity = types.Severity

Severity mirrors the public Severity type for internal use.

const (
	SeverityInfo     Severity = types.SeverityInfo
	SeverityLow      Severity = types.SeverityLow
	SeverityMedium   Severity = types.SeverityMedium
	SeverityHigh     Severity = types.SeverityHigh
	SeverityCritical Severity = types.SeverityCritical
)

type Soft404Detector ¶ added in v0.1.1

type Soft404Detector struct {
	// contains filtered or unexported fields
}

Soft404Detector detects servers that return 200 OK for non-existent pages (so-called "soft 404s") by probing random nonexistent URLs on each host and comparing the resulting page fingerprints.

func GetSoft404Detector(check *LinksCheck) *Soft404Detector

func NewSoft404Detector() *Soft404Detector

func (d *Soft404Detector) Detect(ctx context.Context, client *http.Client, page *crawler.Page) (bool, error)

func (d *Soft404Detector) GetSoft404Cache() map[string]*pageFingerprint

func (d *Soft404Detector) SetSoft404Cache(c map[string]*pageFingerprint)