Research Scout Provider

Unabhängiger englisch/spanischer TypeScript-Provider, der vom Aufrufer bereitgestellte Quellenmetadaten und Auszüge in deterministische, nachvollziehbare Forschungs-Fixtures umwandelt. Er stellt eine HTTP-API und ein MCP-förmiges stdio-Tool bereit.

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.

Dieser Dienst ruft keine Quell-URLs ab und führt keine Live-Faktenprüfung durch. Er kontaktiert niemals Stellar Bazaar. Die öffentliche Bereitstellung ist ein eigenständiger Demonstrations-Endpunkt.

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

Öffentliche API

Nach der Bereitstellung sind die folgenden Routen verfügbar:

Beispielanfrage:

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

Die Antwort enthält summary, einzeln zitierte findings, normalisierte citations, explizite limitations und mode: "local_fixture". Wählen Sie Spanisch mit "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.

Eingabelimits

• Query: 2–500 Zeichen.

• Quellen: 1–25 Einträge; nur HTTP(S)-URLs werden akzeptiert.

• Quellentitel: bis zu 300 Zeichen; Auszug: bis zu 2.000 Zeichen.

• maxSources: 1–10, Standard 5.

• Lokaler Node-Server-Anfragekörper: maximal 64 KiB.

• Es sollten keine Anmeldedaten, Wallet-Daten, Zahlungsdaten oder Geheimnisse übermittelt werden.

Lokale Entwicklung

Erfordert Node.js 20 oder neuer.

npm ci
npm run check
npm start

Der lokale HTTP-Server lauscht auf http://127.0.0.1:8787. Um MCP über stdio nach dem Build auszuführen:

npm run build
npm run start:mcp

Das MCP-Tool heißt research_with_sources. Sein Eingabe- und Ausgabevertrag entspricht dem HTTP-Endpunkt.

Bereitstellung auf Vercel

Dieses Repository enthält vercel.json und drei serverlose Einstiegspunkte unter api/. Stellen Sie es als separates Vercel-Projekt bereit:

npx vercel
npx vercel --prod

Es sind keine Umgebungsvariablen erforderlich. Vercel schreibt /, /health und /v1/research auf die entsprechenden serverlosen Funktionen um.

Sicherheit und Datenrichtlinie

• Keine ausgehenden Netzwerkanfragen oder Browser-Automatisierung.

• Keine Persistenz, Authentifizierung, Zahlungen, Wallets oder Umgang mit Anmeldedaten.

• Stabile Quellen-IDs werden aus Quellen-URLs mit SHA-256 abgeleitet, wenn sie weggelassen werden.

• Die Ausgabe synthetisiert nur vom Aufrufer bereitgestellten Text und ist keine unabhängige Verifikation.

• Keine Integration mit oder Veröffentlichung an Stellar Bazaar.

Siehe service-card.json für maschinenlesbare Entdeckung.

Lizenz

Apache License 2.0. Siehe LICENSE.