DataForSEO MCP Server

Instructions

Implementation Reference

• src/core/modules/backlinks/tools/backlinks-timeseries-summary.tool.ts:59-71 (handler)

  The core handler method that performs the API request to DataForSEO's backlinks timeseries summary endpoint and processes the response.

  async handle(params: any): Promise<any> {
    try {
      const response = await this.client.makeRequest('/v3/backlinks/timeseries_summary/live', 'POST', [{
        target: params.target,
        date_from: params.date_from,
        date_to: params.date_to,
        group_range: params.group_range
      }]);
      return this.validateAndFormatResponse(response);
    } catch (error) {
      return this.formatErrorResponse(error);
    }
  }

• src/core/modules/backlinks/tools/backlinks-timeseries-summary.tool.ts:19-57 (schema)

  Zod schema definition for the tool's input parameters: target (required), date_from, date_to, group_range.

    getParams(): z.ZodRawShape {
      return {
        target: z.string().describe(`domain to get data for
  required field
  a domain should be specified without https:// and www.
  example:
  "forbes.com"`),
        date_from: z.string().describe(`starting date of the time range
  optional field
  this field indicates the date which will be used as a threshold for summary data;
  minimum value: 2019-01-30
  maximum value shouldn’t exceed the date specified in the date_to
  date format: "yyyy-mm-dd"
  example:
  "2021-01-01"`).optional(),
        date_to: z.string().describe(`ending date of the time range
  optional field
  if you don’t specify this field, the today’s date will be used by default
  minimum value shouldn’t preceed the date specified in the date_from
  maximum value: today’s date
  date format: "yyyy-mm-dd"
  example:
  "2021-01-15"`).optional(),
          group_range: z.string().optional().describe(`time range which will be used to group the results
  optional field
  default value: month
  possible values: day, week, month, year
  note: for day, we will return items corresponding to all dates between and including date_from and date_to;
  for week/month/year, we will return items corresponding to full weeks/months/years, where each item will indicate the last day of the week/month/year
  
  for example, if you specify:
  "group_range": "month",
  "date_from": "2022-03-23",
  "date_to": "2022-05-13"
  we will return items falling between 2022-03-01 and 2022-05-31, namely, three items corresponding to the following dates: 2022-03-31, 2022-04-30, 2022-05-31
  
  if there is no data for a certain day/week/month/year, we will return 0`).default('month')
      };
    }

• src/core/modules/backlinks/backlinks-api.module.ts:29-62 (registration)

  The BacklinksTimeseriesSummaryTool is instantiated and registered in the getTools() method of BacklinksApiModule, added to the tools array and mapped to its name with description, params, and handler.

  getTools(): Record<string, ToolDefinition> {
    const tools = [
      new BacklinksTool(this.dataForSEOClient),
      new BacklinksAnchorTool(this.dataForSEOClient),
      new BacklinksBulkBacklinksTool(this.dataForSEOClient),
      new BacklinksBulkNewLostReferringDomainsTool(this.dataForSEOClient),
      new BacklinksBulkNewLostBacklinksTool(this.dataForSEOClient),
      new BacklinksBulkRanksTool(this.dataForSEOClient),
      new BacklinksBulkReferringDomainsTool(this.dataForSEOClient),
      new BacklinksBulkSpamScoreTool(this.dataForSEOClient),
      new BacklinksCompetitorsTool(this.dataForSEOClient),
      new BacklinksDomainIntersectionTool(this.dataForSEOClient),
      new BacklinksDomainPagesSummaryTool(this.dataForSEOClient),
      new BacklinksDomainPagesTool(this.dataForSEOClient),
      new BacklinksPageIntersectionTool(this.dataForSEOClient),
      new BacklinksReferringDomainsTool(this.dataForSEOClient),
      new BacklinksReferringNetworksTool(this.dataForSEOClient),
      new BacklinksSummaryTool(this.dataForSEOClient),
      new BacklinksTimeseriesNewLostSummaryTool(this.dataForSEOClient),
      new BacklinksTimeseriesSummaryTool(this.dataForSEOClient),
      new BacklinksBulkPagesSummaryTool(this.dataForSEOClient),
      new BacklinksFiltersTool(this.dataForSEOClient)
      // Add more tools here
    ];
  
    return tools.reduce((acc, tool) => ({
      ...acc,
      [tool.getName()]: {
        description: tool.getDescription(),
        params: tool.getParams(),
        handler: (params: any) => tool.handle(params),
      },
    }), {});
  }

• src/core/modules/backlinks/backlinks-api.module.ts:22-22 (registration)

  Import statement for the BacklinksTimeseriesSummaryTool class.

  import { BacklinksTimeseriesSummaryTool } from './tools/backlinks-timeseries-summary.tool.js';