stackscan

StackScan MCP 服务

询问你的助手某个网站使用了什么技术，以及背后是哪家公司。

这是一个用于 StackScan 技术查询 API 的 Model Context Protocol 服务。将 Claude、Cursor 或其他 MCP 客户端连接到它，即可询问：

example.com 是基于什么构建的？

vercel.com 背后是哪家公司？他们在哪里、属于什么行业？LinkedIn 页面是什么？

有多少个网站在使用 Klaviyo？这些网站分别位于哪些国家？

此服务经过设计，只提供只读功能。它不会向你的任何系统写入数据。

---

安装

你需要一个 StackScan 账户。登录后，在控制面板中打开 API Tokens，创建一个令牌，并从同一页面复制你的工作区 UUID。

Claude Desktop（扩展）

从发布页面下载 stackscan.mcpb，然后将其拖到 Settings > Extensions。它会要求你提供 API 令牌和工作区 ID，并自行完成其余安装步骤。

Claude Desktop（手动配置）

打开 Settings → Developer → Edit Config，然后添加：

{
  "mcpServers": {
    "stackscan": {
      "command": "npx",
      "args": ["-y", "@stackscan/mcp-server"],
      "env": {
        "STACKSCAN_API_TOKEN": "your-token",
        "STACKSCAN_TENANT_ID": "your-workspace-uuid"
      }
    }
  }
}

重启 Claude Desktop。工具会显示在连接器图标下方。

Claude Code

claude mcp add stackscan \
  --env STACKSCAN_API_TOKEN=your-token \
  --env STACKSCAN_TENANT_ID=your-workspace-uuid \
  -- npx -y @stackscan/mcp-server

Cursor、Windsurf 和其他客户端

配置格式相同：command: npx、args: ["-y", "@stackscan/mcp-server"]，以及两个环境变量。请查阅客户端自己的 MCP 文档，了解其配置文件的位置。

---

工具

工具	功能	费用
check_credits	剩余余额和本月额度	免费
lookup_company	域名背后的公司：名称、行业、城市、国家、LinkedIn 页面、预估营收范围	1 个点数
lookup_domain_technologies	单个域名使用的所有技术：每项技术的类别和全球使用情况（limit，默认值为 50，最大值为 100），以及付费（高级）产品数量和预估月度技术支出	1 个点数
lookup_technology	使用某项技术的网站数量及其所在地区	1 个点数
lookup_companies	最多 20 个域名背后的公司，以精简表格显示	每个有数据的域名 1 个点数
lookup_domains_technologies	最多 20 个域名使用的技术，以精简表格显示。可选的 category 筛选条件	每个有数据的域名 1 个点数

查询没有找到结果时，不会收费。check_credits 也不收费。

广度与深度

这里有两个技术查询工具，分别回答不同的问题。 lookup_domains_technologies 提供广度视图：查询多个域名，只返回技术名称，适合回答“这些网站中哪些使用了 Shopify？”这类问题。lookup_domain_technologies 提供深度视图：查询单个域名，返回每项技术及其类别和全球使用该技术的网站数量。批量工具会报告每个域名省略了多少项技术，让模型可以主动提出深入查询。

为什么批量工具最多处理 20 个域名

其背后的 REST 端点每次请求可接受 100 个域名，但这些工具刻意设置了更低的上限。工具结果会直接进入模型的上下文，而 100 条完整的公司数据会占用数万个 token，挤占你当前对话的空间；之后，模型还必须重新读取所有内容才能回答问题。20 行精简数据则是模型能够推理的表格规模。

此外，如果超过会话上限，工具会拒绝执行，而不是截断结果。它不会收费，并会告知你最多能查询多少个域名。悄悄丢弃部分域名，会返回看似完整、实际并不完整的答案。

如果你确实需要查询数百个域名，请使用 REST 端点。

---

配置

