Research Scout Provider

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.

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.

Este servicio no obtiene URLs de fuentes ni realiza verificación de datos en vivo. Nunca contacta con Stellar Bazaar. El despliegue público es un endpoint de demostración independiente.

Despliegue en vivo: https://research-scout-provider.vercel.app

API pública

Tras el despliegue, están disponibles las siguientes rutas:

Ejemplo de solicitud:

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"
    }]
  }'

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

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

Límites de entrada

• Consulta: de 2 a 500 caracteres.

• Fuentes: de 1 a 25 entradas; solo se aceptan URLs HTTP(S).

• Título de la fuente: hasta 300 caracteres; extracto: hasta 2.000 caracteres.

• maxSources: de 1 a 10, por defecto 5.

• Cuerpo de solicitud del servidor Node local: máximo 64 KiB.

• No se deben enviar credenciales, datos de billetera, datos de pago ni secretos.

Desarrollo local

Requiere Node.js 20 o superior.

npm ci
npm run check
npm start

El servidor HTTP local escucha en http://127.0.0.1:8787. Para ejecutar MCP sobre stdio después de compilar:

npm run build
npm run start:mcp

La herramienta MCP se llama research_with_sources. Su contrato de entrada y salida coincide con el endpoint HTTP.

Despliegue en Vercel

Este repositorio incluye vercel.json y tres puntos de entrada serverless en api/. Despliégalo como un proyecto de Vercel separado:

npx vercel
npx vercel --prod

No se requieren variables de entorno. Vercel reescribe /, /health y /v1/research a sus correspondientes funciones serverless.

Política de seguridad y datos

• Sin solicitudes de red salientes ni automatización de navegador.

• Sin persistencia, autenticación, pagos, billeteras ni manejo de credenciales.

• Los IDs de fuente estables se derivan de las URLs de las fuentes con SHA-256 cuando se omiten.

• La salida sintetiza solo el texto proporcionado por el cliente y no es una verificación independiente.

• Sin integración ni publicación en Stellar Bazaar.

Consulta service-card.json para descubrimiento legible por máquina.

Licencia

Licencia Apache 2.0. Consulta LICENSE.