BuiltWith

Consulte a API BuiltWith para descobrir as pilhas de tecnologia de sites. Requer uma chave de API BuiltWith.

GitHub
2
Experimente este MCPPatrocinado

Documentação

MseeP.ai Security Assessment Badge

Servidor MCP BuiltWith

Um servidor Model Context Protocol (MCP) que fornece ferramentas para consultar a API BuiltWith e obter informações sobre as pilhas de tecnologia de sites. Este servidor pode ser usado com qualquer assistente de IA que suporte o Model Context Protocol.

GitHub Contact

Recursos

  • Consulta de Domínio: Obtenha informações detalhadas sobre as tecnologias usadas por um domínio específico
  • Busca de Tecnologia: Encontre domínios na web que usam uma tecnologia específica, por meio da API de Listas do BuiltWith
  • Categorização de Tecnologia: Visualize tecnologias agrupadas por categorias (Analytics, CMS, Frameworks, etc.)
  • Informações Detalhadas: Acesse descrições, datas de detecção e links para cada tecnologia

Pré-requisitos

  • Node.js 20 ou superior
  • Uma chave de API BuiltWith (obtenha uma em BuiltWith API)

Instalação

  1. Clone este repositório:

    git clone https://github.com/Cyreslab-AI/builtwith-mcp-server.git
cd builtwith-mcp-server

  2. Instale as dependências:

    npm install

  3. Compile o projeto:

    npm run build

Configuração

O servidor requer uma chave de API BuiltWith para funcionar. Você pode fornecê-la por meio de variáveis de ambiente ao executar o servidor ou adicionando-a à configuração de configurações do seu MCP.

Execução Direta

Você pode executar o servidor diretamente com a chave de API como uma variável de ambiente:

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

Configuração de Configurações MCP

Adicione o servidor ao arquivo de configurações do seu cliente MCP. A localização exata depende de qual assistente de IA compatível com MCP você está usando.

Configuração MCP Genérica

A maioria dos clientes MCP segue um padrão de configuração semelhante:

{
  "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": []
    }
  }
}

Configuração 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

Depois que o servidor estiver configurado e em execução, você pode usá-lo com qualquer assistente de IA compatível com MCP para consultar pilhas de tecnologia de sites.

Exemplos de Consultas

Com seu assistente de IA compatível com MCP, você pode fazer perguntas como:

  • "Quais tecnologias o example.com usa?"
  • "Mostre-me a pilha de tecnologia do github.com"
  • "Quais ferramentas de análise o amazon.com usa?"
  • "Quais frameworks são usados pelo netflix.com?"
  • "O wordpress.com está usando alguma tecnologia de e-commerce?"
  • "Encontre sites que usam Shopify"
  • "Quais sites na Austrália usam Google Analytics e Optimizely?"

Uso Programático

Para desenvolvedores que desejam integrar diretamente com o servidor:

O servidor se comunica usando o Model Context Protocol via stdio. Você também pode usar o cliente de API diretamente em suas aplicações 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);

Ferramentas Disponíveis

O servidor fornece as seguintes ferramentas:

domain_lookup

Obtenha informações sobre a pilha de tecnologia de um domínio específico. Usa a consulta gratuita do BuiltWith por padrão, ou a Domain API paga (atualmente v25) quando detailed está definido.

Parâmetros:

  • domain (obrigatório): Domínio a ser analisado (ex.: example.com)
  • detailed (opcional): Se deve retornar informações detalhadas (booleano)
  • noMeta (opcional): Quando detailed for verdadeiro, exclui metadados (nome da empresa, endereço, etc.) para reduzir o tamanho/custo da resposta (booleano)
  • noPii (opcional): Quando detailed for verdadeiro, remove nomes/e-mails pessoais da resposta (booleano)
  • hideText (opcional): Quando detailed for verdadeiro, oculta campos de descrição, link, tag e categoria da tecnologia para reduzir o tamanho/custo da resposta (booleano)

technology_search

Encontre domínios que usam uma tecnologia específica, por meio da Lists API do BuiltWith. Isso chama o endpoint real de Listas do BuiltWith e suporta paginação para grandes conjuntos de resultados.

Observação: a Lists API é cobrada pela mesma chave de API BuiltWith que a Domain API, mas requer um plano que inclua créditos de lista (nível Pro ou superior). Chamá-la com uma chave que não tenha esse acesso retorna um erro claro de autorização/atualização do próprio BuiltWith, exibido como a mensagem de erro da ferramenta.

Parâmetros:

  • technology (obrigatório): Nome da tecnologia a ser pesquisada (ex.: "Shopify", "Google Analytics")
  • otherTechnologies (opcional): Nomes adicionais de tecnologias que os sites correspondentes também devem usar, máximo 16 (matriz de strings)
  • country (opcional): Código(s) de país ISO 3166-1 alpha-2 para filtrar, separados por vírgula para múltiplos, ex.: "US" ou "AU,NZ" (string)
  • since (opcional): Incluir apenas sites ativos detectados usando a tecnologia desde esta data ou frase, ex.: "2016-01-20" ou "30 Dias Atrás" (string)
  • includeMeta (opcional): Incluir metadados (nome da empresa, localização, contatos, redes sociais, etc.) para cada domínio correspondente (booleano)
  • offset (opcional): Cursor de paginação - passe o valor nextOffset de uma resposta anterior para buscar a próxima página (string)
  • limit (opcional): Número máximo de resultados a retornar da página buscada; não solicita páginas adicionais (número)

Desenvolvimento

Executando em Modo de Desenvolvimento

npm run dev

Estrutura do Projeto

  • src/index.ts: Ponto de entrada principal do servidor
  • src/api-client.ts: Cliente da API BuiltWith
  • src/handlers/: Manipuladores de requisições
  • src/types.ts: Definições de tipos

Contribuindo

Contribuições são bem-vindas! Veja como você pode contribuir:

  1. Faça um fork do repositório
  2. Crie um branch de recurso: git checkout -b feature/your-feature-name
  3. Faça commit das suas alterações: git commit -am 'Add some feature'
  4. Envie para o branch: git push origin feature/your-feature-name
  5. Envie um pull request

Para mudanças significativas, abra uma issue primeiro para discutir o que você gostaria de alterar.

Suporte

Se você encontrar problemas ou tiver dúvidas, por favor:

Licença

Licença MIT

Copyright (c) 2025 Cyreslab-AI

A permissão é concedida, gratuitamente, a qualquer pessoa que obtenha uma cópia deste software e dos arquivos de documentação associados (o "Software"), para lidar com o Software sem restrições, incluindo, sem limitação, os direitos de usar, copiar, modificar, mesclar, publicar, distribuir, sublicenciar e/ou vender cópias do Software, e permitir que as pessoas a quem o Software é fornecido o façam, sujeito às seguintes condições:

O aviso de direitos autorais acima e este aviso de permissão devem ser incluídos em todas as cópias ou partes substanciais do Software.

O SOFTWARE É FORNECIDO "NO ESTADO EM QUE SE ENCONTRA", SEM GARANTIA DE QUALQUER TIPO, EXPRESSA OU IMPLÍCITA, INCLUINDO, MAS NÃO SE LIMITANDO ÀS GARANTIAS DE COMERCIABILIDADE, ADEQUAÇÃO A UM DETERMINADO FIM E NÃO VIOLAÇÃO. EM NENHUM CASO OS AUTORES OU DETENTORES DE DIREITOS AUTORAIS SERÃO RESPONSÁVEIS POR QUALQUER REIVINDICAÇÃO, DANOS OU OUTRA RESPONSABILIDADE, SEJA EM AÇÃO DE CONTRATO, ATO ILÍCITO OU OUTRA FORMA, DECORRENTE DE, FORA OU EM CONEXÃO COM O SOFTWARE OU O USO OU OUTRAS NEGOCIAÇÕES NO SOFTWARE.