Research Scout Provider

独立的英语/西班牙语 TypeScript 提供程序，将调用方提供的源元数据和摘录转换为确定性、可追踪的研究夹具。它公开了一个 HTTP API 和一个 MCP 形式的 stdio 工具。

独立的英语/西班牙语 TypeScript 提供程序，将客户端提供的元数据和摘录转换为确定性、可追踪的研究结果。公开 HTTP API 和基于 stdio 的 MCP 工具。

此服务不会获取源 URL 或执行实时事实核查。它从不联系 Stellar Bazaar。公共部署是一个独立的演示端点。

在线部署：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" 选择西班牙语。

响应包含 summary、带单独引用的 findings、规范化的 citations、明确的 limitations 以及 mode: "local_fixture"。使用 "locale": "es" 选择西班牙语。

输入限制

• 查询：2–500 个字符。

• 来源：1–25 条；仅接受 HTTP(S) URL。

• 来源标题：最多 300 个字符；摘录：最多 2,000 个字符。

• maxSources：1–10，默认 5。

• 本地 Node 服务器请求体：最大 64 KiB。

• 不应提交任何凭据、钱包数据、支付数据或机密信息。

本地开发

需要 Node.js 20 或更高版本。

npm ci
npm run check
npm start

本地 HTTP 服务器监听 http://127.0.0.1:8787。构建后通过 stdio 运行 MCP：

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 重写到对应的无服务器函数。

安全与数据策略

• 无出站网络请求或浏览器自动化。

• 无持久化、身份验证、支付、钱包或凭据处理。

• 当省略时，稳定的来源 ID 通过 SHA-256 从来源 URL 派生。

• 输出仅综合调用方提供的文本，并非独立验证。

• 不与 Stellar Bazaar 集成或向其发布。

有关机器可读的发现信息，请参阅 service-card.json。

许可证

Apache License 2.0。请参阅 LICENSE。