Website Intelligence Provider

Независимый TypeScript API для детерминированных аудитов веб-интеллекта. Принимает URL и формирует результаты на английском или испанском языке на основе встроенных фикстур.

Независимый TypeScript API для детерминированных аудитов веб-интеллекта. Принимает URL и формирует результаты на английском или испанском языке с помощью встроенных фикстур.

По умолчанию без сети: сервис никогда не обращается к переданному URL. Неизвестные хосты завершаются с ошибкой FIXTURE_NOT_FOUND. Ответ аудита фиксирует network.attempted: false и network.allowed: false.

Сеть отключена по умолчанию: сервис никогда не обращается к полученному URL. Неизвестные хосты безопасно завершаются с FIXTURE_NOT_FOUND.

Публичное развертывание / Публичное развертывание

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

• Стабильное продакшн-развертывание: https://website-intelligence-provider.vercel.app

Проект Vercel является автономным и использует функции в api/. vercel.json сопоставляет публичные маршруты с этими функциями. Он не зависит от Stellar Bazaar и не содержит учетных данных Bazaar или хуков развертывания.

Проект Vercel является независимым и использует функции в api/. Он не зависит от Stellar Bazaar и не содержит учетных данных или автоматизаций 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-контракт / 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.

Фикстуры и детерминизм / Фикстуры и детерминизм

Встроенные хосты:

• example.com

• www.example.com

• stellar.local

• demo.stellar.local

Одна и та же версия провайдера и нормализованный вход всегда дают одинаковую оценку и результаты. Выходные данные исключают временные метки, состояние DNS, реальное состояние HTTP, контент, зависящий от окружения, секреты, кошельки и платежные данные.

Одна и та же версия и нормализованный вход всегда дают одинаковую оценку и результаты. Выходные данные исключают даты, DNS, реальное состояние HTTP, контент, зависящий от окружения, секреты, кошельки и платежные данные.

Развертывание отдельного проекта Vercel / Развертывание как отдельного проекта

С аутентифицированным Vercel CLI:

vercel --yes
vercel --prod --yes

Vercel собирает бессерверные функции TypeScript в api/, используя явные маршруты в vercel.json. Каталог сборки не коммитится. .vercelignore исключает локальные кеши, рабочие файлы, результаты сборки, учетные данные и файлы окружения из загрузки при развертывании.

Vercel автоматически обнаруживает функции TypeScript в api/. Никакой каталог сборки не версионируется.

Версионирование

HTTP API и схема выходных данных используют основную версию v1 / 1.0. Критические изменения ответа требуют нового маршрута и версии схемы. SERVICE_CARD.v1.json проверяется тестами на соответствие Service Card времени выполнения.

Безопасность и область применения / Безопасность и охват

• В пути аудита нет исходящего HTTP-клиента.

• Учетные данные в URL и протоколы, отличные от HTTP(S), отклоняются.

• Неизвестные хосты никогда не запрашиваются.

• Не используются секреты, токены, платежные данные или функции кошелька.

• Этот проект независим: он не публикует и не изменяет Stellar Bazaar или любого другого провайдера.

Лицензия

Apache-2.0. См. LICENSE.