Website Intelligence Provider

Unabhängige TypeScript-API für deterministische Website-Intelligence-Audits. Sie akzeptiert eine URL und erzeugt zweisprachige englische oder spanische Ergebnisse aus gebündelten Fixtures.

Unabhängige TypeScript-API für deterministische Website-Intelligence-Audits. Sie akzeptiert eine URL und erzeugt zweisprachige englische oder spanische Ergebnisse aus gebündelten Fixtures.

Kein Netzwerk standardmäßig: Der Dienst kontaktiert die übermittelte URL nie. Unbekannte Hosts schlagen fehl mit FIXTURE_NOT_FOUND. Die Audit-Antwort zeichnet network.attempted: false und network.allowed: false auf.

Standardmäßig deaktiviertes Netzwerk: Der Dienst kontaktiert die empfangene URL nie. Unbekannte Hosts schlagen sicher fehl mit FIXTURE_NOT_FOUND.

Öffentliche Bereitstellung / Öffentliche Bereitstellung

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

• Stabile Produktionsbereitstellung: https://website-intelligence-provider.vercel.app

Das Vercel-Projekt ist eigenständig und verwendet die Funktionen unter api/. vercel.json ordnet die öffentlichen Routen diesen Funktionen zu. Es hängt nicht von Stellar Bazaar ab und enthält keine Bazaar-Anmeldeinformationen oder Bereitstellungs-Hooks.

Das Vercel-Projekt ist eigenständig und verwendet die Funktionen unter api/. Es hängt nicht von Stellar Bazaar ab und enthält keine Bazaar-Anmeldeinformationen oder Automatisierungen von Bazaar.

Related MCP server: web-audit-mcp

Anforderungen / Anforderungen

• Node.js 22.18 oder neuer

• npm 10 oder neuer

• Keine Produktionslaufzeitabhängigkeiten / Keine Produktionslaufzeitabhängigkeiten

Lokale Entwicklung / Lokale Entwicklung

npm install
npm test
npm start

Der Server bindet standardmäßig an 127.0.0.1:8787. Setzen Sie PORT, um es zu überschreiben.

Der Server lauscht standardmäßig auf 127.0.0.1:8787. Verwenden Sie PORT, um es zu ändern.

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

HTTP API

Anfrage / Anfrage:

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

language ist optional und standardmäßig en. Unterstützte Werte sind en und es.

MCP-förmiger stdio-Vertrag / MCP-Vertrag über stdio

npm run mcp

Der Prozess liest eine JSON-RPC-Nachricht pro Zeile. Er unterstützt initialize, tools/list und tools/call. Das Tool audit_website akzeptiert dieselbe url und optionale language und gibt sowohl MCP-Textinhalt als auch structuredContent zurück.

Der Prozess liest eine JSON-RPC-Nachricht pro Zeile. Er unterstützt initialize, tools/list und tools/call. Das Tool audit_website verwendet denselben Input und gibt MCP-Text und structuredContent zurück.

Fixtures und Determinismus / Fixtures und Determinismus

Gebündelte Hosts:

• example.com

• www.example.com

• stellar.local

• demo.stellar.local

Dieselbe Anbieterversion und normalisierte Eingabe erzeugen immer dieselbe Punktzahl und dieselben Erkenntnisse. Die Ausgabe schließt Zeitstempel, DNS-Status, Live-HTTP-Status, umgebungsabhängige Inhalte, Geheimnisse, Wallets und Zahlungsdaten aus.

Dieselbe Version und normalisierte Eingabe erzeugen immer dieselbe Punktzahl und dieselben Erkenntnisse. Die Ausgabe schließt Daten, DNS, echten HTTP-Status, umgebungsabhängige Inhalte, Geheimnisse, Wallets und Zahlungsdaten aus.

Bereitstellen eines separaten Vercel-Projekts / Bereitstellen als separates Projekt

Mit einer authentifizierten Vercel-CLI:

vercel --yes
vercel --prod --yes

Vercel erstellt die TypeScript-Serverless-Funktionen in api/ unter Verwendung der expliziten Routen in vercel.json. Es wird kein Build-Verzeichnis eingecheckt. .vercelignore schließt lokale Caches, Arbeitsdateien, Build-Ausgabe, Anmeldeinformationen und Umgebungsdateien von Bereitstellungs-Uploads aus.

Vercel erkennt automatisch die TypeScript-Funktionen in api/. Es wird kein Build-Verzeichnis versioniert.

Versionierung

Die HTTP-API und das Ausgabeschema verwenden die Hauptversion v1 / 1.0. Bahnbrechende Antwortänderungen erfordern eine neue Route und Schema-Version. SERVICE_CARD.v1.json wird durch Tests gegen die Laufzeit-Service-Card verifiziert.

Sicherheit und Umfang / Sicherheit und Umfang

• Es existiert kein ausgehender HTTP-Client im Audit-Pfad.

• URL-Anmeldeinformationen und Nicht-HTTP(S)-Protokolle werden abgelehnt.

• Unbekannte Hosts werden nie abgerufen.

• Es werden keine Geheimnisse, Token, Zahlungsdaten oder Wallet-Funktionen verwendet.

• Dieses Projekt ist unabhängig: Es veröffentlicht nicht in Stellar Bazaar und ändert es nicht, noch irgendeinen anderen Anbieter.

Lizenz

Apache-2.0. Siehe LICENSE.