Website Intelligence Provider

API TypeScript independiente para auditorías deterministas de inteligencia web. Recibe una URL y genera hallazgos en inglés o español mediante fixtures incluidos.

API TypeScript independiente para auditorías deterministas de inteligencia web. Recibe una URL y genera hallazgos en inglés o español mediante fixtures incluidos.

Red deshabilitada por defecto: el servicio nunca contacta la URL proporcionada. Los hosts desconocidos fallan de forma segura con FIXTURE_NOT_FOUND. La respuesta de auditoría registra network.attempted: false y network.allowed: false.

Red deshabilitada por defecto: el servicio nunca contacta la URL recibida. Los hosts desconocidos fallan de forma segura con FIXTURE_NOT_FOUND.

Despliegue público

• GitHub: https://github.com/CaBsCrypto/website-intelligence-provider

• Despliegue de producción estable: https://website-intelligence-provider.vercel.app

El proyecto de Vercel es independiente y usa las funciones en api/. vercel.json mapea las rutas públicas a esas funciones. No depende de Stellar Bazaar ni contiene credenciales o automatizaciones de Bazaar.

El proyecto de Vercel es independiente y usa las funciones en api/. No depende de Stellar Bazaar ni contiene credenciales o automatizaciones de Bazaar.

Related MCP server: web-audit-mcp

Requisitos

• Node.js 22.18 o superior

• npm 10 o superior

• Sin dependencias de producción

Desarrollo local

npm install
npm test
npm start

El servidor escucha en 127.0.0.1:8787 por defecto. Usa PORT para cambiarlo.

El servidor escucha en 127.0.0.1:8787 por defecto. Usa PORT para cambiarlo.

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

API HTTP

Solicitud:

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

language es opcional y su valor predeterminado es en. Los valores admitidos son en y es.

Contrato MCP por stdio

npm run mcp

El proceso lee un mensaje JSON-RPC por línea. Admite initialize, tools/list y tools/call. La herramienta audit_website acepta la misma url y el language opcional, devolviendo tanto el contenido de texto MCP como structuredContent.

El proceso lee un mensaje JSON-RPC por línea. Admite initialize, tools/list y tools/call. La herramienta audit_website usa el mismo input y devuelve texto MCP y structuredContent.

Fixtures y determinismo

Hosts incluidos:

• example.com

• www.example.com

• stellar.local

• demo.stellar.local

La misma versión del proveedor y el mismo input normalizado siempre producen la misma puntuación y hallazgos. La salida excluye marcas de tiempo, estado de DNS, estado HTTP en vivo, contenido derivado del entorno, secretos, wallets y datos de pago.

La misma versión e input normalizado siempre generan la misma puntuación y hallazgos. La salida excluye fechas, DNS, estado HTTP real, contenido dependiente del entorno, secretos, wallets y datos de pago.

Desplegar como proyecto separado

Con una CLI de Vercel autenticada:

vercel --yes
vercel --prod --yes

Vercel compila las funciones serverless TypeScript en api/ usando las rutas explícitas en vercel.json. No se versiona ningún directorio de build. .vercelignore excluye cachés locales, archivos de trabajo, salida de compilación, credenciales y archivos de entorno de las subidas de despliegue.

Vercel detecta automáticamente las funciones TypeScript en api/. No se versiona ningún directorio de build.

Versionado

La API HTTP y el esquema de salida usan la versión principal v1 / 1.0. Los cambios de respuesta que rompen la compatibilidad requieren una nueva ruta y versión de esquema. SERVICE_CARD.v1.json se verifica mediante pruebas contra la Service Card en tiempo de ejecución.

Seguridad y alcance

• No existe ningún cliente HTTP saliente en la ruta de auditoría.

• Se rechazan las credenciales en URLs y los protocolos que no sean HTTP(S).

• Los hosts desconocidos nunca se consultan.

• No se usan secretos, tokens, datos de pago ni funcionalidad de wallets.

• Este proyecto es independiente: no publica ni modifica Stellar Bazaar ni ningún otro proveedor.

Licencia

Apache-2.0. Consulta LICENSE.