a-seo-gsc

a-seo-gsc: Search Console → action plan

Google Search Console already holds most of the signals for what is wrong with a site's search performance. This skill fetches its Performance data over the API or ingests manual exports, runs a deterministic parser, applies a full analysis playbook (adapting to the site type), and writes a prioritized action plan you can actually execute. It works on any website, not one specific project.

The output is a doc: docs/seo/YYYY-MM-DD-action-plan.md in the target project (or wherever the user keeps analyses), plus a spoken summary of the headline finding and the top moves.

First run: what to give me, and where to get it

Open by asking which route they are on, because both are fully supported and the answer changes only the first step:

Do you have the Search Console API set up for this property, or would you rather download the reports by hand? Both work. The API saves clicking and returns one extra thing the download cannot, but hand-exported CSVs are a first-class input here, not a fallback.

Route A: they have the API, or want it

python3 "${CLAUDE_PLUGIN_ROOT}/skills/a-seo-gsc/scripts/fetch_gsc.py" \
    --key "${user_config.gsc_key_file}" --property sc-domain:example.com --days 90

That writes current/ and previous/ directories of CSVs in Google's own export shape. If the property has no service-account key yet, do not hand them a link. Run Setup mode below.

Then ask for the two reports no API serves:

Two exports I cannot fetch, both from Indexing → Pages:

1. Click Export on the summary. That gives the indexed vs not-indexed counts and the reason breakdown.
2. Click the biggest "not indexed" reason (usually "Crawled - currently not indexed"), then Export the URL table. Repeat for any other large reason. This is the one people skip and the most useful file in the set. Drop the zips in a folder next to the fetched data. Optional extras: the Links report (top linking sites, also no API), Sitemaps, Core Web Vitals, and a screenshot or reading of Performance → Search generative AI (AI Overviews and AI Mode impressions; no API serves it).