SEO Review Tools - MCP server

Instructions

Implementation Reference

• tools/seo-api-workspace/seo-ap-is-seo-review-tools/get-backlinks.js:9-40 (handler)

  The executeFunction implements the core logic for fetching backlinks from the SEO Review Tools API using the provided URL and optional unique_domains parameter.

  const executeFunction = async ({ url, unique_domains = 1 }) => {
    const baseUrl = 'https://api.seoreviewtools.com/backlinks/';
    const apiKey = process.env.SEO_API_WORKSPACE_API_KEY;
    try {
      // Construct the URL with query parameters
      const urlWithParams = new URL(baseUrl);
      urlWithParams.searchParams.append('url', url);
      urlWithParams.searchParams.append('unique_domains', unique_domains.toString());
      urlWithParams.searchParams.append('key', apiKey);
  
      // Perform the fetch request
      const response = await fetch(urlWithParams.toString(), {
        method: 'GET',
        headers: {
          'Content-Type': 'application/json'
        }
      });
  
      // Check if the response was successful
      if (!response.ok) {
        const errorData = await response.json();
        throw new Error(errorData);
      }
  
      // Parse and return the response data
      const data = await response.json();
      return data;
    } catch (error) {
      console.error('Error getting backlinks:', error);
      return { error: 'An error occurred while getting backlinks.' };
    }
  };

• tools/seo-api-workspace/seo-ap-is-seo-review-tools/get-backlinks.js:51-67 (schema)

  The tool schema defining the name, description, parameters (url required, unique_domains optional), used for MCP tool registration.

    name: 'get_backlinks',
    description: 'Get backlinks for a specified URL.',
    parameters: {
      type: 'object',
      properties: {
        url: {
          type: 'string',
          description: 'The URL for which to retrieve backlinks.'
        },
        unique_domains: {
          type: 'integer',
          description: 'Whether to return unique domains (1 for yes, 0 for no).'
        }
      },
      required: ['url']
    }
  }

• tools/paths.js:6-6 (registration)

  The path to the get_backlinks tool implementation file is listed in toolPaths for dynamic discovery.

  'seo-api-workspace/seo-ap-is-seo-review-tools/get-backlinks.js',

• lib/tools.js:8-14 (registration)

  The discoverTools function dynamically imports each tool file (including get-backlinks.js) and extracts the apiTool object containing handler and schema for MCP server registration.

  const toolPromises = toolPaths.map(async (file) => {
    const module = await import(`../tools/${file}`);
    return {
      ...module.apiTool,
      path: file,
    };
  });