Skip to main content
Glama
grain-seo-mcp

grain-seo-mcp

by zhangluka

grain-seo-mcp

SEO analysis MCP server — Google Search Console, Bing Webmaster Tools, GA4 analytics, with custom Grain Analysis Tools.

English | 简体中文

Grain Analysis Tools (new)

Tool

What it does

grain_content_decay

Detect pages with 3 consecutive 30-day traffic decline

grain_traffic_drops

Diagnose WHY traffic dropped: ranking loss / CTR collapse / demand decline

grain_ctr_benchmark

Compare CTR vs industry benchmarks by position

grain_verify_claim

Anti-hallucination: re-query GSC to verify numeric claims (±5% tolerance)

grain_topic_cluster

Aggregate performance for URL path patterns (e.g. /blog/)

grain_content_recommendations

Prioritized SEO actions: update / create / consolidate

Related MCP server: mcp-seo-audit

Platform Tools

Google Search Console, Bing Webmaster Tools, Google Analytics 4 tools. See tools_list.md for full list.

Setup

Google Cloud Credentials

  1. Go to Google Cloud Console

  2. Create project, enable Search Console API

  3. Create OAuth credentials (Desktop app) or Service Account

  4. Download JSON

Claude Code Configuration

Add to ~/.claude/settings.json:

{
  "mcpServers": {
    "grain-seo": {
      "command": "node",
      "args": ["/Users/bobby/Projects/Github/zhangluka/grain-seo-mcp/dist/index.js"],
      "env": {
        "GSC_OAUTH_SECRETS_FILE": "/path/to/client_secrets.json"
      }
    }
  }
}

First use opens browser for Google sign-in. Token cached after that.

License

MIT

Available Tools

104 tools
accounts_add_siteC

Authorize a specific site or domain for an account (Account Boundary)

Inputs: accountId (required), site (required).

accounts_listA

List all authorized Google and Bing accounts

Inputs: no named parameters.

accounts_removeC

Remove an authorized account

Inputs: accountId (required).

analytics_anomaliesB

Identify unusual daily spikes or drops in traffic.

Inputs: siteUrl (required), days, threshold.

analytics_audience_segmentsB

Get audience segmentation (New vs Returning, Age, OS) in a single batch

Inputs: propertyId (required), startDate (required), endDate (required), accountId.

analytics_by_countryB

Get performance breakdown by country for the last N days.

Inputs: siteUrl (required), days, limit, sortBy.

analytics_compare_periodsA

Compare performance metrics between two date periods. Useful for week-over-week or month-over-month analysis.

Inputs: siteUrl (required), period1Start (required), period1End (required), period2Start (required), +1 more.

analytics_content_performanceB

Analyze content performance by Content Group in GA4 (Requires Content Groups to be configured in GA4 Admin)

Inputs: propertyId (required), startDate (required), endDate (required), accountId, +2 more.

analytics_conversion_funnelC

Analyze top converting pages and events

Inputs: propertyId (required), startDate (required), endDate (required), accountId, +1 more.

analytics_drop_attributionA

Analyze a significant traffic drop to identify if it was caused by specific devices (mobile/desktop) or coincides with known Google algorithm updates.

Inputs: siteUrl (required), days, threshold.

analytics_ecommerceB

Get ecommerce performance (products, revenue) from GA4

Inputs: propertyId (required), startDate (required), endDate (required), accountId, +2 more.

analytics_organic_landing_pagesC

Get performance of organic landing pages in GA4 (matches GSC data)

Inputs: propertyId (required), startDate (required), endDate (required), accountId, +2 more.

analytics_page_performanceB

Get detailed page performance metrics from GA4 (sessions, views, engagement)

Inputs: propertyId (required), startDate (required), endDate (required), accountId, +4 more.

analytics_pagespeed_correlationB

Correlate GA4 engagement metrics with PageSpeed Insights scores for top organic pages

