BuiltWith MCP Server

BuiltWith MCP Server

一个 Model Context Protocol（MCP）服务，提供用于查询 BuiltWith API 的工具，以获取网站技术栈信息。此服务可与任何支持 Model Context Protocol 的 AI 助手配合使用。

功能

• 域名查询：获取特定域名所用技术的详细信息
• 技术搜索：通过 BuiltWith Lists API，查找整个 Web 上使用特定技术的域名
• 技术分类：按类别查看技术（分析、CMS、框架等）
• 详细信息：查看每项技术的描述、检测日期和链接

前置条件

• Node.js 20 或更高版本
• BuiltWith API 密钥（可在 BuiltWith API 获取）

安装

1. 克隆此仓库：

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

2. 安装依赖项：

   npm install
   

3. 构建项目：

   npm run build
   

配置

服务需要 BuiltWith API 密钥才能运行。运行服务时，可通过环境变量提供密钥，也可以将其添加到 MCP 设置配置中。

直接运行

可将 API 密钥作为环境变量，直接运行服务：

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

MCP 设置配置

将服务添加到 MCP 客户端的设置文件中。具体位置取决于你使用的 MCP 兼容 AI 助手。

通用 MCP 配置

大多数 MCP 客户端采用类似的配置模式：

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

Claude 专用配置

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

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

使用方法

配置并运行服务后，你可以使用任何 MCP 兼容 AI 助手查询网站技术栈。

查询示例

使用 MCP 兼容 AI 助手，你可以询问：

• “example.com 使用了哪些技术？”
• “显示 github.com 的技术栈”
• “amazon.com 使用了哪些分析工具？”
• “netflix.com 使用了哪些框架？”
• “wordpress.com 是否使用了任何电子商务技术？”
• “查找使用 Shopify 的网站”
• “澳大利亚有哪些网站使用 Google Analytics 和 Optimizely？”

编程方式使用

对于希望直接与服务集成的开发者：

服务通过 stdio 使用 Model Context Protocol 进行通信。你也可以在 Node.js 应用中直接使用 API 客户端：

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);

可用工具

该服务提供以下工具：

domain_lookup

获取特定域名的技术栈信息。默认使用免费的 BuiltWith 查询；设置 detailed 时，则使用付费的 Domain API（当前为 v25）。

参数：

• domain（必填）：要分析的域名（例如，example.com）
• detailed（可选）：是否返回详细信息（布尔值）
• noMeta（可选）：当 detailed 为 true 时，排除元数据（公司名称、地址等），以减小响应体积／费用（布尔值）
• noPii（可选）：当 detailed 为 true 时，从响应中移除个人姓名／电子邮件（布尔值）
• hideText（可选）：当 detailed 为 true 时，隐藏技术描述、链接、标签和类别字段，以减小响应体积／费用（布尔值）

technology_search

通过 BuiltWith Lists API 查找使用特定技术的域名。此工具调用 BuiltWith 的真实 Lists 端点，并支持对大型结果集进行分页。

注意：Lists API 使用与 Domain API 相同的 BuiltWith API 密钥计费，但需要包含列表额度的套餐（Pro 级或更高）。使用不具备此权限的密钥调用时，BuiltWith 本身会返回明确的授权／升级错误，并将其作为工具的错误消息显示。

参数：

• technology（必填）：要搜索的技术名称（例如，“Shopify”、“Google Analytics”）
• otherTechnologies（可选）：匹配的网站还必须使用的其他技术名称，最多 16 个（字符串数组）
• country（可选）：用于筛选的 ISO 3166-1 alpha-2 国家／地区代码；多个代码以逗号分隔，例如“US”或“AU,NZ”（字符串）
• since（可选）：仅包含自此日期或时间段以来检测到使用该技术的在线网站，例如“2016-01-20”或“30 Days Ago”（字符串）
• includeMeta（可选）：为每个匹配的域名包含元数据（公司名称、位置、联系人、社交信息等）（布尔值）
• offset（可选）：分页游标——传入先前响应中的 nextOffset 值以获取下一页（字符串）
• limit（可选）：从获取的页面中返回的最大结果数；不会请求其他页面（数字）

开发

在开发模式下运行

npm run dev

项目结构

• src/index.ts：主服务入口点
• src/api-client.ts：BuiltWith API 客户端
• src/handlers/：请求处理程序
• src/types.ts：类型定义

贡献

欢迎贡献！以下是参与贡献的方式：

1. Fork 此仓库
2. 创建功能分支：git checkout -b feature/your-feature-name
3. 提交更改：git commit -am 'Add some feature'
4. 将更改推送到分支：git push origin feature/your-feature-name
5. 提交拉取请求

如需进行重大更改，请先创建 issue，讨论您想要进行的更改。

支持

如果您遇到问题或有疑问，请：

• 在 GitHub 上创建 issue
• 通过 [email protected] 联系我们

许可证

MIT 许可证

版权所有 (c) 2025 Cyreslab-AI

特此免费授予任何获得本软件及相关文档文件（“软件”）副本的人不受限制地处理本软件的权利，包括但不限于使用、复制、修改、合并、发布、分发、再许可和／或销售本软件副本的权利，并允许获得本软件的人这样做，但须符合以下条件：

上述版权声明和本许可声明应包含在本软件的所有副本或实质性部分中。

本软件按“原样”提供，不附带任何明示或暗示的保证，包括但不限于适销性、特定用途适用性和非侵权性的保证。在任何情况下，作者或版权持有人均不对因本软件或本软件的使用或其他交易而产生、引起或与之相关的任何索赔、损害或其他责任负责，无论是在合同诉讼、侵权诉讼还是其他诉讼中。