Research Scout Provider

Независимый TypeScript-провайдер на английском/испанском, который превращает предоставленные вызывающей стороной метаданные и выдержки в детерминированные и отслеживаемые исследовательские фикстуры. Он предоставляет HTTP API и инструмент stdio в форме MCP.

Proveedor TypeScript independiente en inglés/español que convierte metadatos y extractos proporcionados por el cliente en resultados de investigación deterministas y trazables. Expone una API HTTP y una herramienta MCP por stdio.

Этот сервис не загружает URL-адреса источников и не выполняет проверку фактов в реальном времени. Он никогда не связывается со Stellar Bazaar. Публичное развертывание — это автономная демонстрационная конечная точка.

Live deployment: https://research-scout-provider.vercel.app

Публичный API

После развертывания доступны следующие маршруты:

Пример запроса:

curl -X POST "$PROVIDER_URL/v1/research" \
  -H "content-type: application/json" \
  -d '{
    "query": "What is Stellar used for?",
    "locale": "en",
    "maxSources": 5,
    "sources": [{
      "title": "Example source",
      "url": "https://example.com/article",
      "excerpt": "Caller-provided evidence.",
      "publisher": "Example",
      "publishedAt": "2026-01-01T00:00:00Z"
    }]
  }'

Ответ содержит summary, отдельно цитируемые findings, нормализованные citations, явные limitations и mode: "local_fixture". Выберите испанский с помощью "locale": "es".

La respuesta incluye summary, findings con citas individuales, citations normalizadas, limitations explícitas y mode: "local_fixture". Usa "locale": "es" para español.

Ограничения ввода

• Запрос: 2–500 символов.

• Источники: 1–25 записей; принимаются только URL-адреса HTTP(S).

• Название источника: до 300 символов; выдержка: до 2000 символов.

• maxSources: 1–10, по умолчанию 5.

• Тело запроса локального Node-сервера: максимум 64 КиБ.

• Не следует отправлять учетные данные, данные кошелька, платежные данные или секреты.

Локальная разработка

Требуется Node.js 20 или новее.

npm ci
npm run check
npm start

Локальный HTTP-сервер прослушивает http://127.0.0.1:8787. Чтобы запустить MCP через stdio после сборки:

npm run build
npm run start:mcp

Инструмент MCP называется research_with_sources. Его контракт ввода и вывода соответствует HTTP-конечной точке.

Развертывание на Vercel

Этот репозиторий включает vercel.json и три бессерверные точки входа в api/. Разверните его как отдельный проект Vercel:

npx vercel
npx vercel --prod

Переменные окружения не требуются. Vercel переписывает /, /health и /v1/research на соответствующие бессерверные функции.

Безопасность и политика данных

• Нет исходящих сетевых запросов или автоматизации браузера.

• Нет хранения, аутентификации, платежей, кошельков или обработки учетных данных.

• Стабильные идентификаторы источников выводятся из URL-адресов источников с помощью SHA-256, если они не указаны.

• Вывод синтезирует только текст, предоставленный вызывающей стороной, и не является независимой проверкой.

• Нет интеграции с Stellar Bazaar или публикации в него.

См. service-card.json для машинно-читаемого обнаружения.

Лицензия

Apache License 2.0. См. LICENSE.