SerpData MCP Server

An MCP (Model Context Protocol) server that integrates with the SerpData API to fetch Google search results with rich snippets and metadata.

Features

• 🔍 Full Google SERP data including organic results
• 📊 Rich snippets: AI Overview, People Also Ask, Related Searches, Knowledge Panels
• 🌍 Multi-language and multi-region support
• 🎥 Video packs, image carousels, and product listings
• ⚡ Fast and reliable results via SerpData API

Configuration

1. Get your SerpData API Key

Sign up at SerpData to get your API key.

2. Configure Claude Desktop (or Cursor)

Add the server to your Claude Desktop configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "serpdata": {
      "command": "npx",
      "args": ["serpdata-mcp"],
      "env": {
        "SERPDATA_API_KEY": "your-api-key-here"
      }
    }
  }
}

Restart Claude Desktop after updating the configuration.

Usage

Once configured, you can use the get_serp_results tool in Claude with the following parameters:

• keyword (required): Search query/keyword
• hl (optional): Language code (default: "pl")
• gl (optional): Country code (default: "pl")

Examples

Polish search (default):

{
  "keyword": "najlepsze restauracje w Warszawie"
}

English search for USA:

{
  "keyword": "best restaurants in New York",
  "hl": "en",
  "gl": "us"
}

German search for Germany:

{
  "keyword": "beste Restaurants in Berlin",
  "hl": "de",
  "gl": "de"
}

Supported Languages and Countries

Common Language Codes (hl):

• pl - Polish
• en - English
• de - German
• fr - French
• es - Spanish
• it - Italian
• pt - Portuguese
• ru - Russian
• ja - Japanese
• zh - Chinese

Common Country Codes (gl):

• pl - Poland
• us - United States
• uk - United Kingdom
• de - Germany
• fr - France
• es - Spain
• it - Italy
• ca - Canada
• au - Australia
• br - Brazil

Response Structure

The API returns comprehensive SERP data including:

Organic Results

Standard search results with title, URL, and domain information.

Rich Snippets (by frequency):

• Related Searches (95.2%) - Related search queries
• People Also Ask (84.6%) - Common questions about the topic
• Videos Pack (39.4%) - Video carousel results
• Knowledge Panel (34.6%) - Entity information sidebar
• Popular Products (27.9%) - Shopping/product results
• Refine Chips (25.0%) - Search refinement suggestions
• Filter Sidebar (23.1%) - Filter options
• Things to Know (18.3%) - Key information points
• Images Pack (14.4%) - Image carousel
• AI Overview (12.5%) - AI-generated summary

Troubleshooting

Server not appearing in Claude Desktop

1. Ensure the configuration file is in the correct location
2. Check that the JSON syntax is valid
3. Restart Claude Desktop completely
4. Verify your API key is correct

No results returned

1. Check your internet connection
2. Verify the API key is valid
3. Ensure you're using correct language/country codes
4. Check SerpData API status

Error messages

• "Invalid parameters": Check that keyword is provided and other parameters are valid
• "SerpData API error": Usually indicates API key issues or rate limits

License

MIT License - see LICENSE file for details.

Support

• Contact: [email protected]
• SerpData API Documentation: serpdata.io/docs
• MCP Documentation: modelcontextprotocol.io