Inputs: propertyId (required), domain (required), startDate (required), endDate (required), +3 more.

analytics_performance_summaryA

Get the aggregate performance metrics (clicks, impressions, CTR, position) for the last N days.

Inputs: siteUrl (required), days, engine.

analytics_queryC

Query search analytics data with optional pagination

Inputs: siteUrl (required), startDate (required), endDate (required), dimensions, +7 more.

analytics_realtimeA

Get realtime active users broken down by page, country, and device

Inputs: propertyId (required), accountId.

analytics_search_appearanceA

Get performance breakdown by search appearance type for the last N days.

Inputs: siteUrl (required), days, limit, sortBy.

analytics_time_seriesA

Get advanced time series data including rolling averages, seasonality strength, and trend forecasting. Supports multi-dimensional analysis, metrics selection, and custom granularities.

Inputs: siteUrl (required), days, startDate, endDate, +6 more.

analytics_top_pagesC

Get top performing pages by clicks or impressions for the last N days.

Inputs: siteUrl (required), days, limit, sortBy.

analytics_top_queriesB

Get top search queries by clicks or impressions for the last N days.

Inputs: siteUrl (required), days, limit, sortBy.

analytics_traffic_sourcesC

Analyze traffic sources (Channel, Source, Medium) in GA4

Inputs: propertyId (required), startDate (required), endDate (required), accountId, +3 more.

analytics_user_behaviorB

Get user behavior breakdown (Device, Country, Engagement) in a single batch

Inputs: propertyId (required), startDate (required), endDate (required), accountId.

bing_analytics_compare_periodsB

Compare performance between two date ranges in Bing

Inputs: siteUrl (required), startDate1 (required), endDate1 (required), startDate2 (required), +1 more.

bing_analytics_detect_anomaliesC

Detect performance anomalies in Bing traffic

Inputs: siteUrl (required), days, threshold.

bing_analytics_drop_attributionC

Identify the likely cause of a Bing traffic drop

Inputs: siteUrl (required), days, threshold.

bing_analytics_pageC

Get page performance stats from Bing Webmaster Tools (Top Pages)

Inputs: siteUrl (required), startDate, endDate.

bing_analytics_page_queryB

Get query performance stats for a specific page from Bing Webmaster Tools

Inputs: siteUrl (required), pageUrl (required), startDate, endDate.

bing_analytics_queryB

Get query performance stats from Bing Webmaster Tools (Top Queries)

Inputs: siteUrl (required), startDate, endDate, limit, +1 more.

bing_analytics_query_pageC

Get combined query and page performance stats for a site

Inputs: siteUrl (required), startDate, endDate.

bing_analytics_time_seriesC

Advanced time series analysis for Bing performance data

Inputs: siteUrl (required), days, granularity, metrics.

bing_brand_analysisC

Analyze Brand vs Non-Brand performance on Bing.

Inputs: siteUrl (required), brandRegex (required), days.

bing_crawl_issuesC

Get crawl issues for a site from Bing Webmaster Tools

Inputs: siteUrl (required).

bing_crawl_statsA

Get crawl statistics (indexed, crawled, errors) for a site

Inputs: siteUrl (required).

bing_get_top_pagesC

Alias for bing_analytics_page. Get top pages for a site.

Inputs: siteUrl (required).

bing_get_top_queriesC

Alias for bing_analytics_query. Get top queries for a site.

Inputs: siteUrl (required), startDate, endDate.

bing_index_nowC

Submit URLs via IndexNow API (Bing, Yandex, etc.)

Inputs: host (required), key (required), urlList (required), keyLocation.

bing_keywords_statsB

Get historical stats for a keyword in Bing

Inputs: q (required), country, language.

bing_low_ctr_opportunitiesB

Identify high-ranking Bing queries with lower than expected CTR

Inputs: siteUrl (required), minImpressions.

bing_opportunity_finderC

