On-Page Audit

Crawl a chosen set of pages on one property, run the technical on-page checks on each, and report the issues grouped by severity with the affected URLs and the fix. The user's request may contain a property, a list of URLs, a sitemap URL, a section path (for example "/blog/"), or a page count; use it to skip resolution and to narrow the URL set. This skill reads the pages' own HTML. For whether Google indexed them, run the indexing-health skill.

Workflow

1. Resolve the property. If the user's request or the conversation names a property, use it. Site URLs use GSC formats: sc-domain:example.com or https://www.example.com/. Otherwise call list_sites and pick the obvious match. If several plausible properties exist, ask the user which one before continuing.

   • The property also bounds the crawl: audit_onpage_seo fetches only URLs that belong to it (a domain property covers its subdomains, a URL-prefix property only its own origin and path prefix) and lists any other URL in skipped with a reason, so a URL on another host needs its own property.

2. Choose the URL set. Take the first source that applies, and keep the whole workflow to about 25 to 50 pages unless the user asks for more, because every page is fetched live from the user's site.

   • The user named URLs: use them as given, at most 25 per call (the urls cap).
   • "My top pages" or no hint: call query_top_pages with the siteUrl and limit: 25, omitting startDate and endDate for the last 28 settled days, and take the page values. Rows are sorted by clicks, highest first; ctr is a 0-100 percentage, never multiply it by 100; position is lower-is-better. GSC data lags about 2 to 3 days, so the window ends before today.
   • No list and no traffic read: omit urls and let the tool auto-pick the top pages by impressions with maxUrls (default 10, max 25) and minImpressions (default 0, counted over the same 28 days).
   • A sitemap or a section: call get_sitemap_performance with sitemapUrl (on the property host; one level of sitemap-index expansion) and maxUrls (default 500, max 2000). Audit the URLs with clicks or impressions first.
   • URLs with zero impressions are an index-coverage question for the sitemap-audit and indexing-health skills, not an on-page one, unless the user asks about them.