Back to blog
Integration 6 min read

Connect Your LLM to Google Search Console Data

Imagine asking "Which keywords should I focus on this week?" and getting an answer based on your actual Search Console data. That's what connecting an LLM to GSC enables.

What is MCP?

The Model Context Protocol (MCP) is a standard that lets AI assistants like Claude, Cursor, and Windsurf connect to external data sources. Instead of copying data back and forth, your AI can query your Search Console directly.

Koala SEO provides an MCP server that exposes your GSC data through a set of tools:

  • list_sites - See all your verified properties
  • get_period_summary - Overview of clicks, impressions, CTR, position
  • get_top_keywords - Best performing queries
  • get_best_trends / get_worst_trends - Rising and declining keywords
  • get_quick_wins - Keywords ranking 11–20 with potential
  • get_ctr_opportunities - Low CTR keywords in top positions

Setup for Claude Desktop

First, get your API key from Settings → API Keys in your dashboard. Then add this to your Claude config:

  • macOS/Linux: ~/.config/claude/config.json
  • Windows: %APPDATA%\Claude\config.json
{
  "mcpServers": {
    "koala-seo": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote",
        "https://koalaseo.net/api/mcp",
        "--header", "Authorization: Bearer YOUR_API_KEY_HERE"
      ]
    }
  }
}

Replace YOUR_API_KEY_HERE with your actual key.

Setup for Cursor

Create or edit ~/.cursor/mcp.json:

{
  "mcpServers": {
    "koala-seo": {
      "url": "https://koalaseo.net/api/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_API_KEY_HERE"
      }
    }
  }
}

Setup for Windsurf

Add to your Windsurf MCP configuration:

{
  "mcpServers": [
    {
      "name": "koala-seo",
      "type": "http",
      "url": "https://koalaseo.net/api/mcp",
      "auth": {
        "type": "bearer",
        "token": "YOUR_API_KEY_HERE"
      }
    }
  ]
}

Using the REST API Directly

If you prefer building your own integration, Koala SEO also provides a REST API. All endpoints are under /api/v1 and require Bearer token authentication.

Example request:

curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://koalaseo.net/api/v1/sites"

See the full API documentation for all available endpoints.

Example Prompts to Try

Once connected, try asking your AI assistant:

  • "What are my top 10 keywords by clicks this month?"
  • "Show me keywords that are declining and might need attention"
  • "Which pages have the best CTR? What can I learn from them?"
  • "Find quick wins - keywords ranking 11-20 with good impressions"
  • "Compare my traffic this month vs last month"

Tips for Better Results

  • Be specific about timeframes: "last 30 days" vs "this week"
  • Mention your site: "For example.com, show me..."
  • Ask for analysis, not just data: "What should I focus on?"
  • Request summaries: "Give me a weekly report"

Next Steps

Ready to connect? Head to API Keys to create your key, then configure your AI assistant. For deeper analysis techniques, read our guide on building custom SEO insights.

Back to blog