SEO UOPIX
AI-generatedSummary
Scan a page for SEO issues and optionally crawl more pages on the same domain. Configure request behavior, choose report details and language, and optionally generate an HTML report, save a dashboard snapshot, or send results to a callback API.
Inputs
- url (required) — Absolute URL of the page to scan.
- scanInternalLinks — When enabled, crawl same-domain pages discovered from links and sitemaps, subject to the page limit and crawl rules.
- maxInternalUrls — Maximum number of internal pages to analyze when crawling is enabled; defaults to 20.
- requiredUrls — Newline-separated URLs on the same domain to scan even if not found through links or sitemaps.
- excludedPatterns — Newline-separated URL fragments to exclude from crawling and error reporting.
- ignoredPages — Newline-separated URL fragments for pages to skip during crawling.
- ignoredIssues — Newline-separated error-message fragments; matching issues are omitted.
- timeoutSeconds — Per-page timeout in seconds; defaults to 15.
- customUserAgent — Enable a custom request User-Agent.
- customUserAgentValue — User-Agent string used when custom User-Agent is enabled.
- simulateGooglebot — Use a Googlebot User-Agent for requests.
- followRedirects — Follow HTTP redirects; defaults to true.
- acceptLanguage — Optional Accept-Language request header.
- outputLanguage — Language for generated text and the HTML report (English or Spanish); JSON field names remain unchanged.
- generateHtmlReport — Generate an HTML dashboard report, included as json.html and json.reportHtml.
- persistToDashboard — Save a lightweight scan snapshot to the UOPIX dashboard. The input webhook payload can also enable persistence with persist=true.
- useJsRendering — Use a browser to render JavaScript-driven pages before analysis.
- sendToExternalApi — POST scan results to an external API when the scan completes.
- callbackUrl — Callback endpoint for the results POST.
- reportId — Report identifier included in the callback payload.
- apiToken — Token sent in the callback request's X-API-Token header.
- detailOptions — Choose whether to include image, link, and meta-tag details, recommendations, broken-link checks, color-contrast checks, and affected-element HTML in issues. Broken-link checks can be limited by maxBrokenLinksToCheck.
Output shape
A single JSON result containing the SEO scan data for the requested page and, when crawling is enabled, internal pages.
The result can include scan issues and recommendations, with detail controlled by detailOptions. When enabled, the HTML report is available as json.html and json.reportHtml. If external callback delivery is enabled, the node also POSTs reportId, data, and htmlReport to the callback URL; dashboard persistence stores a lightweight snapshot and does not store the HTML report.
Examples
Example 1: Scan one page
Set url to the absolute page URL and leave scanInternalLinks off.
Example 2: Scan a site section with exclusions
Enable scanInternalLinks, set maxInternalUrls, and supply requiredUrls, excludedPatterns, or ignoredPages as needed.
Example 3: Receive a browsable report
Enable generateHtmlReport and use a Respond to Webhook node to return {{$json.html}} as text.