get_backlinks
Retrieve backlink data for any URL to analyze referring domains and inbound links for SEO assessment.
Instructions
Get backlinks for a specified URL.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | Yes | The URL for which to retrieve backlinks. | |
| unique_domains | No | Whether to return unique domains (1 for yes, 0 for no). |
Implementation Reference
- 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.' }; } }; - 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, }; });