Find high-potential 'low-hanging fruit' keywords in Bing

Inputs: siteUrl (required), minImpressions.

bing_rank_traffic_statsB

Get historical rank and traffic statistics for a site

Inputs: siteUrl (required).

bing_seo_cannibalizationB

Detect pages competing for the same query in Bing.

Inputs: siteUrl (required), minImpressions.

bing_seo_lost_queriesC

Identify queries that lost significant traffic on Bing compared to the previous period.

Inputs: siteUrl (required), days.

bing_seo_recommendationsB

Generate prioritized SEO recommendations for a Bing site

Inputs: siteUrl (required).

bing_sitemaps_deleteC

Remove a sitemap from Bing Webmaster Tools

Inputs: siteUrl (required), sitemapUrl (required).

bing_sitemaps_listC

List sitemaps for a Bing site

Inputs: siteUrl (required).

bing_sitemaps_submitC

Submit a sitemap to Bing Webmaster Tools

Inputs: siteUrl (required), sitemapUrl (required).

bing_sites_addB

Add a new site to Bing Webmaster Tools

Inputs: siteUrl (required).

bing_sites_deleteB

Remove a site from Bing Webmaster Tools

Inputs: siteUrl (required).

bing_sites_healthA

Run a comprehensive health check on one or all verified Bing sites

Inputs: siteUrl.

bing_sites_listB

List all sites verified in Bing Webmaster Tools

Inputs: no named parameters.

bing_striking_distanceA

Find keywords ranking positions 8-15 on Bing (near page 1)

Inputs: siteUrl (required).

bing_url_infoB

Get detailed indexing and crawl information for a URL in Bing

Inputs: siteUrl (required), url (required).

bing_url_submission_quotaB

Get remaining URL submission quota for Bing

Inputs: siteUrl (required).

bing_url_submitB

Submit a single URL to Bing for indexing

Inputs: siteUrl (required), url (required).

bing_url_submit_batchA

Submit multiple URLs to Bing for indexing in a single batch

Inputs: siteUrl (required), urlList (required).

brand_analysisB

Analyze Brand vs Non-Brand performance across GSC, Bing, and GA4

Inputs: brandTerms (required), gscSiteUrl (required), bingSiteUrl (required), ga4PropertyId (required), +5 more.

compare_enginesB

Compare performance data between Google and Bing for a specific dimension (query, page, etc).

Inputs: siteUrl (required), dimension (required), startDate (required), endDate (required), +4 more.

diagnosticsA

Run connectivity diagnostics for all connected accounts. Use this to troubleshoot '0 results' or authentication issues.

Inputs: no named parameters.

get_startedA

Start here. Returns a complete map of this server's capabilities, active platforms, and recommended workflows. Call this once at the beginning of any session.

Inputs: no named parameters.

grain_content_decayA

Detect pages with consistent traffic decline across 3 consecutive 30-day windows. Only flags pages with strict monotonic decline (oldest > middle > newest).

Inputs: siteUrl (required), minClicks, limit.

grain_content_recommendationsB

Generate prioritized SEO recommendations by cross-referencing quick wins, content gaps, and cannibalization. Returns update/create/consolidate actions.

Inputs: siteUrl (required), days, maxRecommendations.

grain_ctr_benchmarkA

Compare actual CTR per page against industry benchmarks by position. Classifies as Above/At/Below/Significantly below benchmark.

Inputs: siteUrl (required), days, minImpressions, limit.

grain_topic_clusterA

Aggregate performance for all pages matching a URL path pattern (e.g. /blog/, /guides/). Returns top pages and queries.

Inputs: siteUrl (required), pathPattern (required), days.

grain_traffic_dropsA

Diagnose WHY traffic dropped: ranking loss, CTR collapse, search demand decline, or page disappeared. Compares current vs prior period.

Inputs: siteUrl (required), days, limit.

grain_verify_claimB

