page.analyze
Read-onlyIdempotent
Analyze web pages by detecting layout structure, extracting motion patterns, and evaluating quality in parallel for unified results.
Instructions
Analyze a web page URL with layout detection, motion pattern extraction, and quality evaluation. Executes layout.ingest, motion.detect, and quality.evaluate in parallel and returns unified results. Supports MCP streaming progress via _meta.progressToken for real-time phase notifications.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | Yes | Target URL to analyze (required) | |
| async | No | Async mode (default: auto). true: enqueue a BullMQ job and return a jobId immediately (poll with page.getJobStatus). false: synchronous processing. When omitted, auto-enabled if Vision is on and Redis is available (Vision LLM exceeds the MCP timeout in CPU mode). Requires Redis when true. | |
| summary | No | Return summary response (default: true). Set to false for full details. | |
| timeout | No | Overall timeout in ms (default: 600000) | |
| features | No | Feature flags for analysis (default: all true) | |
| waitUntil | No | Page load completion criteria (default: networkidle) | networkidle |
| auto_retry | No | Enable staged auto-retry on HTML fetch failure (default: true). Retries with progressively longer timeouts and relaxed waitUntil. | |
| sourceType | No | Source type: award_gallery or user_provided (default) | user_provided |
| usageScope | No | Usage scope: inspiration_only (default) or owned_asset | inspiration_only |
| max_retries | No | Maximum retry attempts when auto_retry is true (default: 3). | |
| auto_timeout | No | Enable Pre-flight Probe for dynamic timeout calculation (v0.1.0). Analyzes page complexity (WebGL, SPA, heavy frameworks) before analysis and calculates optimal timeout. Results are included in preflightProbe response field. | |
| layout_first | No | Layout-first mode for WebGL/Three.js sites (default: auto). auto: prioritise layout when WebGL is detected. always: always prioritise layout. never: legacy parallel processing. | auto |
| auto_snapshot | No | Auto-save design snapshot after analysis (default: false). Creates a point-in-time record for design.track_changes comparison. | |
| layoutOptions | No | Layout analysis options | |
| layoutTimeout | No | Per-phase timeout for layout analysis in ms (default: 120000). | |
| motionOptions | No | Motion detection options | |
| motionTimeout | No | Per-phase timeout for motion detection in ms (default: 300000). | |
| visionOptions | No | Vision CPU completion-guarantee options (Phase 3). Controls Vision model (Ollama llama3.2-vision) inference timeout, image optimisation, CPU forcing, and graceful degradation. | |
| qualityOptions | No | Quality evaluation options | |
| qualityTimeout | No | Per-phase timeout for quality evaluation in ms (default: 60000). | |
| partial_results | No | Allow partial results on timeout (default: true). When true, returns results from completed phases on timeout. | |
| narrativeOptions | No | Narrative analysis options. Analyzes the page's worldview/atmosphere and layout structure. enabled=true to activate. | |
| timeout_strategy | No | Timeout strategy. strict: fail completely on timeout. progressive: return partial results on timeout (default). | progressive |
| responsiveOptions | No | Responsive layout analysis options. Captures layouts at multiple viewport sizes (desktop/tablet/mobile) and detects differences in typography, spacing, navigation, and layout structure. | |
| performanceOptions | No | Performance evaluation options (v0.3.0 Phase 7.5b, opt-in). Core Web Vitals (LCP/FID/CLS/INP/TTFB) measurement. Timeout: 40s. Disabled by default. | |
| respect_robots_txt | No | Respect robots.txt (RFC 9309). Set to false to ignore. | |
| accessibilityOptions | No | Accessibility audit options (v0.3.0 Phase 7.5a, opt-in). WCAG 2.1 AA compliance audit via axe-core. Timeout: 10s. Disabled by default. |