MCP/Tools/get_search_performance (MCP)
MCP

get_search_performance (MCP)

Give your AI agent Google Search Console data over MCP: clicks, impressions and positions vs the previous period, a ranked list of what to write next, and index status per post. Hosted, no Google Cloud setup.

get_search_performance returns cached Google Search Console performance for a Blogizi project. It's hosted on the same MCP server as draft_post, update_post and publish_post, so an agent can read what's underperforming and ship the fix in one session. Connect Google and bind a property in the dashboard first; see Search Console.

Arguments

NameTypeRequiredNotes
projectSlugstringWhen the account has more than one projectSame as blogizi use
days7 | 28 | 90 | 180 | 365 | 480NoDefault 28
include("opportunities" | "indexing")[]NoExtra payloads; each list capped at 20 rows

Result

{ "property": "https://my-app.app.blogizi.com/", "range": { "startDate": "2026-09-08", "endDate": "2026-10-05", "days": 28 }, "lastSyncedAt": "2026-10-09T06:00:12.000Z", "totals": { "clicks": 412, "impressions": 18920, "ctr": 0.0218, "position": 18.4 }, "previousTotals": { "clicks": 380, "impressions": 17200, "ctr": 0.0221, "position": 19.1 }, "queries": [ { "keys": ["add blog to nextjs"], "clicks": 38, "impressions": 1210, "ctr": 0.0314, "position": 6.2 } ], "pages": [ { "keys": ["https://my-app.app.blogizi.com/add-blog-to-nextjs"], "clicks": 52, "impressions": 2034, "ctr": 0.0256, "position": 7.9 } ] }

Up to 50 queries and 50 pages, sorted by clicks. include: ["opportunities"] adds near-misses, low-CTR pages, and related lists; include: ["indexing"] adds index counts and issues. ctr is a fraction. The daily chart is only in the REST API response.

Prompts that work

  • “Use get_search_performance for 28 days. Which pages have over 200 impressions and CTR below 1%? Suggest a new title and description for each.”
  • “Compare 7 and 28 days. Which queries are new this week?”
  • “Find queries where we rank 8–20. Which existing post should cover each one, and what section is missing?”
  • “Rewrite the top candidate and save it with update_post as a draft.”

Errors

  • “Search Console is not bound for this project…”: connect Google and bind a property in the dashboard Search tab.
  • Project errors: pass projectSlug when the account has several blogs.

Limits

Cached data (daily sync; a range that isn't cached yet is fetched on the first call), 7 days to 16 months, top 50 queries and pages, opportunity and indexing lists capped at 20 rows. Index status comes from a daily URL Inspection check, so it can lag a day after you publish. Countries and devices are in the dashboard only. It can't request indexing or submit sitemaps.