Google Search Console

Query Google Search Console for SEO data - search queries, top pages, CTR opportunities, URL inspection, and sitemaps. Use when analyzing search performance,...

Security Scan

The skill's code, instructions, and required environment variables are consistent with a read-only Google Search Console client; nothing in the package appears disproportionate to its stated purpose.

Purpose & Capability

Name/description match the requested artifacts: Python scripts implement OAuth and read-only queries against Google Search Console. Required env vars (GOOGLE_CLIENT_ID, GOOGLE_CLIENT_SECRET, GOOGLE_REFRESH_TOKEN) are appropriate for OAuth flows to access GSC.

Instruction Scope

SKILL.md instructs only read-only queries and the code implements only read operations (search analytics, sitemaps, URL inspection). The auth script runs a local OAuth flow (opens a browser / local server on port 8080) and prints the refresh token to stdout for user to store — this is expected but worth noting because the refresh token is sensitive and the script suggests adding it to a local .env.

Install Mechanism

No install spec; scripts are instruction-only and depend on python and standard google API libraries. The package does not download or execute code from external URLs. Missing Python packages produce a pip install hint — the user will need to install libraries manually.

Credentials

Requested environment variables are limited to the OAuth client ID, client secret, and refresh token which are proportionate to the skill's read-only GSC purpose. Note: the refresh token can be used by any code that has these env vars, and SKILL.md explicitly notes credentials are shared with a GA4 skill — meaning other installed skills that read the same env vars could access the same account.

Persistence & Privilege

Skill is not always-enabled, does not modify other skills or system settings, and does not request unusual system privileges. It runs as a normal command-line Python tool.

Assessment

This skill appears to be a straightforward, read-only Google Search Console client. Before installing or using it: (1) Only provide OAuth credentials you trust the code with — the refresh token is sensitive and grants access to your Search Console data. (2) Run the included gsc_auth.py locally; it opens a browser and a localhost server (port 8080) to obtain a refresh token which it prints — save that token securely (e.g., in a local .env) and avoid pasting it into untrusted places. (3) Install required Python packages from official PyPI packages (google-auth, google-auth-oauthlib, google-api-python-client) and review their versions. (4) Be aware that any other skill or program with access to the same environment variables can access your GSC data; do not reuse these env vars across untrusted skills. (5) If you need stricter isolation, create a dedicated Google OAuth client with only the webmasters.readonly scope and a Google account or Search Console property with minimal permissions.

Google Search Console Skill

Query GSC for search analytics, indexing status, and SEO insights.

Safety Boundaries

• This skill only connects to Google Search Console API endpoints.
• It does NOT modify your Search Console property — read-only queries only.
• It does NOT store or transmit credentials beyond the current session.
• It requires OAuth credentials set as environment variables.

Setup

1. Credentials: Set OAuth credentials in environment variables (or a local .env loaded by your shell)
2. Scopes: Requires webmasters.readonly scope on your Google Cloud OAuth consent screen
3. Access: Your Google account must have access to the Search Console properties

Commands

List Available Sites

python scripts/gsc_query.py sites

Top Search Queries

python scripts/gsc_query.py top-queries \
  --site "https://www.nutrient.io" \
  --days 28 \
  --limit 20

Top Pages by Traffic

python scripts/gsc_query.py top-pages \
  --site "https://www.nutrient.io" \
  --days 28 \
  --limit 20

Find Low-CTR Opportunities

High impressions but low click-through rate = optimization opportunities:

python scripts/gsc_query.py opportunities \
  --site "https://www.nutrient.io" \
  --days 28 \
  --min-impressions 100

Inspect URL Indexing Status

python scripts/gsc_query.py inspect-url \
  --site "https://www.nutrient.io" \
  --url "/sdk/web"

List Sitemaps

python scripts/gsc_query.py sitemaps \
  --site "https://www.nutrient.io"

Raw Search Analytics (JSON)

python scripts/gsc_query.py search-analytics \
  --site "https://www.nutrient.io" \
  --days 28 \
  --dimensions query page \
  --limit 100

Available Dimensions

• query - Search query
• page - Landing page URL
• country - Country code
• device - DESKTOP, MOBILE, TABLET
• date - Date

Metrics Returned

• clicks - Number of clicks from search
• impressions - Number of times shown in search
• ctr - Click-through rate (clicks/impressions)
• position - Average ranking position

SEO Use Cases

1. Content Optimization: Find high-impression/low-CTR pages → improve titles & descriptions
2. Keyword Research: See what queries bring traffic → create more content around them
3. Technical SEO: Check indexing status, find crawl issues
4. Ranking Tracking: Monitor position changes over time
5. Sitemap Health: Verify sitemaps are submitted and error-free

Notes

• Data has ~3 day delay (GSC limitation)
• Credentials shared with GA4 skill
• URL inspection requires the page to be in the property