competitor_research
Identify organic competitors for any domain to analyze market positioning and inform SEO strategy.
Instructions
Find organic competitors for a domain
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| domain | Yes | ||
| database | No | ||
| limit | No |
Implementation Reference
- src/index.ts:290-298 (handler)Implements the handler logic for the 'competitor_research' tool by parsing input arguments using the schema and calling the Semrush API 'domain_organic_competitors' endpoint to fetch organic competitors data for the given domain.
case 'competitor_research': { const { domain, database, limit } = CompetitorResearchSchema.parse(args); data = await callSemrushAPI('domain_organic_competitors', { domain, database, display_limit: limit, export_columns: 'Dn,Cr,Np,Or,Ot,Oc,Ad,At,Ac', }); break; - src/index.ts:84-88 (schema)Zod schema defining the input structure for the 'competitor_research' tool, including required domain and optional database and limit parameters.
const CompetitorResearchSchema = 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 competitors'), }); - src/index.ts:210-218 (registration)Registers the 'competitor_research' tool in the MCP server's listTools response, specifying its name, description, and referencing the input schema.
{ name: 'competitor_research', description: 'Find organic competitors for a domain', inputSchema: { type: 'object', properties: CompetitorResearchSchema.shape, required: ['domain'], }, },