site-migration
Site Migration Check
Read out a site migration before or after go-live: how much of the old traffic the new setup has recovered, where the losses sit, which old URLs are unmapped or failing, and what to fix first. The user's request may contain the old and new property, a go-live date, a saved migration name, a mapping label, a URL prefix or regex pair for a move inside one property, or a focus such as "redirects" or "losers".
Steps
-
Resolve the properties. If the user's request or the conversation names a property, use it. Site URLs use GSC formats:
sc-domain:example.comorhttps://www.example.com/. Otherwise calllist_sitesand pick the obvious match. If several plausible properties exist, ask the user which one before continuing. A migration has two sides:- for a domain move, side A is the old property and side B the new one, and both must be in
list_sites; - for a protocol switch or a URL restructure inside one property, both sides are the same property split by a URL prefix or a regex;
- the go-live date is required: ask for it when neither the user's request nor a saved migration supplies one, because
get_migration_healthrefuses to run without agoLiveDateor amigrationIdthat carries one.
- for a domain move, side A is the old property and side B the new one, and both must be in
-
Saved migrations. Call
list_migrations(no arguments).- Each entry carries
id,name,mode(cross-property,two-urlsorregex),siteUrlA,siteUrlB,urlPrefixA/urlPrefixBorregexA/regexB,goLiveDate,windowStrategy,windowDays,yoyBaseline,mappingLabel,alertsEnabled,lastCheckedAtandlastHealth(the daily re-check's last status, recovery, risk score and problem counts). - Pick the one the user means, or ask when several match.
- An empty list carries
emptyBecause(saved migrations are not available on the account, or none are saved) andnextStep; continue with explicit arguments, since nothing needs to be saved to run the analysis.
- Each entry carries