Skip to main content

seocheck

Run SEO checks against URLs found in a sitemap. Supports remote sitemap URLs and local files.

Usage

  • worai seocheck <sitemap_url_or_path> [options]

Arguments

ArgumentTypeDescription
sitemap_url_or_pathstringURL or local file path to a sitemap XML (or sitemap index). Supports .gz files and file:// URLs.

Options

OptionTypeDefaultDescription
--max-urlsintnoneLimit the number of URLs checked.
--timeoutfloat20.0Timeout (seconds) for HTTP requests (sitemaps, robots.txt, llms.txt).
--user-agentstringbrowser-likeUser-Agent header for HTTP requests (sitemaps, robots.txt, llms.txt).
--sitemap-fetch-modechoiceautoHow to fetch sitemaps: requests, browser (Playwright), or auto (fallback to browser).
--page-timeoutint30000Timeout (ms) for browser page loads.
--wait-untilchoicedomcontentloadedPlaywright wait strategy: domcontentloaded, load, networkidle.
--ttfb-ok-msfloat200.0TTFB ok threshold in ms.
--ttfb-warn-msfloat500.0TTFB warn threshold in ms.
--headedboolfalseRun the browser with a visible UI instead of headless.
--formatchoicetextOutput format: text or json.
--output-dirstringnoneWrite report outputs to this directory (report.json, summary.txt, per-page JSONs, report UI).
--outputstringnoneWrite a comprehensive JSON report to this file path.
--output-summarystringnoneWrite a human-readable summary report to this file path.
--save-htmlboolfalseSave rendered HTML for each page to the output directory.
--no-report-uiboolfalseDo not serve or open the HTML report UI.
--checksstringnoneComma-separated list of page check names to run (others disabled).
--disable-checksstringnoneComma-separated list of page check names to skip.
--concurrencystring1Number of pages to process concurrently, or auto.

Examples

  • worai seocheck https://example.com/sitemap.xml
  • worai seocheck ./sitemap.xml --max-urls 50 --format json
  • worai seocheck https://example.com/sitemap.xml --output-dir ./seocheck-report --save-html
  • worai seocheck https://example.com/sitemap.xml --user-agent "Mozilla/5.0 ..."
  • worai seocheck https://example.com/sitemap.xml --sitemap-fetch-mode browser
  • worai seocheck https://example.com/sitemap.xml --no-report-ui