domain-search-mcp 1.0.0

package/examples/bulk-search-50-domains.ts

@@ -0,0 +1,131 @@
+/**
+ * Example: Bulk Search 50 Domains
+ *
+ * This example demonstrates the bulk_search tool for checking
+ * many domains at once efficiently.
+ */
+
+import { bulkSearch } from '../src/services/domain-search.js';
+
+// Sample domain names to check
+const DOMAIN_NAMES = [
+  'vibecoding',
+  'codevibes',
+  'devmagic',
+  'buildfast',
+  'shipit',
+  'hackflow',
+  'codealchemy',
+  'pixelperfect',
+  'bytesize',
+  'stackflow',
+  'gitflow',
+  'deployfast',
+  'cloudnine',
+  'serverless',
+  'microstack',
+  'apicraft',
+  'dataflow',
+  'mlops',
+  'aicraft',
+  'neuralnet',
+  'tensorflow',
+  'deeplearn',
+  'automate',
+  'botcraft',
+  'chatops',
+  'devtools',
+  'codebase',
+  'repocraft',
+  'gitmagic',
+  'versionctl',
+  'cicdpipe',
+  'testcraft',
+  'debugflow',
+  'logstream',
+  'metrics',
+  'dashcraft',
+  'uimagic',
+  'csscraft',
+  'reactflow',
+  'vuemagic',
+  'sveltekit',
+  'nextcraft',
+  'nuxtmagic',
+  'astrosite',
+  'remixapp',
+  'solidstart',
+  'qwiksite',
+  'htmxcraft',
+  'alpinejs',
+  'tailwindui',
+];
+
+async function main() {
+  console.log('Domain Search MCP - Bulk Search Example\n');
+  console.log('=======================================\n');
+
+  console.log(`Checking ${DOMAIN_NAMES.length} domains across .io TLD...\n`);
+
+  try {
+    const startTime = Date.now();
+    const result = await bulkSearch(DOMAIN_NAMES, 'io');
+    const duration = Date.now() - startTime;
+
+    // Display summary
+    console.log('Summary:');
+    console.log('--------');
+    console.log(`Total checked: ${result.summary.total}`);
+    console.log(`Available: ${result.summary.available}`);
+    console.log(`Taken: ${result.summary.taken}`);
+    console.log(`Errors: ${result.summary.errors}`);
+    console.log(`Duration: ${duration}ms\n`);
+
+    // Display available domains
+    const available = result.results.filter((r) => r.available);
+    if (available.length > 0) {
+      console.log('Available Domains:');
+      console.log('------------------');
+      for (const domain of available.slice(0, 10)) {
+        const price = domain.price_first_year
+          ? `$${domain.price_first_year}/year`
+          : 'Price unknown';
+        console.log(`  ${domain.domain} - ${price}`);
+      }
+      if (available.length > 10) {
+        console.log(`  ... and ${available.length - 10} more`);
+      }
+    }
+
+    // Display taken domains
+    const taken = result.results.filter((r) => !r.available && !r.error);
+    if (taken.length > 0) {
+      console.log('\nTaken Domains:');
+      console.log('--------------');
+      for (const domain of taken.slice(0, 5)) {
+        console.log(`  ${domain.domain}`);
+      }
+      if (taken.length > 5) {
+        console.log(`  ... and ${taken.length - 5} more`);
+      }
+    }
+
+    // Display insights
+    console.log('\nInsights:');
+    console.log('---------');
+    for (const insight of result.insights) {
+      console.log(insight);
+    }
+
+    // Display next steps
+    console.log('\nNext Steps:');
+    console.log('-----------');
+    for (const step of result.next_steps) {
+      console.log(`- ${step}`);
+    }
+  } catch (error) {
+    console.error('Error:', error instanceof Error ? error.message : error);
+  }
+}
+
+main();

package/examples/cli-interactive.ts

