seo-traffic-droplisted

<!-- Bundled from Advance-Labs/aeo-toolkit skills/seo-traffic-drop @ dc17e99. Copyright (c) 2026 Advance Labs Inc. Licensed under the Apache License 2.0. Unmodified except for this notice. --> # Diagnosing a search traffic drop The goal is a specific, evidenced answer: **which pages lost the clicks, and what kind of problem it is.** "Traffic is down 20%" is not an answer. "Four pages are 80% of the loss and all four slipped from page one" is. ## Before you start Call `list_gsc_sites` and confirm which property to use. Do not guess the URL format — `https://example.com/` and `sc-domain:example.com` are different properties with different data, and picking the wrong one silently returns an empty or partial answer. Ask for the two periods if the user has not given them. If they say something vague like "since last month", propose two concrete equal-length ranges and confirm before running. **Windows must be equal length and should align on weekdays.** Comparing 30 days to 28 days manufactures a 7% drop out of nothing. Comparing a period containing five Mondays to one containing four does the same, more subtly. ## The diagnosis 1. **Attribute the change.** Call `gsc_traffic_drop` with the two ranges, `dimension: 'page'`. Read `totalClicksLost` and `totalClicksGained` before the contributor list. If both are large, the site did not simply decline — traffic moved, and that is a different story with a different fix. 2. **Find the shape.** Look at `shareOfDecline`