get_domain_emails
Extract email addresses from a specified domain using selected search engines and country filters for precise data retrieval.
Instructions
Retrieve emails from a given domain
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| country | No | The country to search from. Default: us | us |
| domain | Yes | The domain to search emails from | |
| pages_number | No | The number of pages to search (1-30). Default: 1 | |
| search_engine | No | The search engine to use (google, bing, yahoo, duckduckgo). Default: google |
Implementation Reference
- index.js:620-621 (handler)Handler for the get_domain_emails tool. It calls the makeRequest helper to fetch emails from the FetchSERP API endpoint '/api/v1/domain_emails' using the provided arguments.case 'get_domain_emails': return await this.makeRequest('/api/v1/domain_emails', 'GET', args, null, token);
- index.js:74-100 (schema)Input schema for the get_domain_emails tool, defining parameters like domain (required), search_engine, country, and pages_number.inputSchema: { type: 'object', properties: { domain: { type: 'string', description: 'The domain to search emails from', }, search_engine: { type: 'string', description: 'The search engine to use (google, bing, yahoo, duckduckgo). Default: google', default: 'google', }, country: { type: 'string', description: 'The country to search from. Default: us', default: 'us', }, pages_number: { type: 'integer', description: 'The number of pages to search (1-30). Default: 1', default: 1, minimum: 1, maximum: 30, }, }, required: ['domain'], },
- index.js:71-101 (registration)Registration of the get_domain_emails tool in the ListTools response, including name, description, and input schema.{ name: 'get_domain_emails', description: 'Retrieve emails from a given domain', inputSchema: { type: 'object', properties: { domain: { type: 'string', description: 'The domain to search emails from', }, search_engine: { type: 'string', description: 'The search engine to use (google, bing, yahoo, duckduckgo). Default: google', default: 'google', }, country: { type: 'string', description: 'The country to search from. Default: us', default: 'us', }, pages_number: { type: 'integer', description: 'The number of pages to search (1-30). Default: 1', default: 1, minimum: 1, maximum: 30, }, }, required: ['domain'], }, },
- index.js:565-613 (helper)Shared helper function makeRequest used by the get_domain_emails 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(); }