@@ -0,0 +1,280 @@
+/**
+ * Example: Interactive CLI
+ *
+ * This example demonstrates an interactive command-line interface
+ * for domain searching using readline.
+ */
+
+import * as readline from 'readline';
+import {
+  searchDomain,
+  bulkSearch,
+  compareRegistrars,
+  suggestDomains,
+  getTldInfo,
+  checkSocials,
+} from '../src/services/domain-search.js';
+
+const rl = readline.createInterface({
+  input: process.stdin,
+  output: process.stdout,
+});
+
+function prompt(question: string): Promise<string> {
+  return new Promise((resolve) => {
+    rl.question(question, (answer) => {
+      resolve(answer.trim());
+    });
+  });
+}
+
+function printHelp() {
+  console.log(`
+Available Commands:
+-------------------
+  search <name> [tlds]     - Search domain across TLDs (default: com,io,dev)
+  bulk <names> [tld]       - Check multiple names (comma-separated)
+  compare <name> <tld>     - Compare registrar prices
+  suggest <name> [tld]     - Get available variations
+  tld <tld>                - Get TLD information
+  socials <name>           - Check social media availability
+  help                     - Show this help
+  quit                     - Exit
+
+Examples:
+  search vibecoding
+  search vibecoding com,io,dev,app
+  bulk vibecoding,coolapp,mysite io
+  compare vibecoding com
+  suggest vibecoding com
+  tld dev
+  socials vibecoding
+`);
+}
+
+async function handleSearch(args: string[]) {
+  const name = args[0];
+  const tlds = args[1]?.split(',') || ['com', 'io', 'dev'];
+
+  if (!name) {
+    console.log('Usage: search <name> [tlds]');
+    return;
+  }
+
+  console.log(`\nSearching for ${name} across ${tlds.join(', ')}...\n`);
+
+  try {
+    const result = await searchDomain(name, tlds);
+
+    for (const domain of result.results) {
+      const status = domain.available ? 'Available' : 'Taken';
+      const price = domain.price_first_year
+        ? `$${domain.price_first_year}/year`
+        : '';
+      console.log(`  ${domain.domain}: ${status} ${price}`);
+    }
+
+    console.log('\nInsights:');
+    for (const insight of result.insights) {
+      console.log(`  ${insight}`);
+    }
+  } catch (error) {
+    console.error('Error:', error instanceof Error ? error.message : error);
+  }
+}
+
+async function handleBulk(args: string[]) {
+  const names = args[0]?.split(',') || [];
+  const tld = args[1] || 'com';
+
+  if (names.length === 0) {
+    console.log('Usage: bulk <names> [tld]');
+    return;
+  }
+
+  console.log(`\nChecking ${names.length} names for .${tld}...\n`);
+
+  try {
+    const result = await bulkSearch(names, tld);
+
+    console.log(`Available: ${result.summary.available}/${result.summary.total}`);
+
+    const available = result.results.filter((r) => r.available);
+    if (available.length > 0) {
+      console.log('\nAvailable:');
+      for (const d of available) {
+        const price = d.price_first_year ? `$${d.price_first_year}/year` : '';
+        console.log(`  ${d.domain} ${price}`);
+      }
+    }
+  } catch (error) {
+    console.error('Error:', error instanceof Error ? error.message : error);
+  }
+}
+
+async function handleCompare(args: string[]) {
+  const name = args[0];
+  const tld = args[1] || 'com';
+
+  if (!name) {
+    console.log('Usage: compare <name> <tld>');
+    return;
+  }
+
+  console.log(`\nComparing prices for ${name}.${tld}...\n`);
+
+  try {
+    const result = await compareRegistrars(name, tld);
+
+    for (const price of result.prices) {
+      const first = price.price_first_year ? `$${price.price_first_year}` : 'N/A';
+      console.log(`  ${price.registrar}: ${first}/year`);
+    }
+
+    if (result.recommendation) {
+      console.log(`\nRecommendation: ${result.recommendation}`);
+    }
+  } catch (error) {
+    console.error('Error:', error instanceof Error ? error.message : error);
+  }
+}
+
+async function handleSuggest(args: string[]) {
+  const name = args[0];
+  const tld = args[1] || 'com';
+
+  if (!name) {
+    console.log('Usage: suggest <name> [tld]');
+    return;
+  }
+
+  console.log(`\nGetting suggestions for ${name}.${tld}...\n`);
+
+  try {
+    const result = await suggestDomains(name, tld, 10);
+
+    const available = result.suggestions.filter((s) => s.available);
+    console.log(`Found ${available.length} available variations:\n`);
+
+    for (const s of available.slice(0, 10)) {
+      const price = s.price_first_year ? `$${s.price_first_year}/year` : '';
+      console.log(`  ${s.domain} ${price}`);
+    }
+  } catch (error) {
+    console.error('Error:', error instanceof Error ? error.message : error);
+  }
+}
+
+async function handleTld(args: string[]) {
+  const tld = args[0];
+
+  if (!tld) {
+    console.log('Usage: tld <tld>');
+    return;
+  }
+
+  console.log(`\nGetting info for .${tld}...\n`);
+
+  try {
+    const result = await getTldInfo(tld);
+
+    console.log(`  TLD: .${result.tld}`);
+    console.log(`  Category: ${result.category}`);
+    console.log(`  Description: ${result.description}`);
+    console.log(`  Popularity: ${result.popularity}`);
+
+    if (result.price_range) {
+      console.log(
+        `  Price Range: $${result.price_range.min} - $${result.price_range.max}/year`,
+      );
+    }
+
+    if (result.restrictions.length > 0) {
+      console.log(`  Restrictions: ${result.restrictions.join(', ')}`);
+    }
+
+    if (result.recommendation) {
+      console.log(`\n  Recommendation: ${result.recommendation}`);
+    }
+  } catch (error) {
+    console.error('Error:', error instanceof Error ? error.message : error);
+  }
+}
+
+async function handleSocials(args: string[]) {
+  const name = args[0];
+
+  if (!name) {
+    console.log('Usage: socials <name>');
+    return;
+  }
+
+  console.log(`\nChecking social media for "${name}"...\n`);
+
+  try {
+    const result = await checkSocials(name);
+
+    for (const platform of result.results) {
+      const status = platform.available ? 'Available' : 'Taken';
+      const confidence =
+        platform.confidence === 'high'
+          ? ''
+          : ` (${platform.confidence} confidence)`;
+      console.log(`  ${platform.platform}: ${status}${confidence}`);
+    }
+
+    console.log('\nInsights:');
+    for (const insight of result.insights) {
+      console.log(`  ${insight}`);
+    }
+  } catch (error) {
+    console.error('Error:', error instanceof Error ? error.message : error);
+  }
+}
+
+async function main() {
+  console.log('Domain Search MCP - Interactive CLI\n');
+  console.log('====================================\n');
+  console.log('Type "help" for available commands, "quit" to exit.\n');
+
+  while (true) {
+    const input = await prompt('\ndomain> ');
+
+    if (!input) continue;
+
+    const [command, ...args] = input.split(' ');
+
+    switch (command.toLowerCase()) {
+      case 'search':
+        await handleSearch(args);
+        break;
+      case 'bulk':
+        await handleBulk(args);
+        break;
+      case 'compare':
+        await handleCompare(args);
+        break;
+      case 'suggest':
+        await handleSuggest(args);
+        break;
+      case 'tld':
+        await handleTld(args);
+        break;
+      case 'socials':
+        await handleSocials(args);
+        break;
+      case 'help':
+        printHelp();
+        break;
+      case 'quit':
+      case 'exit':
+        console.log('\nGoodbye!');
+        rl.close();
+        process.exit(0);
+      default:
+        console.log(`Unknown command: ${command}. Type "help" for available commands.`);
+    }
+  }
+}
+
+main();

