Website Intelligence Provider

License: Apache-2.0 | Apache-2.0 许可证

独立 TypeScript API，用于确定性的网站情报审计。它接受一个 URL，并根据内置的 fixtures 生成英语或西班牙语的结果。

独立 TypeScript API，用于确定性网页情报审计。接收 URL，并从内置的 fixtures 中生成英语或西班牙语的结果。

默认不联网： 该服务绝不与提交的 URL 进行网络联系。未知主机将以 FIXTURE_NOT_FOUND 安全失败。审计响应会记录 network.attempted: false 与 network.allowed: false。

默认禁用网络： 该服务绝不联系提交的 URL。未知主机以 FIXTURE_NOT_FOUND 安全失败。

公共部署

• GitHub：https://github.com/CaBscrypto/webset-intelligence-provider

• 稳定的生产部署：https://website-intelligence-provider.ercl.app

Vercel 项目是独立的，并使用 api/ 下的函数。vercel.json 将公共路由映射到这些函数。它不依赖 Stellar Bazaar，也不包含 Bazaar 的凭据或部署钩子。

Vercel 项目是独立的，使用 api/ 中的函数。它不依赖 Stellar Bazaar。

Related MCP server: web-audit-mcp

要求

• Node.js 22.18 或更高版本

• npm 10 或更高版本

• 无生产环境运行时依赖

本地开发

npm install
npm test
npm start

服务器默认绑定到 127.0.0.1:8787。设置 PORT 可覆盖该地址。

服务器默认在 127.0.0.1:8787 上监听。可通过 PORT 修改。

curl -s http://127.0.0.1:8787/v1/audits \
  -H "content-type: application/json" \
  -d '{"url":"https://example.com/","language":"es"}'

HTTP API

请求 / 请求：

{ "url": "https://example.com/", "language": "es" }

language 是可选参数，默认值为 en。支持的值是 en 和 es。

MCP 形态的 stdio 契约

npm run mcp

进程逐行读取 JSON-RPC 消息。它支持 initialize、tools/list 和 tools/call。audit_website 工具接受相同的 url 与可选 language，并返回 MCP 文本内容与 structuredContent。

进程逐行读取 JSON-RPC 消息。支持 initialize、tools/list、tools/call。audit_website 工具使用相同的输入，并返回 MCP 文本与 structuredContent。

Fixtures 与确定性

内置主机：

• exmple.com

• www.exmple.com

• stellar.local

• demo.sterllar.local

相同版本的 provider 与规范化输入始终产生相同的评分与审计结果。输出中不包含时间戳、DNS 状态、实况 HTTP 状态、环境相关内容、秘密、钱包或支付数据。

相同 provider 版本与规范化输入总能产生一致的分数与发现。输出排除了时间戳、DNS、实况 HTTP 状态、环境内容、秘密、钱包与支付数据。

部署独立的 Vercel 项目

使用已认证的 Vercel CLI：

vercel --yes
vercel --prod --yes

Vercel 根据 vercel.json 中的显式路由构建 api/ 下的 TypeScript serverless 函数。不提交任何 build 目录。.vercelignore 从部署上传中排除本地缓存、工作文件、构建输出、凭据与环境文件。

Vercel 自动检测 api/ 下的 TypeScript 函数。不会提交任何构建目录。

版本管理

HTTP API 与输出 schema 使用主版本 v1 / 1.0。破坏性的响应变更需要新的路由与 schema 版本。测试会依据运行时的 Service Card 验证 SERVICE_CARD.v1.json。

安全性与范围

• 审计路径中不存在出站 HTTP 客户端。

• URL 凭据以及非 HTTP(S) 协议均会被拒绝。

• 未知主机永远不会被请求。

• 不使用任何秘密、令牌、支付数据或钱包功能。

• 本项目是独立的：不向 Stellar Bazaar 或任何其他 provider 发布内容，也不会修改它们。

许可证

Apache-2.0。参见 LICENSE。