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가 생략된 경우 안정적인 소스 ID는 SHA-256을 사용하여 소스 URL에서 파생됩니다.

• 출력은 호출자가 제공한 텍스트만 종합하며 독립적인 검증이 아닙니다.

• Stellar Bazaar와의 통합 또는 게시가 없습니다.

기계 판독 가능한 검색을 위해 service-card.json을 참조하세요.

라이선스

Apache License 2.0. LICENSE를 참조하세요.