变量	必需	默认值	说明
STACKSCAN_API_TOKEN	是	无	控制面板 → API Tokens
STACKSCAN_TENANT_ID	是	无	你的工作区 UUID，位于同一页面
STACKSCAN_API_BASE	否	https://api.stackscan.com	极少需要设置
STACKSCAN_SESSION_LOOKUP_CAP	否	25	参见下文

会话上限是支出上限，这是刻意设计的

StackScan 自身的限制是速率限制：每分钟的请求数。它可以阻止突发请求，却无法阻止一个有耐心的 Agent 在一个下午里悄悄花光全部额度；而人类点击按钮不会遇到这种失控情况。

因此，此服务会自行计数：默认每个会话最多进行 25 次消耗额度的查询，超过后便会拒绝请求并说明原因。未命中和 check_credits 不计入上限，因为它们不会产生费用。每个成功结果都会附带页脚，显示剩余查询次数和最近一次获知的余额，这样模型就能控制查询节奏，而不必通过触及上限才发现限制。

如果你确实需要更高的上限，请主动调高（"STACKSCAN_SESSION_LOOKUP_CAP": "200"），而不是事后才发现。

---

开发

npm install
npm run build

test-stdio.mjs 是一个精简的 JSON-RPC 客户端，通过真实的 stdio 管道驱动此服务，因此无需 MCP 宿主即可进行测试：

export STACKSCAN_API_TOKEN=...
export STACKSCAN_TENANT_ID=...
node test-stdio.mjs check_credits lookup_company:stripe.com

切勿在此服务中写入 stdout。 stdout 是 JSON-RPC 通道；在其中写入任何其他内容都会破坏协议。诊断信息应写入 stderr。

---

源码阅读须知

上游 API 的三个特性影响了此代码，且很容易理解错：

未命中时返回 HTTP 200，而非 404。 对于“该域名没有数据”，API 会返回 200 {"success": false, "error": "No data available"}。如果客户端只相信状态码，就会读取缺失的负载并崩溃。所有响应都会经过同一个处理位置，以区分未命中和失败，因此只有真正的失败才会作为错误报告。

缓存的响应仍会收费。 API 的响应缓存保护的是其数据库，而不是你的钱包：在缓存有效期内重复查询，仍会消耗相同的额度。因此，每次命中时本地余额都会递减，而不会试图猜测哪些调用是免费的。

目前有两个有效的基础 URL。 API 的主地址是 api.stackscan.com/v1/...。较旧的 app.stackscan.com/api/v1/... 路径仍在提供服务，并且特意不进行重定向，因为重定向会丢弃 POST 请求的正文。如果你的配置仍使用旧主机，此服务会检测到这一点并继续使用旧路径格式，因此升级不会导致你无法使用。

隐私政策

StackScan 的隐私政策见 www.stackscan.com/privacy。以下是其中与此服务直接相关的内容：

收集哪些信息。 你查询的域名和技术名称会连同 API 令牌和工作区 ID，通过 HTTPS 发送到 api.stackscan.com。不会有其他信息离开你的设备。此服务不会读取文件、打开端口或保留本地存储；它唯一持有的状态是查询计数器和额度余额，两者都保存在内存中，并会在进程退出时消失。

信息的使用和存储方式。 查询记录会关联到你的工作区，以便统计额度并为账户提供支持。结果来自 StackScan 自有的爬取数据，而不是你发送的任何内容。

第三方。 查询词不会被出售，也不会被共享用于广告。它们只会到达 StackScan 所使用的基础设施提供商，如政策中“与服务提供商共享”一节所述，不会传到其他地方。

保留期限。 详见政策中的“数据保留”一节。删除账户后，与之关联的查询历史也会一并删除。

联系方式。 [email protected]，或 www.stackscan.com/contact。

链接

• API 参考
• 用简单的话来说，这是什么
• StackScan

许可证

MIT。详见 LICENSE。

此许可证仅适用于此客户端，大致就是这 500 行用于发起 HTTP 请求的代码。它访问的 StackScan 数据属于付费服务，不在此许可证的涵盖范围内。