Semrush MCP Server

Instructions

Implementation Reference

• src/index.ts:301-309 (handler)

  Handler logic for the 'domain_adwords' tool: parses input arguments using the schema and calls the Semrush API with appropriate parameters to fetch paid search keywords data.

  case 'domain_adwords': {
    const { domain, database, limit } = DomainAdwordsSchema.parse(args);
    data = await callSemrushAPI('domain_adwords', {
      domain,
      database,
      display_limit: limit,
      export_columns: 'Ph,Po,Pp,Pd,Nq,Cp,Ur,Tr,Tc,Co,Nr,Td,Avg,Sym,Sp',
    });
    break;

• src/index.ts:90-94 (schema)

  Zod schema defining the input parameters for the domain_adwords tool: domain (required), database (default 'us'), and limit (default 10).

  const DomainAdwordsSchema = z.object({
    domain: z.string().describe('Domain to analyze'),
    database: z.string().default('us').describe('Database code'),
    limit: z.coerce.number().default(10).describe('Number of results'),
  });

• src/index.ts:219-227 (registration)

  Tool registration in the ListTools response, specifying name, description, and inputSchema based on DomainAdwordsSchema.

  {
    name: 'domain_adwords',
    description: 'Get paid search (Google Ads) keywords for a domain',
    inputSchema: {
      type: 'object',
      properties: DomainAdwordsSchema.shape,
      required: ['domain'],
    },
  },