Untapped Search Console

io.github.CTF-MaxPublished by GitHub account CTF-Maxv0.2.0Updated Oct 30, 2026

What people search to find you, and what's close

VerifiedSTDIODesktop onlyWeb Search & ScrapingData & Analytics

Overview

AI-generated overview

Read-only Google Search Console plugin that lets an assistant show what queries and pages earn clicks, which are close to page one, and what changed month…

What you can do
  • Sign in to Google read-only and check or clear the shared Untapped sign-in state
  • List the Search Console properties the account can access
  • Report true clicks and impressions for a chosen date window
  • Break performance down by query, page, country, device or date, with filters
  • Classify queries as earning, close to page one, top-3 without clicks, or invisible
  • Compare one window against the previous one to find gainers, losers, new and lost queries
When to use it
Useful for SEO and content work where you want an assistant to read your own Search Console data and point out quick wins, title or snippet fixes, and month-over-month movement without exporting reports by hand.
Requirements
Runs locally as a Claude Code or Codex plugin and needs Python 3.10+ on PATH as python (standard library only). Requires a Google Cloud Desktop app OAuth client with the Search Console API enabled, supplied as a client secret file (for Codex via the UNTAPPED_GOOGLE_CLIENT_SECRET variable), then a google_login call. Network access to Google sign-in and Search Console endpoints.
Before you install
You hand it a Google OAuth client secret file and grant read-only Search Console access to your Google account; the sign-in is shared with other Untapped Google plugins. Data goes only to Google endpoints, with no telemetry. Query rows are incomplete because Google hides rare queries, and position figures are directional averages.

Installation

In SourceWeft

  1. Open Untapped Search Console in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

Untapped Search Console

What people search to find your site, which searches are close to page one, and what moved since last month, read from your own Search Console. Free and read-only. Built by Find Untapped Growth.

Tools

ToolAnswers
google_login / google_login_status / google_logoutOne read-only Google sign-in, shared with every Untapped Google plugin
gsc_sitesYour Search Console properties
gsc_totalsThe site's true clicks and impressions for a window
gsc_performanceRows by query / page / country / device / date (up to 3 at once), with filters
gsc_whats_workingearning (protect) · close, position 4–20 with no clicks (where work pays) · top3_no_clicks (fix the title/snippet) · invisible (past 20)
gsc_compareThis window vs the previous one: gainers, losers, new, lost, and both windows' true totals

Windows end 3 days back by default, because Search Console's last ~2 days aren't final and a window ending today shows a fake dip.

Install

  • Claude Code: /plugin install untapped-search-console --marketplace CTF-Max/untapped-plugins (or, from a terminal: claude plugin marketplace add CTF-Max/untapped-plugins, then claude plugin install untapped-search-console@untapped-plugins).
  • Codex: codex plugin marketplace add CTF-Max/untapped-plugins, then codex plugin add untapped-search-console@untapped-plugins.
  • Needs Python 3.10+ on PATH as python. Standard library only: nothing to pip install.

Setup

Same Google sign-in as Untapped Index Watch: a Google Cloud Desktop app OAuth client with the Search Console API enabled (steps in Index Watch's README). Claude Code: choose that file in the plugin's settings ("Google OAuth client file"). Codex: setx UNTAPPED_GOOGLE_CLIENT_SECRET "C:\path\to\client_secret.json" and restart. Then ask your agent to run google_login. Signed in already through Index Watch? Nothing more to do.

What it connects to

Only Google: accounts.google.com and oauth2.googleapis.com to sign in, searchconsole.googleapis.com and www.googleapis.com for your Search Console data. No telemetry. Details: PRIVACY.md.

Limits

  • Google hides rare queries for privacy, so query rows never add up to the site total; gsc_totals gives the real one.
  • Position is an average of averages: directional only.
  • gsc_compare compares each window's top 1,000 rows, so "lost" can mean "fell below the top 1,000".

Development

python -m unittest discover -s untapped-search-console/tests   # offline, 7 tests

Source: untapped-search-console/README.md at commit c5eb3c7

Tools

0
SourceWeft started this package once in an isolated sandbox, without credentials, to list its tools. That failed: the package type cannot run in the sandbox.

Version history

1
  1. v0.2.0LatestOct 22, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts