BuiltWith

Consulta la API de BuiltWith para descubrir las pilas tecnológicas de sitios web. Requiere una clave de API de BuiltWith.

Documentación

MseeP.ai Security Assessment Badge

Servidor MCP de BuiltWith

Un servidor de Model Context Protocol (MCP) que proporciona herramientas para consultar la API de BuiltWith y obtener información sobre las pilas tecnológicas de sitios web. Este servidor puede utilizarse con cualquier asistente de IA que admita el Model Context Protocol.

GitHub Contact

Características

  • Búsqueda de dominio: Obtén información detallada sobre las tecnologías utilizadas por un dominio específico
  • Búsqueda de tecnología: Encuentra dominios en la web que utilizan una tecnología específica, mediante la API de Listas de BuiltWith
  • Categorización de tecnologías: Visualiza tecnologías agrupadas por categorías (Analítica, CMS, Frameworks, etc.)
  • Información detallada: Accede a descripciones, fechas de detección y enlaces para cada tecnología

Requisitos previos

  • Node.js 20 o superior
  • Una clave de API de BuiltWith (obtén una en API de BuiltWith)

Instalación

  1. Clona este repositorio:

    git clone https://github.com/Cyreslab-AI/builtwith-mcp-server.git
    cd builtwith-mcp-server
    
  2. Instala las dependencias:

    npm install
    
  3. Compila el proyecto:

    npm run build
    

Configuración

El servidor requiere una clave de API de BuiltWith para funcionar. Puedes proporcionarla mediante variables de entorno al ejecutar el servidor o añadiéndola a tu configuración de ajustes de MCP.

Ejecución directa

Puedes ejecutar el servidor directamente con la clave de API como variable de entorno:

BUILTWITH_API_KEY=your-api-key-here node build/index.js

Configuración de ajustes de MCP

Añade el servidor al archivo de ajustes de tu cliente MCP. La ubicación exacta depende del asistente de IA compatible con MCP que estés utilizando.

Configuración genérica de MCP

La mayoría de los clientes MCP siguen un patrón de configuración similar:

{
  "mcpServers": {
    "builtwith": {
      "command": "node",
      "args": ["/absolute/path/to/builtwith-mcp-server/build/index.js"],
      "env": {
        "BUILTWITH_API_KEY": "your-api-key-here"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Configuración específica para Claude

Para Claude Desktop:

// ~/Library/Application Support/Claude/claude_desktop_config.json (macOS)
// %APPDATA%\Claude\claude_desktop_config.json (Windows)
{
  "mcpServers": {
    "builtwith": {
      "command": "node",
      "args": ["/path/to/builtwith-mcp-server/build/index.js"],
      "env": {
        "BUILTWITH_API_KEY": "your-api-key-here"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Para Claude Developer Tools:

// ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json (macOS)
// %APPDATA%\Code\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json (Windows)
{
  "mcpServers": {
    "builtwith": {
      "command": "node",
      "args": ["/path/to/builtwith-mcp-server/build/index.js"],
      "env": {
        "BUILTWITH_API_KEY": "your-api-key-here"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Uso

Una vez que el servidor esté configurado y en ejecución, puedes utilizarlo con cualquier asistente de IA compatible con MCP para consultar pilas tecnológicas de sitios web.

Ejemplos de consultas

Con tu asistente de IA compatible con MCP, puedes hacer preguntas como:

  • "¿Qué tecnologías utiliza example.com?"
  • "Muéstrame la pila tecnológica de github.com"
  • "¿Qué herramientas de analítica utiliza amazon.com?"
  • "¿Qué frameworks utiliza netflix.com?"
  • "¿Está wordpress.com usando tecnologías de comercio electrónico?"
  • "Encuentra sitios que usen Shopify"
  • "¿Qué sitios en Australia usan Google Analytics y Optimizely?"

Uso programático

Para desarrolladores que quieran integrarse directamente con el servidor:

El servidor se comunica mediante el Model Context Protocol a través de stdio. También puedes utilizar el cliente de API directamente en tus aplicaciones Node.js:

import { BuiltWithApiClient } from "./src/api-client.js";

const client = new BuiltWithApiClient({
  apiKey: "your-api-key-here",
});

const result = await client.getDomainInfo("example.com");
console.log(result);

Herramientas disponibles

El servidor proporciona las siguientes herramientas:

domain_lookup

Obtén información sobre la pila tecnológica de un dominio específico. Utiliza la búsqueda gratuita de BuiltWith por defecto, o la API de Dominio de pago (actualmente v25) cuando detailed esté configurado.

Parámetros:

  • domain (obligatorio): Dominio a analizar (p. ej., example.com)
  • detailed (opcional): Si se debe devolver información detallada (booleano)
  • noMeta (opcional): Cuando detailed sea verdadero, excluir metadatos (nombre de empresa, dirección, etc.) para reducir el tamaño/coste de la respuesta (booleano)
  • noPii (opcional): Cuando detailed sea verdadero, eliminar nombres/emails personales de la respuesta (booleano)
  • hideText (opcional): Cuando detailed sea verdadero, ocultar los campos de descripción, enlace, etiqueta y categoría de la tecnología para reducir el tamaño/coste de la respuesta (booleano)

technology_search

Encuentra dominios que utilizan una tecnología específica, mediante la API de Listas de BuiltWith. Esto llama al endpoint real de Listas de BuiltWith y admite paginación para conjuntos de resultados grandes.

Nota: la API de Listas se factura con la misma clave de API de BuiltWith que la API de Dominio, pero requiere un plan que incluya créditos de listas (nivel Pro o superior). Llamarla con una clave que no tenga ese acceso devuelve un error claro de autorización/actualización de BuiltWith, que se muestra como mensaje de error de la herramienta.

Parámetros:

  • technology (obligatorio): Nombre de la tecnología a buscar (p. ej., "Shopify", "Google Analytics")
  • otherTechnologies (opcional): Nombres de tecnologías adicionales que los sitios coincidentes también deben usar, máximo 16 (matriz de cadenas)
  • country (opcional): Código(s) de país ISO 3166-1 alfa-2 para filtrar, separados por comas para varios, p. ej., "US" o "AU,NZ" (cadena)
  • since (opcional): Incluir solo sitios activos detectados usando la tecnología desde esta fecha o frase, p. ej., "2016-01-20" o "30 Days Ago" (cadena)
  • includeMeta (opcional): Incluir metadatos (nombre de empresa, ubicación, contactos, redes sociales, etc.) para cada dominio coincidente (booleano)
  • offset (opcional): Cursor de paginación: pasa el valor de nextOffset de una respuesta anterior para obtener la siguiente página (cadena)
  • limit (opcional): Número máximo de resultados a devolver de la página obtenida; no solicita páginas adicionales (número)

Desarrollo

Ejecución en modo de desarrollo

npm run dev

Estructura del proyecto

  • src/index.ts: Punto de entrada principal del servidor
  • src/api-client.ts: Cliente de la API de BuiltWith
  • src/handlers/: Manejadores de solicitudes
  • src/types.ts: Definiciones de tipos

Contribuciones

¡Las contribuciones son bienvenidas! Así es como puedes contribuir:

  1. Haz un fork del repositorio
  2. Crea una rama de funcionalidad: git checkout -b feature/your-feature-name
  3. Haz commit de tus cambios: git commit -am 'Add some feature'
  4. Sube a la rama: git push origin feature/your-feature-name
  5. Envía una solicitud de extracción (pull request)

Para cambios importantes, abre primero un issue para discutir lo que te gustaría cambiar.

Soporte

Si encuentras algún problema o tienes preguntas, por favor:

Licencia

Licencia MIT

Copyright (c) 2025 Cyreslab-AI

Se concede permiso, de forma gratuita, a cualquier persona que obtenga una copia de este software y los archivos de documentación asociados (el "Software"), para tratar con el Software sin restricciones, incluidos, sin limitación, los derechos de usar, copiar, modificar, fusionar, publicar, distribuir, sublicenciar y/o vender copias del Software, y para permitir a las personas a quienes se les proporcione el Software que hagan lo mismo, sujeto a las siguientes condiciones:

El aviso de copyright anterior y este aviso de permiso deberán incluirse en todas las copias o partes sustanciales del Software.

EL SOFTWARE SE PROPORCIONA "TAL CUAL", SIN GARANTÍA DE NINGÚN TIPO, EXPRESA O IMPLÍCITA, INCLUIDAS PERO NO LIMITADAS A LAS GARANTÍAS DE COMERCIABILIDAD, IDONEIDAD PARA UN FIN PARTICULAR Y NO INFRACCIÓN. EN NINGÚN CASO LOS AUTORES O TITULARES DE LOS DERECHOS DE AUTOR SERÁN RESPONSABLES DE CUALQUIER RECLAMO, DAÑO U OTRA RESPONSABILIDAD, YA SEA EN UNA ACCIÓN DE CONTRATO, AGRAVIO O DE OTRO MODO, QUE SURJA DE, O EN CONEXIÓN CON EL SOFTWARE O EL USO U OTROS TRATOS EN EL SOFTWARE.