package/examples/compare-registrars.ts

@@ -0,0 +1,78 @@
+/**
+ * Example: Compare Registrar Pricing
+ *
+ * This example demonstrates comparing prices across different
+ * registrars to find the best deal for a domain.
+ */
+
+import { compareRegistrars } from '../src/services/domain-search.js';
+
+async function main() {
+  console.log('Domain Search MCP - Compare Registrars Example\n');
+  console.log('===============================================\n');
+
+  const domains = [
+    { name: 'vibecoding', tld: 'com' },
+    { name: 'myawesomeapp', tld: 'io' },
+    { name: 'coolstartup', tld: 'dev' },
+  ];
+
+  for (const { name, tld } of domains) {
+    console.log(`\nComparing prices for ${name}.${tld}:`);
+    console.log('-'.repeat(40));
+
+    try {
+      const result = await compareRegistrars(name, tld);
+
+      // Show what happened
+      console.log(`Status: ${result.what_happened}`);
+
+      // Display prices from each registrar
+      console.log('\nPrices by Registrar:');
+      for (const price of result.prices) {
+        const firstYear = price.price_first_year
+          ? `$${price.price_first_year}`
+          : 'N/A';
+        const renewal = price.price_renewal ? `$${price.price_renewal}` : 'N/A';
+        const privacy = price.privacy_included ? '(privacy included)' : '';
+
+        console.log(`  ${price.registrar}:`);
+        console.log(`    First year: ${firstYear} ${privacy}`);
+        console.log(`    Renewal: ${renewal}`);
+      }
+
+      // Show best options
+      if (result.best_first_year) {
+        console.log(
+          `\n Best first year: ${result.best_first_year.registrar} at $${result.best_first_year.price}`,
+        );
+      }
+      if (result.best_renewal) {
+        console.log(
+          ` Best renewal: ${result.best_renewal.registrar} at $${result.best_renewal.price}`,
+        );
+      }
+
+      // Show recommendation
+      console.log(`\nRecommendation: ${result.recommendation}`);
+
+      // Show insights
+      if (result.insights.length > 0) {
+        console.log('\nInsights:');
+        for (const insight of result.insights) {
+          console.log(`  ${insight}`);
+        }
+      }
+    } catch (error) {
+      console.error(
+        `Error checking ${name}.${tld}:`,
+        error instanceof Error ? error.message : error,
+      );
+    }
+  }
+
+  console.log('\n' + '='.repeat(40));
+  console.log('Comparison complete!');
+}
+
+main();

