mcp-serp-brief

> From Artur Ferreira at The GEO Lab — where every content brief is tested against real citation data before the methodology is published.

MCP server that generates SERP-targeted content briefs using DataForSEO and Claude AI. Analyzes search engine results and produces actionable content strategies for writers and SEO professionals.

• SERP Analysis — Real-time search results analysis with featured snippets, People Also Ask, and answer box detection
• AI-Powered Briefs — Claude generates comprehensive content strategies based on SERP competitiveness
• Customizable Output — Target length (short/medium/long) and tone (professional/casual/technical)
• Structured Data — JSON-formatted SERP insights including top domains, rank positions, and content types

npm install

Create a .env file in the project root:

DATAFORSEO_LOGIN=your_dataforseo_email
DATAFORSEO_PASSWORD=your_dataforseo_password
ANTHROPIC_API_KEY=your_anthropic_api_key

Required credentials:

• DataForSEO: Email and password from api.dataforseo.com
• Anthropic: API key from console.anthropic.com

npm start

The server will start on stdio and be available to MCP clients.

Analyzes search engine results for a given keyword.

Parameters:

• keyword (required) — The search term to analyze
• location_name (optional, default: "United States") — Geographic location for results
• language_code (optional, default: "en") — Language code (e.g., "en", "de", "fr")
• depth (optional, default: 10) — Number of results (10-100)

Example:

{
  "keyword": "sustainable packaging materials",
  "location_name": "United Kingdom",
  "language_code": "en",
  "depth": 20
}

Response includes:

• Top 5 ranking domains with title