Semrush MCP Server

Instructions

Implementation Reference

• src/index.ts:280-287 (handler)

  Handler case for 'backlinks_overview' tool within the CallToolRequestSchema handler: parses input using BacklinksOverviewSchema, calls Semrush API 'backlinks_overview' endpoint with target, target_type, and specific export_columns via analytics v1.

  case 'backlinks_overview': {
    const { target, target_type } = BacklinksOverviewSchema.parse(args);
    data = await callSemrushAPI('backlinks_overview', { 
      target,
      target_type,
      export_columns: 'ascore,total,domains_num,urls_num,ips_num,ipclassc_num,follows_num,nofollows_num,sponsored_num,ugc_num,texts_num,images_num,forms_num,frames_num',
    }, true); // Pass true for isAnalyticsV1
    break;

• src/index.ts:79-82 (schema)

  Zod input schema for backlinks_overview tool, defining 'target' as string and 'target_type' as enum with default 'root_domain'.

  const BacklinksOverviewSchema = z.object({
    target: z.string().describe('Domain to analyze'),
    target_type: z.enum(['root_domain', 'domain', 'url']).default('root_domain').describe('Type of target: root_domain, domain (for subdomains), or url'),
  });

• src/index.ts:202-209 (registration)

  Registration of 'backlinks_overview' tool in the ListToolsRequestSchema response, including name, description, and inputSchema based on BacklinksOverviewSchema.

    name: 'backlinks_overview',
    description: 'Get backlinks overview for a domain or URL. Target type can be root_domain, domain, or url.',
    inputSchema: {
      type: 'object',
      properties: BacklinksOverviewSchema.shape,
      required: ['target', 'target_type'],
    },
  },