Anti-hallucination: re-query GSC to verify a specific numeric claim. Tolerance: position ±0.5, other metrics ±5%.

Inputs: siteUrl (required), claim (required), metric (required), expectedValue (required), +3 more.

indexing_batch_submitA

Submit multiple URLs for indexing in batch. Google: max 200 (daily quota), Bing: max 500.

Inputs: siteUrl (required), urls (required), engine.

indexing_remove_urlA

Notify Google that a URL has been removed (e.g., expired job posting). Google only.

Inputs: siteUrl (required), url (required).

indexing_statusA

Check the notification status for a URL previously submitted to the Google Indexing API

Inputs: siteUrl (required), url (required).

indexing_submit_urlA

Submit a URL for indexing (notify Google or Bing that a page was updated). Google Indexing API is officially for JobPosting/BroadcastEvent pages.

Inputs: siteUrl (required), url (required), engine.

inspection_batchB

Inspect multiple URLs for a site in batch

Inputs: siteUrl (required), inspectionUrls (required), languageCode, engine.

inspection_inspectB

Inspect a URL to check its indexing status, crawl info, and health

Inputs: siteUrl (required), inspectionUrl (required), languageCode, engine.

opportunity_matrixC

Prioritize SEO tasks by combining signals from GSC, GA4, and Bing

Inputs: gscSiteUrl (required), bingSiteUrl (required), ga4PropertyId (required), startDate (required), +5 more.

page_analysisC

Compare GSC ranking data with GA4 behavior data for top pages to find opportunities

Inputs: gscSiteUrl (required), ga4PropertyId (required), startDate (required), endDate (required), +3 more.

pagespeed_analyzeB

Run PageSpeed Insights analysis on a URL to get performance, accessibility, best practices, and SEO scores

Inputs: url (required), strategy.

pagespeed_core_web_vitalsB

Get Core Web Vitals for both mobile and desktop including LCP, FID, CLS, FCP, TTI, and TBT

Inputs: url (required).

schema_validateA

Validate Schema.org structured data (JSON-LD) from a URL, HTML snippet, or JSON object.

Inputs: type (required), data (required).

seo_brand_vs_nonbrandC

Analyze performance split between Brand and Non-Brand queries using a regex.

Inputs: siteUrl (required), brandRegex (required), days, engine.

seo_cannibalizationC

Detect keyword cannibalization - multiple pages competing for the same query

Inputs: siteUrl (required), days, minImpressions, limit, +1 more.

seo_lost_queriesB

Identify queries that lost all traffic (or dropped >80%) compared to the previous period.

Inputs: siteUrl (required), days, limit, engine.

seo_low_ctr_opportunitiesA

Find queries with low CTR relative to their ranking position. Great for title tag optimization.

Inputs: siteUrl (required), days, minImpressions, limit, +1 more.

seo_low_hanging_fruitB

Find keywords with high impressions but low rankings that have potential for growth

Inputs: siteUrl (required), days, minImpressions, limit, +1 more.

seo_primitive_is_brandC

primitive: Check if a query is a brand query based on a regex pattern.

Inputs: query (required), brandRegex (required), engine.

seo_primitive_is_cannibalizedC

primitive: Check if two pages are competing for the same query based on their metrics.

Inputs: query (required), pageA_position (required), pageA_impressions (required), pageA_clicks (required), +4 more.

seo_primitive_ranking_bucketB

primitive: Get the ranking bucket for a specific position (e.g. Top 3, Page 1).

Inputs: position (required), engine.

seo_primitive_traffic_deltaB

primitive: Calculate the delta between two traffic metrics (absolute and percentage).

Inputs: current (required), previous (required), engine.

seo_quick_winsA

Find pages with queries ranking on page 2 (positions 11-20) that could be pushed to page 1

Inputs: siteUrl (required), days, minImpressions, limit, +1 more.

seo_recommendationsC

Generate SEO recommendations based on site performance data

