gsc-report

Fetch Google Search Console data and generate a structured performance report.

Updated Mar 20, 2026
One-click install
npx skills add https://github.com/bolun-ben-ship/RightClickAI-seo-workspace --skill gsc-report-bolun-ben-ship
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gsc-report
Source: https://github.com/bolun-ben-ship/RightClickAI-seo-workspace/tree/main/seo-workflow/gsc-report
Command: npx skills add https://github.com/bolun-ben-ship/RightClickAI-seo-workspace --skill gsc-report-bolun-ben-ship

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Pulls live data from Google Search Console for the current client and produces a structured performance summary for easy interpretation and action.

Core Features & Use Cases

  • Top queries by impressions, top pages by clicks, CTR gaps, and ranking movements for the specified date range.
  • Uses the client's CLAUDE.md for configuration, ensuring client-specific outputs and no hard-coded values.
  • Generates a shareable report and can compare with prior reports if available to show month-over-month changes.

Quick Start

Configure CLAUDE.md with the GSC site, credentials env var, and outputs path, then run the report script.

Frequently Asked Questions about gsc-report

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate a Google Search Console report for the last 30 days?

To generate a Google Search Console report, configure your CLAUDE.md file with the target GSC site, credentials env var, and outputs path, then run the Python script to fetch and aggregate 30 days of search performance data into a structured summary.

What is included in a 30-day Google Search Console performance summary?

A 30-day Google Search Console summary includes top queries by impressions, top pages by clicks, CTR gaps, and ranking movements. It aggregates this data to provide client-ready SEO insights and show month-over-month changes when prior reports are available.

How do I configure Google Search Console credentials for automated SEO reporting?

You configure Google Search Console credentials by defining a credentials environment variable and specifying the GSC site URL inside your CLAUDE.md file. This ensures the reporting script authenticates securely and generates client-specific outputs without hard-coded values.

Can I compare month-over-month Google Search Console data for multiple sites?

Yes, you can compare month-over-month Google Search Console data. The script uses CLAUDE.md configuration to handle multiple client sites and compares newly fetched 30-day data with prior saved reports to highlight ranking movements and performance changes.

Does Google Search Console reporting require any specific environment setup?

Google Search Console reporting requires a CLAUDE.md configuration file detailing the GSC site, credentials environment variable, and outputs path. You also need the Python execution environment to run the script that fetches, aggregates, and saves the report locally.