Quick Wins

Build a single prioritized list of quick-win SEO opportunities for one property. The user may pass a property or a focus hint in their request (for example a site URL, a country, or "focus on product pages").

Step 1: Resolve the property

1. 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/.
2. Otherwise call list_sites. If exactly one plausible match exists, use it and say which one you picked. If several are plausible, ask the user which property to analyze before running anything else.
3. If any call fails with an authentication or subscription error, stop and tell the user to run /mcp to (re)authenticate, and that a GSC Wizard account with an active plan or trial plus a connected Google Search Console account is required.

Step 2: Set the date range

Default to the last 28 days compared with the previous period, unless the user specifies otherwise. GSC data lags about 2 to 3 days: never treat the most recent 2 days as complete, and if a dip is visible at the very edge of the range, say explicitly that it is probably the reporting lag, not a real drop.

Step 3: Gather the four signals

Run these for the resolved property and date range. They are independent, so call them together where possible.