Inputs: siteUrl (required), days, engine.

seo_striking_distanceA

Find keywords ranking in positions 8-15. These are high-priority targets to push to Page 1.

Inputs: siteUrl (required), days, limit, engine.

sitemaps_deleteB

Delete a sitemap from Search Console or Bing Webmaster Tools

Inputs: siteUrl (required), feedpath (required), engine.

sitemaps_getB

Get details about a specific sitemap

Inputs: siteUrl (required), feedpath (required).

sitemaps_listB

List sitemaps for a site

Inputs: siteUrl (required), engine.

sitemaps_submitB

Submit a sitemap to Search Console or Bing Webmaster Tools

Inputs: siteUrl (required), feedpath (required), engine.

sites_addB

Add a new site to Search Console or Bing Webmaster Tools

Inputs: siteUrl (required), engine.

sites_deleteA

Remove a site from Search Console or Bing Webmaster Tools

Inputs: siteUrl (required), engine.

sites_getA

Get information about a specific site

Inputs: siteUrl (required).

sites_health_checkB

Run a health check on one or all verified sites. Checks performance trends and status.

Inputs: siteUrl, engine.

sites_listA

List all verified sites or properties across all authorized accounts

Inputs: engine.

traffic_health_checkB

Diagnose tracking issues by comparing GSC clicks vs GA4 organic sessions

Inputs: gscSiteUrl (required), ga4PropertyId (required), startDate (required), endDate (required), +2 more.

util_star_repoA

Star the GitHub repository to support the project. Uses GitHub CLI if available, or opens a browser.

Inputs: no named parameters.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    C2.6/5.0

    Scored across 104 tools

    Disambiguation1/5

    Several tools are explicitly aliases of each other (bing_get_top_queries for bing_analytics_query, bing_get_top_pages for bing_analytics_page), and many bing_* tools mirror seo_* tools with only an engine difference (cannibalization, lost queries, striking distance, low CTR). The overlapping brand analysis tools and multiple URL submission tools further blur boundaries, making reliable tool selection very difficult.

    Naming Consistency2/5

    Naming is inconsistent across the set: some tools use noun_verb (sites_list, sitemaps_submit, analytics_query), some use verb_noun (compare_engines, get_started), and many use noun phrases with no verb at all (seo_cannibalization, grain_content_decay, diagnostics, opportunity_matrix). The aliases also break expectation, such as bing_get_top_queries vs bing_analytics_query.

    Tool Count1/5

    With 104 tools, this is an extreme count that far exceeds the well-scoped 3-15 range. The count is inflated by engine-specific duplicates, aliases, and many overlapping analytical variants rather than genuinely distinct capabilities.

    Completeness4/5

    The tool surface is broadly comprehensive, covering Google Search Console, Bing Webmaster Tools, GA4, PageSpeed, schema validation, indexing, and diagnostics. Minor gaps exist such as missing Google-side link or keyword research equivalents, but the core SEO workflow is well represented.

    Maintenance

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      B
      quality
      D
      maintenance
      An MCP server that integrates Google Search Console and Google Analytics 4 to provide unified SEO and web traffic analysis. It allows users to fetch search performance data, merge page metrics, and generate automated trend reports or actionable insights through tool calls.
      16
      1
      -
    • A
      license
      B
      quality
      B
      maintenance
      SEO audit and Google Search Console MCP server with 23 tools. Search analytics, URL inspection, Indexing API, Core Web Vitals (CrUX), striking distance keywords, keyword cannibalization detection, branded query analysis, and automated site audits.
      43
      3
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      MCP server for advanced Google Search Console analysis — keyword cannibalization detection, page-level query deep dive, and rank change tracking.
      3
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      An MCP server that connects AI assistants to SEO platforms like Google Search Console, GA4, Bing Webmaster Tools, and Adobe Analytics, enabling natural language queries about SEO performance.
      1,377 npm
      MIT