Skip to main content

Google Search Console Integration

The Google Search Console (GSC) integration enables WordLift Agent to connect directly with Google Search Console API 📈, providing access to search analytics data.

Agent WordLift Google Search Console Integration

Key Features​

  • Direct GSC API Access: Connect directly to Google's Search Console API to retrieve performance data (this is done using WordLift Dashboard)
  • OAuth Authentication: Secure authentication flow with automated browser handling and token persistence
  • Date-Aware Analysis: Built-in date utilities for working with the most current data
  • Multiple Dimensions: Analyze data by query, page, device, country and other dimensions
  • Metrics Visualization: Get clicks, impressions, CTR, and position data for your content
  • Error Handling: Helpful suggestions when dealing with data issues or permissions

How It Works​

Authentication​

  • First-time setup requires OAuth authentication from the WordLift Dashboard
  • Browser-based flow for secure credential handling
  • Tokens are securely stored in the WordLift platform
  • Data from the GSC is also automatically imported in the Knowledge Graph

Analysis Capabilities​

  • Query-level analysis (what people are searching for)
  • Page-level analysis (which content is performing)
  • Combined analysis (which queries lead to which pages)
  • Performance metrics (clicks, impressions, CTR, position)

Example Use Cases​

  • Identify top-performing content on your website
  • Discover keywords driving traffic to specific pages
  • Analyze search trends over time
  • Find optimization opportunities (high impression, low CTR queries)
  • Compare performance across different sections of your website
  • Monitor mobile vs desktop performance

Getting Started​

To start using the GSC integration:

  1. Ask the agent to "Connect to Google Search Console"
  2. Complete the authentication flow in your browser
  3. Begin querying your search data with natural language prompts

Below is a demonstration of the first-time activation process:

Google Search Console Activation Process

The animation shows the step-by-step process to connect WordLift Agent with Google Search Console through the authentication flow.

Example Prompts​

Here are some example prompts to help you get started with the Google Search Console integration:

  • "Show me my top search queries from the last 7 days"
  • "What are the pages with the highest impressions but low CTR?"
  • "Compare mobile vs desktop performance for my top content"
  • "Show me queries related to [topic] driving traffic to my site"
  • "What new keywords have appeared in the last 30 days?"
  • "Analyze the performance of the blog section of my website"
  • "Which countries are generating the most traffic to my site?"