get_long_tail_keywords
Generate long-tail keywords from a seed keyword to enhance SEO targeting. Specify search intent and quantity for precise results.
Instructions
Generate long-tail keywords for a given keyword
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| count | No | The number of long-tail keywords to generate (1-500). Default: 10 | |
| keyword | Yes | The seed keyword to generate long-tail keywords from | |
| search_intent | No | The search intent (informational, commercial, transactional, navigational). Default: informational | informational |
Implementation Reference
- index.js:157-182 (registration)Registration of the get_long_tail_keywords tool in the ListTools response, including name, description, and inputSchema definition.
{ name: 'get_long_tail_keywords', description: 'Generate long-tail keywords for a given keyword', inputSchema: { type: 'object', properties: { keyword: { type: 'string', description: 'The seed keyword to generate long-tail keywords from', }, search_intent: { type: 'string', description: 'The search intent (informational, commercial, transactional, navigational). Default: informational', default: 'informational', }, count: { type: 'integer', description: 'The number of long-tail keywords to generate (1-500). Default: 10', default: 10, minimum: 1, maximum: 500, }, }, required: ['keyword'], }, }, - index.js:632-633 (handler)Handler implementation for get_long_tail_keywords tool. Proxies the tool call to the FetchSERP API endpoint /api/v1/long_tail_keywords_generator using a GET request with the provided arguments.
case 'get_long_tail_keywords': return await this.makeRequest('/api/v1/long_tail_keywords_generator', 'GET', args, null, token); - index.js:565-613 (helper)Shared helper method makeRequest used by the tool handler to perform authenticated HTTP requests to the FetchSERP API.
async makeRequest(endpoint, method = 'GET', params = {}, body = null, token = null) { const fetchserpToken = token || process.env.FETCHSERP_API_TOKEN; if (!fetchserpToken) { throw new McpError( ErrorCode.InvalidRequest, 'FETCHSERP_API_TOKEN is required' ); } const url = new URL(`${API_BASE_URL}${endpoint}`); // Add query parameters for GET requests if (method === 'GET' && Object.keys(params).length > 0) { Object.entries(params).forEach(([key, value]) => { if (value !== undefined && value !== null) { if (Array.isArray(value)) { value.forEach(v => url.searchParams.append(`${key}[]`, v)); } else { url.searchParams.append(key, value.toString()); } } }); } const fetchOptions = { method, headers: { 'Authorization': `Bearer ${fetchserpToken}`, 'Content-Type': 'application/json', }, }; if (body && method !== 'GET') { fetchOptions.body = JSON.stringify(body); } const response = await fetch(url.toString(), fetchOptions); if (!response.ok) { const errorText = await response.text(); throw new McpError( ErrorCode.InternalError, `API request failed: ${response.status} ${response.statusText} - ${errorText}` ); } return await response.json(); }