package/examples/search-single-domain.ts

@@ -0,0 +1,54 @@
+/**
+ * Example: Search for a Single Domain
+ *
+ * This example demonstrates the basic usage of the search_domain tool.
+ * It checks availability across multiple TLDs and shows pricing.
+ */
+
+import { searchDomain } from '../src/services/domain-search.js';
+
+async function main() {
+  console.log('Domain Search MCP - Single Domain Example\n');
+  console.log('==========================================\n');
+
+  // Search for a domain across default TLDs (com, io, dev)
+  console.log('Searching for "vibecoding" across .com, .io, .dev...\n');
+
+  try {
+    const result = await searchDomain('vibecoding');
+
+    // Display results
+    console.log('Results:');
+    console.log('--------');
+
+    for (const domain of result.results) {
+      const status = domain.available ? '✅ Available' : '❌ Taken';
+      const price = domain.price_first_year
+        ? `$${domain.price_first_year}/year`
+        : 'Price unknown';
+      const privacy = domain.privacy_included ? '(privacy included)' : '';
+
+      console.log(`${domain.domain}: ${status} - ${price} ${privacy}`);
+    }
+
+    // Display insights
+    console.log('\nInsights:');
+    console.log('---------');
+    for (const insight of result.insights) {
+      console.log(insight);
+    }
+
+    // Display next steps
+    console.log('\nNext Steps:');
+    console.log('-----------');
+    for (const step of result.next_steps) {
+      console.log(`• ${step}`);
+    }
+
+    console.log(`\n(Completed in ${result.duration_ms}ms)`);
+  } catch (error) {
+    console.error('Error:', error instanceof Error ? error.message : error);
+  }
+}
+
+main();

package/examples/suggest-names.ts

