SEO Review Tools - MCP server

Instructions

Implementation Reference

• tools/seo-api-workspace/seo-ap-is-seo-review-tools/get-keyword-statistics.js:10-49 (handler)

  The handler function `executeFunction` that implements the core logic: constructs and sends a POST request to the SEO Review Tools API for keyword statistics, handles response and errors.

  const executeFunction = async ({ keywords, hl = 'English', location = 'United States' }) => {
    const baseUrl = 'https://api.seoreviewtools.com/keyword-statistics/';
    const token = process.env.SEO_API_WORKSPACE_API_KEY;
  
    try {
      // Construct the request body
      const body = JSON.stringify({ keywords });
  
      // Set up headers for the request
      const headers = {
        'Content-Type': 'application/json',
        'X-API-Key': token
      };
  
      // Construct the URL with query parameters
      const url = new URL(baseUrl);
      url.searchParams.append('hl', hl);
      url.searchParams.append('location', location);
  
      // Perform the fetch request
      const response = await fetch(url.toString(), {
        method: 'POST',
        headers,
        body
      });
  
      // 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 keyword statistics:', error);
      return { error: 'An error occurred while getting keyword statistics.' };
    }
  };

• tools/seo-api-workspace/seo-ap-is-seo-review-tools/get-keyword-statistics.js:62-82 (schema)

  The JSON schema defining the tool's input parameters: required 'keywords' array, optional 'hl' and 'location' strings.

  parameters: {
    type: 'object',
    properties: {
      keywords: {
        type: 'array',
        items: {
          type: 'string'
        },
        description: 'The keywords to get statistics for.'
      },
      hl: {
        type: 'string',
        description: 'The language for the response.'
      },
      location: {
        type: 'string',
        description: 'The location for the keyword statistics.'
      }
    },
    required: ['keywords']
  }

• tools/seo-api-workspace/seo-ap-is-seo-review-tools/get-keyword-statistics.js:55-87 (registration)

  The `apiTool` export containing the handler reference, tool name, description, and schema; loaded dynamically by `discoverTools()`.

  const apiTool = {
    function: executeFunction,
    definition: {
      type: 'function',
      function: {
        name: 'get_keyword_statistics',
        description: 'Get keyword statistics from SEO Review Tools.',
        parameters: {
          type: 'object',
          properties: {
            keywords: {
              type: 'array',
              items: {
                type: 'string'
              },
              description: 'The keywords to get statistics for.'
            },
            hl: {
              type: 'string',
              description: 'The language for the response.'
            },
            location: {
              type: 'string',
              description: 'The location for the keyword statistics.'
            }
          },
          required: ['keywords']
        }
      }
    }
  };
  
  export { apiTool };

• tools/paths.js:1-10 (registration)

  The `toolPaths` array includes the path to this tool's module, used by `discoverTools()` to dynamically import it.

  export const toolPaths = [
    'seo-api-workspace/seo-ap-is-seo-review-tools/get-website-traffic.js',
    'seo-api-workspace/seo-ap-is-seo-review-tools/get-authority.js',
    'seo-api-workspace/seo-ap-is-seo-review-tools/get-serp.js',
    'seo-api-workspace/seo-ap-is-seo-review-tools/post-bulk-website-traffic.js',
    'seo-api-workspace/seo-ap-is-seo-review-tools/get-backlinks.js',
    'seo-api-workspace/seo-ap-is-seo-review-tools/get-seo-content-score.js',
    'seo-api-workspace/seo-ap-is-seo-review-tools/get-keyword-statistics.js',
    'seo-api-workspace/seo-ap-is-seo-review-tools/get-keyword-suggestions.js'
  ];

• lib/tools.js:7-16 (registration)

  The `discoverTools()` function dynamically imports all tools from `toolPaths`, including this one, and extracts the `apiTool` for registration in the MCP server.

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