Agent skill

Google Search Console

by kostja94 in kostja94/marketing-skills

When the user wants to analyze Google Search Console data, use the GSC API, or interpret search performance.

MITAuto-check passedMarketing & SEO

Install Google Search Console

skills CLI
$ npx skills add kostja94/marketing-skills --skill google-search-console -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install kostja94/marketing-skills google-search-console --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/kostja94/marketing-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/analytics/seo/google-search-console .claude/skills/google-search-console && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
google-search-console
GitHub stars
1k
Token cost
~3.3k tokens
SKILL.md length
1,535 words
Files
1
Skills in repo
102
Repo updated
First seen
Licence
MIT

At a glance

When the user wants to analyze Google Search Console data, use the GSC API, or interpret search performance.

  • Works in 9 steps: Performance (Search Results) → Insights Report → Page Indexing (Coverage) → …
  • Wants to analyze Google Search Console data
  • SKILL.md covers Scope, Analysis Best Practices, Key Reports & Metrics and Search Console API, plus 3 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Google Search Console is an agent skill from kostja94/marketing-skills. When the user wants to analyze Google Search Console data, use the GSC API, or interpret search performance. Also use when the user mentions "GSC," "Search Console," "indexing report," "Core Web Vitals," "Enhancements," "Insights report," "search performance," "search queries," "search performance report," "URL inspection," "impressions," "CTR," "average position," "index coverage," "GSC data analysis," "Search Console API," or "searchanalytics.query." When the user wants to rewrite title tags (not only report on…

Its SKILL.md is about 3.3k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Marketing & SEO, covering On-page SEO and Web performance. It works with Google Search Console. The repository describes itself as: Agent Skills for Marketing — SEO, Social, Influencer & More. 160+ open-source skills for SEO, content, 40+ page types, paid ads, channels, and strategies. Add project context… The licence is MIT.

When your agent uses it

  • Wants to analyze Google Search Console data
  • Use the GSC API
  • Interpret search performance
  • The user mentions GSC

Example prompts

  • “Search Console,”
  • “indexing report,”
  • “Core Web Vitals,”
  • “/google-search-console”

Workflow steps

9 steps, taken from the step headings in SKILL.md.

  1. Performance (Search Results)
  2. Insights Report
  3. Page Indexing (Coverage)
  4. Video Indexing (If Applicable)
  5. XML Sitemaps
  6. Core Web Vitals
  7. Enhancements (Rich Results)
  8. AI Overviews (GSC Limitation)
  9. Links & Disavow

What it can do on your machine

Read from SKILL.md and the folder at commit 8dd89c5. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • developers.google.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Google Search Console loads about 3.3k tokens when it runs. Until then it costs about 154 tokens; SKILL.md has 1,535 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~154
When it runs · the whole SKILL.md, loaded when a task matches
~3.3k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from kostja94/marketing-skills at commit 8dd89c5, republished under its MIT licence (© kostja94). 1,535 words, ~3,333 tokens.

Download SKILL.mdSave it as .claude/skills/google-search-console/SKILL.md (or your agent's skills folder).
name
google-search-console
description
When the user wants to analyze Google Search Console data, use the GSC API, or interpret search performance. Also use when the user mentions "GSC," "Search Console," "indexing report," "Core Web Vitals," "Enhancements," "Insights report," "search performance," "search queries," "search performance report," "URL inspection," "impressions," "CTR," "average position," "index coverage," "GSC data analysis," "Search Console API," or "searchanalytics.query." When the user wants to rewrite title tags (not only report on them), use title-tag. For meta description rewrites, use meta-description.
metadata.version
1.5.1

Analytics: Google Search Console

Guides analysis of Google Search Console (GSC) data: performance metrics, indexing, sitemaps, Core Web Vitals, and rich results. Covers best practices for monthly monitoring and actionable insights.

When invoking: On first use, if helpful, open with 1-2 sentences on what this skill covers and why it matters, then provide the main output. On subsequent use or when the user asks to skip, go directly to the main output.

Scope

  • Performance: Clicks, impressions, CTR, average position; API for export
  • Insights: Simplified overview; top/trending content and queries
  • Indexing: Pages indexed, pages not indexed, reasons (Coverage)
  • Technical: Sitemaps, Core Web Vitals, Enhancements
  • API: searchanalytics.query for programmatic access
  • Methodology: How to read charts, avoid common mistakes, correlate with releases

Analysis Best Practices

Chart Reading
PracticeWhy
Focus one metric at a timeStacked bar charts hide fluctuations; toggle off other metrics to see each clearly
Don't compare just two pointsEnd-of-month vs prior month misses mid-month drama; examine full trend
Check beyond top 10Many reports default to top 10; scroll or paginate for more rows
Screenshot chartsGSC retains limited history; save images for future reference
Record in spreadsheetExport at month-end; use formulas to track correlations over time
Track release datesJoin dev standups, read release notes; correlate GSC shifts with deployments
Investigation Workflow
  1. Pinpoint date: When did the metric change?
  2. Correlate: Any releases, CMS changes, server maintenance, third-party code?
  3. Decide: Investigate, correct, overlook, or monitor closely
  4. Loop in: Product or dev team for root cause

Key Reports & Metrics

1. Performance (Search Results)

Location: Performance ? Search results

MetricUse
ClicksTraffic from Google Search
ImpressionsHow often site appeared in results
CTRWhether users think page answers query
Average positionRanking trend

Dimensions: Query, page, country, device, date. Filter by search type: web, image, video, news. Use to find low-CTR high-impression pages (title/meta optimization opportunities).

Search appearance: AMP, blue link, rich results (filterable in UI and API).

CTR Benchmarks by Position

Use to compare actual CTR vs expected. Benchmarks vary by SERP features (AI Overviews, featured snippets). Zero-click: When SERP features satisfy intent without a click, organic CTR drops; factor into expectations. See serp-features (Zero-Click section), featured-snippet. Clean SERPs:

PositionExpected CTR (baseline)With AI Overviews (lower)
125-35%~19%
212-18%~12%
38-12%~7%
4-55-7%~5%
6-102-5%2-5%

Interpretation: If actual CTR is below expected for your position, prioritize title/meta optimization. Over 90% of first-page results have CTR below 10%; significant upside exists.

Low CTR, High Impressions: Optimization Workflow
  1. Identify: Sort by impressions; filter positions 1-10; 1,000+ monthly impressions
  2. Compare: Actual CTR vs expected for position (see table above)
  3. Gap: e.g., position 4 at 2% CTR vs expected 5-7% ? ~3-5% uplift potential
  4. Action: Optimize title and meta per title-tag, meta-description; add schema for rich results (+10–20% clicks)
Rich Results & CTR

Pages with review stars, FAQ schema, or other rich snippets see 10-20% more clicks. See schema-markup.

2. Insights Report

Location: Performance ? Insights (or Overview)

Simplified overview; replaces standalone Search Console Insights. Data from GSC only (GA data removed Dec 2024).

CardUse
Clicks and impressionsSite visibility and click effectiveness
Your contentTop, trending up, trending down pages
Queries leading to your siteTop, trending up, trending down queries
Top countriesGeographic audience
Branded vs non-brandedBrand recognition (AI-labeled; may mislabel)
Additional traffic sourcesImage, Video, News search, Discover

Trending: Based on click change vs previous period. Click items to jump to Performance report filtered to that item.

Query groups: Similar queries grouped; group name = best-performing query. Not available for sub-properties or low-impression sites.

3. Page Indexing (Coverage)

Location: Indexing ? Page indexing

Status grouping (updated): Valid + Valid with warning ? Indexed. Error + Excluded ? Not indexed.

Indexed vs Not indexed are complementary: Not all site content should be indexed. Login, admin, duplicate content, legal boilerplate, and low-value pages often intentionally use noindex. Indexed and non-indexed pages can reference each other (e.g., sitemap includes indexable URLs; noindex pages still exist and link internally). Non-indexed is not inherently a problem--investigate only when important pages are excluded. See indexing (noindex usage) and robots-txt (crawl control) for when to exclude.

MetricAction
Pages indexedTurn off "Pages not indexed" to view alone; watch for drops
Pages not indexedTurn off "Pages indexed" to view alone; watch for spikes. Distinguish intentional (noindex, robots) from accidental

Filter: All submitted pages / Unsubmitted pages only (dropdown near top).

Source column: Indicates whether issue is caused by website or Google.

Why pages are not indexed: Drill into reasons and example URLs. Common culprits:

  • Duplicate content
  • Noindex tags
  • Redirect errors
  • 5xx errors
  • 404 errors
  • Blocked by robots.txt
  • Discovered ? currently not indexed
  • Crawled ? currently not indexed

Quick check: If trend line is stable, spend ~3 seconds; move on. Investigate if fourth column (trend) shifts.

Diagnosis workflow: GSC Coverage ? click Issue ? view sample URLs ? identify pattern ? fix (see indexing for fix actions).

Coverage issue types:

IssueMeaningNext step
Crawled - currently not indexedCrawled but not indexedSee indexing
Excluded by "noindex" tagIntentionally excluded; often valid (login, admin, legal, etc.)Ignore if expected; verify important pages not accidentally noindexed
Blocked by robots.txtCrawl blockedSee robots-txt; may be intentional
Redirect / 404Redirect or missingFix URL or redirect
Duplicate / CanonicalDuplicate contentUsually OK; keep canonical

URL Inspection: Verdicts: "URL is on Google," "URL is on Google, but has issues," "URL is not on Google." Use for important pages; verify canonical, internal links, sitemap; Request indexing if needed.

Show full SKILL.md (626 more words)Show less
4. Video Indexing (If Applicable)

Location: Indexing ? Video indexing

  • Videos indexed / Videos not indexed: Toggle off the other for clear view
  • Why videos are not indexed: Thumbnail blocked, invalid size/format, not in main content, etc.

See video-optimization for video SEO; youtube-seo for YouTube.

5. XML Sitemaps

Location: Indexing ? Sitemaps

CheckAction
StatusConfirm each sitemap says "Success"
URLs indexedClick sitemap ? see indexed count; drops indicate indexing issues
Bellwether sitemapsFor large sites, monitor templated sitemaps (by country, language, division)

Enterprise: Glitches can block new URL crawling, cause hreflang confusion, delay fresh content discovery.

6. Core Web Vitals

Location: Experience ? Core Web Vitals

Priority: Mobile first (Google's higher expectations for mobile).

MetricMobileDesktop
Good URLsTargetSecondary
Needs improvementFixMonitor
Poor URLsFixMonitor

Why URLs don't have good score: Click "Open report" → grouped example URLs by issue type. For threshold values and fixes, see core-web-vitals.

Tip: Historical chart is short; export to spreadsheet for longer trends. Share with dev team regularly; correlate dates with releases.

Layout (updated): Two tables--Poor or Need improvement; Good (click "View data about usable pages").

7. Enhancements (Rich Results)

Location: Experience ? Enhancements (Product snippets, Merchant listings under Shopping)

Status (updated): Two-tier?invalid (critical issues, may not appear) vs valid (no critical issues; may still have warnings). Warnings no longer top-level.

TypeExamples
ContentBreadcrumbs, FAQ, Events, Videos (see video-optimization), Job postings, Review snippets, Q&A, Discussion forums
ShoppingProduct snippets, Merchant listings
OtherRecipes, Datasets, Hotels, Vacation rentals, Profile pages, Practice problems, Math solvers, Image metadata

Note: Reports show sample items, not full list. Use URL Inspection for unlisted URLs.

8. AI Overviews (GSC Limitation)
  • GSC: AI Overviews clicks/impressions are not separated from organic in Performance report.
  • Workaround: Filter queries that tend to trigger AI Overviews to estimate AI-driven visibility:
(?i)^(who|what|where|when|why|how|which|is|are|can|does|should)|\b(vs|versus|compare|difference|pros and cons|guide|tutorial|best|top|list)\b

For GA4 AI traffic tracking, see ai-traffic-tracking.

Location: Links (inbound links), Security & Manual Actions

  • Links report: View links to site and pages; anchor text distribution.
  • Disavow file: Submit via GSC when necessary (manual penalty, toxic links). Use sparingly; over-disavowing can harm. See backlink-analysis for when to disavow.

Search Console API

Method: searchanalytics.query() --exposes all Performance report data.

Metrics

Clicks, Impressions, CTR, Position.

Dimensions

date, query, page, country, device. Search appearance (AMP, blue link, rich results). Filter by search type: web, image, video, news.

Limits
LimitValue
Rows per day per search type per property50,000
Rows per response25,000 (use pagination: startRow, rowLimit)
Data availability2-3 days after

Tip: Run daily queries for one day of data to avoid quota. Verify data presence first (dimensions: date only, no filters).

Optimization: Gzip compression; fields parameter for partial responses; pagination for large datasets.

References: Search Console API, searchanalytics.query

Monthly Audit Checklist

  • Performance: Clicks, impressions, CTR, position trends
  • Insights: Top/trending content and queries (if available)
  • Page indexing: Indexed vs not indexed (isolated views)
  • Why not indexed: Trend lines for key reasons
  • Sitemaps: All "Success"; indexed URL counts stable
  • Core Web Vitals: Mobile good/needs improvement/poor
  • Enhancements: No new invalid items (critical issues)
  • Links: No manual actions; disavow only if needed (see backlink-analysis)
  • Data exported to spreadsheet (month-end snapshot)
  • Charts screenshotted for history
  • Release notes reviewed for correlation

Output Format

  • Summary: Key findings, trends, anomalies
  • Metrics: Specific numbers and date ranges
  • CTR analysis: Actual vs expected by position; low-CTR high-impression pages
  • Title/meta opportunities: Pages with CTR gap; specific optimization suggestions
  • Action items: Prioritized fixes (indexing, CWV, sitemaps, enhancements, title/meta)
  • Correlation: Suspected causes (releases, config changes)
  • Next steps: Monitoring plan, dev handoff
  • title-tag, meta-description, page-metadata: Title and meta optimization for low-CTR pages; hreflang
  • xml-sitemap: Fix sitemap errors
  • indexing: Resolve indexing issues
  • core-web-vitals: CWV optimization; fix LCP, INP, CLS
  • mobile-friendly: Mobile Usability report; mobile-first indexing
  • schema-markup: Fix structured data / rich results
  • backlink-analysis: When to disavow; backlink audit
  • seo-monitoring: Full SEO data analysis, benchmark

© kostja94, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/analytics/seo/google-search-console of kostja94/marketing-skills.

Open the folder on GitHubat commit 8dd89c5

Compare with similar skills

Google Search Console next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Google Search Console compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Google Search Console this skillkostja94/marketing-skills1k—~3.3kAutomated safety check: PassMIT
SEO Coachakseolabs-seo/seo-coach146—~2.8kAutomated safety check: PassNone
Business Website Setupsickn33/agentic-awesome-skills47k1 repos~6.2kAutomated safety check: PassMIT
SEO Validatesoftspark/ai-toolkit179—~3.9kAutomated safety check: NotesApache-2.0
Google SEO APIsAgriciDaniel/claude-seo19k1 repos~4.2kAutomated safety check: PassMIT
Blog GoogleAgriciDaniel/claude-blog2.3k1 repos~3.3kAutomated safety check: NotesMIT

Similar skills

  • SEO Coach

    akseolabs-seo/seo-coach

    Beginner-first SEO coaching for people who want to learn by doing one safe, verifiable step at a time.

    146 GitHub stars~2.8k tokensUpdated 1 mo ago
    Marketing & SEOAuto-check passed
  • Business Website Setup

    sickn33/agentic-awesome-skills

    Website page register: URL, title, meta description, search intent, NAP block, schema type, canonical, indexability and Core Web Vitals target.

    47k GitHub starsUsed in 1 repo~6.2k tokens
    Marketing & SEOAuto-check passed
  • SEO Validate

    softspark/ai-toolkit

    SEO validator: meta/OG, Schema.org, hreflang, Core Web Vitals, crawlability.

    179 GitHub stars~3.9k tokensUpdated yesterday
    Marketing & SEOAuto-check: notes
  • Google SEO APIs

    AgriciDaniel/claude-seo

    Pulls real Google data for SEO work: Search Console, PageSpeed Insights, CrUX field data, the Indexing API and GA4 organic traffic, through /seo google commands.

    19k GitHub starsUsed in 1 repo~4.2k tokens
    Marketing & SEOAuto-check passed
  • Blog Google

    AgriciDaniel/claude-blog

    Google API integration for blog performance: PageSpeed Insights, CrUX Core Web Vitals with 25-week history, Search Console performance, URL Inspection, Indexing API, GA4 organic traffic, NLP entity…

    2.3k GitHub starsUsed in 1 repo~3.3k tokens
    Marketing & SEOAuto-check: notes
  • Google Search SEO Guide

    littleben/awesomeAgentskills

    Answers Google Search optimization questions from reference files covering crawling, indexing, structured data, Search Console and site visibility, drawn from Google's documentation.

    188 GitHub starsUsed in 2 repos~4.2k tokens
    Marketing & SEOAuto-check passed

More from kostja94/marketing-skills

All 102 skills in this repo
  • Grokipedia Recommendations

    kostja94/marketing-skills

    When the user wants to add recommendations, links, or content to Grokipedia.

    1k GitHub starsUsed in 1 repo~4.2k tokens
    Auto-check passed
  • AI Traffic Tracking

    kostja94/marketing-skills

    When the user wants to track AI search traffic in GA4 or GSC.

    1k GitHub stars~959 tokensUpdated 3 days ago
    Auto-check passed
  • Analytics Tracking

    kostja94/marketing-skills

    When the user wants to set up, audit, or optimize analytics tracking (GA4, events, conversions).

    1k GitHub stars~1.5k tokensUpdated 3 days ago
    Auto-check passed
  • Brand Visual Generator

    kostja94/marketing-skills

    When the user wants to define, audit, or apply visual identity (typography, colors, spacing, design tokens, frontend aesthetics).

    1k GitHub stars~3k tokensUpdated 3 days ago
    Auto-check passed
  • Canonical Tag

    kostja94/marketing-skills

    When the user wants to configure canonical URLs, fix duplicate content, or consolidate URL signals.

    1k GitHub stars~1.2k tokensUpdated 3 days ago
    Auto-check passed
  • Content Strategy

    kostja94/marketing-skills

    When the user wants to plan content for SEO, create content calendar, or build topic clusters.

    1k GitHub stars~1.8k tokensUpdated 3 days ago
    Auto-check passed

Questions about Google Search Console

What does Google Search Console do?

When the user wants to analyze Google Search Console data, use the GSC API, or interpret search performance. Google Search Console is an agent skill from kostja94/marketing-skills. When the user wants to analyze Google Search Console data, use the GSC API, or interpret search performance.

When should I use Google Search Console?

Google Search Console fits situations like: wants to analyze Google Search Console data; use the GSC API; interpret search performance; the user mentions GSC.

How do I install Google Search Console in Claude Code?

Run `npx skills add kostja94/marketing-skills --skill google-search-console -a claude-code`. Or copy the skill folder (skills/analytics/seo/google-search-console in kostja94/marketing-skills) into .claude/skills/google-search-console in your project. Claude Code loads it when a task matches its description.

How do I install Google Search Console in Codex?

Run `npx skills add kostja94/marketing-skills --skill google-search-console -a codex`. Or copy the skill folder (skills/analytics/seo/google-search-console in kostja94/marketing-skills) into .agents/skills/google-search-console in your project. Codex loads it when a task matches its description.

Can I use Google Search Console in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add kostja94/marketing-skills --skill google-search-console -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/google-search-console, .gemini/skills/google-search-console, .github/skills/google-search-console and .opencode/skills/google-search-console in your project.

What does Google Search Console need to run?

SKILL.md names no scripts, command-line tools or credentials: Google Search Console is instructions for the agent only.

Does Google Search Console access the network?

SKILL.md names 1 domain. As links in the text: developers.google.com. This is read from the text; nothing was executed.

Is Google Search Console safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Google Search Console use?

Google Search Console is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Google Search Console use?

About 3.3k tokens (SKILL.md is roughly 13k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Google Search Console?

Skills that share tags, products or a category with Google Search Console: SEO Coach (akseolabs-seo/seo-coach, 146 stars), Business Website Setup (sickn33/agentic-awesome-skills, 47k stars), SEO Validate (softspark/ai-toolkit, 179 stars) and Google SEO APIs (AgriciDaniel/claude-seo, 19k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Google Search Console?

kostja94 (a GitHub user) maintains it in kostja94/marketing-skills, which has 1,025 GitHub stars. The repository holds 102 skills in this directory. The repository was last updated on October 6, 2026.

Source: kostja94/marketing-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.