@@ -0,0 +1,110 @@
+/**
+ * Example: Domain Name Suggestions
+ *
+ * This example demonstrates getting available domain variations
+ * when your preferred domain name is taken.
+ */
+
+import { suggestDomains } from '../src/services/domain-search.js';
+
+async function main() {
+  console.log('Domain Search MCP - Domain Suggestions Example\n');
+  console.log('===============================================\n');
+
+  const baseNames = ['vibecoding', 'coolapp', 'techstart'];
+
+  for (const baseName of baseNames) {
+    console.log(`\nSuggestions for "${baseName}":`);
+    console.log('-'.repeat(40));
+
+    try {
+      // Get suggestions for .com
+      const result = await suggestDomains(baseName, 'com', 10);
+
+      console.log(`Original: ${baseName}.com`);
+      console.log(`Strategy: ${result.strategy}\n`);
+
+      // Display suggestions grouped by type
+      const prefixed = result.suggestions.filter((s) =>
+        s.domain.startsWith('get') ||
+        s.domain.startsWith('try') ||
+        s.domain.startsWith('use') ||
+        s.domain.startsWith('my')
+      );
+
+      const suffixed = result.suggestions.filter((s) =>
+        s.domain.includes('app') ||
+        s.domain.includes('hq') ||
+        s.domain.includes('io') ||
+        s.domain.includes('now')
+      );
+
+      const others = result.suggestions.filter(
+        (s) => !prefixed.includes(s) && !suffixed.includes(s),
+      );
+
+      if (prefixed.length > 0) {
+        console.log('With Prefix:');
+        for (const s of prefixed.slice(0, 3)) {
+          const price = s.price_first_year
+            ? `$${s.price_first_year}/year`
+            : 'Price unknown';
+          const status = s.available ? 'Available' : 'Taken';
+          console.log(`  ${s.domain} - ${status} - ${price}`);
+        }
+      }
+
+      if (suffixed.length > 0) {
+        console.log('\nWith Suffix:');
+        for (const s of suffixed.slice(0, 3)) {
+          const price = s.price_first_year
+            ? `$${s.price_first_year}/year`
+            : 'Price unknown';
+          const status = s.available ? 'Available' : 'Taken';
+          console.log(`  ${s.domain} - ${status} - ${price}`);
+        }
+      }
+
+      if (others.length > 0) {
+        console.log('\nOther Variations:');
+        for (const s of others.slice(0, 3)) {
+          const price = s.price_first_year
+            ? `$${s.price_first_year}/year`
+            : 'Price unknown';
+          const status = s.available ? 'Available' : 'Taken';
+          console.log(`  ${s.domain} - ${status} - ${price}`);
+        }
+      }
+
+      // Summary
+      const availableCount = result.suggestions.filter((s) => s.available).length;
+      console.log(`\nFound ${availableCount} available out of ${result.suggestions.length} checked`);
+
+      // Insights
+      if (result.insights.length > 0) {
+        console.log('\nInsights:');
+        for (const insight of result.insights) {
+          console.log(`  ${insight}`);
+        }
+      }
+
+      // Next steps
+      if (result.next_steps.length > 0) {
+        console.log('\nNext Steps:');
+        for (const step of result.next_steps) {
+          console.log(`  - ${step}`);
+        }
+      }
+    } catch (error) {
+      console.error(
+        `Error getting suggestions for ${baseName}:`,
+        error instanceof Error ? error.message : error,
+      );
+    }
+  }
+
+  console.log('\n' + '='.repeat(40));
+  console.log('Suggestions complete!');
+}
+
+main();

package/glama.json

@@ -0,0 +1,6 @@
+{
+  "$schema": "https://glama.ai/mcp/schemas/server.json",
+  "maintainers": ["dorukardahan"],
+  "name": "Domain Search MCP",
+  "description": "Check domain availability and pricing across multiple registrars (Porkbun, Namecheap, RDAP, WHOIS) in real-time. Includes social handle checking for 10 platforms."
+}

package/jest.config.js

@@ -0,0 +1,35 @@
+/** @type {import('ts-jest').JestConfigWithTsJest} */
+module.exports = {
+  preset: 'ts-jest',
+  testEnvironment: 'node',
+  roots: ['<rootDir>/tests'],
+  testMatch: ['**/*.test.ts'],
+  collectCoverageFrom: [
+    'src/**/*.ts',
+    '!src/**/*.d.ts',
+  ],
+  coverageDirectory: 'coverage',
+  coverageReporters: ['text', 'lcov', 'html'],
+  coverageThreshold: {
+    global: {
+      branches: 60,
+      functions: 60,
+      lines: 60,
+      statements: 60,
+    },
+  },
+  moduleNameMapper: {
+    '^(\\.{1,2}/.*)\\.js$': '$1', // Handle .js extensions
+  },
+  transform: {
+    '^.+\\.tsx?$': [
+      'ts-jest',
+      {
+        useESM: false,
+        isolatedModules: true,
+      },
+    ],
+  },
+  verbose: true,
+  testTimeout: 10000,
+};