DataForSEO MCP Server

- AI_OPTIMIZATION API: provides data for keyword discovery, conversational optimization, and real-time LLM benchmarking;
- SERP API: real-time Search Engine Results Page (SERP) data for Google, Bing, and Yahoo;
- KEYWORDS_DATA API: keyword research and clickstream data, including search volume, cost-per-click, and other metrics;
- ONPAGE API: allows crawling websites and webpages according to customizable parameters to obtain on-page SEO performance metrics;
- DATAFORSEO LABS API: data on keywords, SERPs, and domains based on DataForSEO's in-house databases and proprietary algorithms;
- BACKLINKS API: comprehensive backlink analysis including referring domains, anchor text distribution, and link quality metrics;
- BUSINESS DATA API: publicly available data on any business entity;
- DOMAIN ANALYTICS API: data on website traffic, technologies, and Whois details;
- CONTENT ANALYSIS API: robust source of data for brand monitoring, sentiment analysis, and citation management;
- MERCHANT API: provides essential data and metrics for comprehensive competitor analysis, price monitoring, and market research across Google Shopping, Amazon etc.

Here's how to add a new tool to any new or pre-existing module:

// src/code/modules/your-module/tools/your-tool.tool.ts
import { BaseTool } from '../../base.tool';
import { DataForSEOClient } from '../../../client/dataforseo.client';
import { z } from 'zod';
export class YourTool extends BaseTool {

  constructor(private client: DataForSEOClient) {

    super(client);

    // DataForSEO API returns extensive data with many fields, which can be overwhelming

    // for AI agents to process. We select only the most relevant fields to ensure

    // efficient and focused responses.

    this.fields = [

      'title',           // Example: Include the title field

      'description',     // Example: Include the description field

      'url',            // Example: Include the URL field

      // Add more fields as needed

    ];

  }
getName() {

    return 'your-tool-name';

  }
getDescription() {

    return 'Description of what your tool does';

  }
getParams(): z.ZodRawShape {

    return {

      // Required parameters

      keyword: z.string().describe('The keyword to search for'),

      location: z.string().describe('Location in format "City,Region,Country" or just "Country"'),

      

      // Optional parameters

      fields: z.array(z.string()).optional().describe('Specific fields to return in the response. If not specified, all fields will be returned'),

      language: z.string().optional().describe('Language code (e.g., "en")'),

    };

  }
async handle(params: any) {

    try {

      // Make the API call

      const response = await this.client.makeRequest({

        endpoint: '/v3/dataforseo_endpoint_path',

        method: 'POST',

        body: [{

          // Your request parameters

          keyword: params.keyword,

          location: params.location,

          language: params.language,

        }],

      });
// Validate the response for errors

      this.validateResponse(response);
//if the main data array is specified in tasks[0].result[:] field

      const result = this.handleDirectResult(response);

      //if main data array specified in tasks[0].result[0].items field

      const result = this.handleItemsResult(response);

      // Format and return the response

      return this.formatResponse(result);

    } catch (error) {

      // Handle and format any errors

      return this.formatErrorResponse(error);

    }

  }

}