stackresolve

StackResolve API용 공식 TypeScript/Node SDK입니다.

StackResolve는 AI 에이전트를 위한 웹 인텔리전스입니다. 작업에 필요한 소프트웨어를 찾고, 비교하고, 감사할 수 있으며, 에이전트에 바로 사용할 수 있는 도구와 MCP 서버의 점수화된 레지스트리, 구조화된 기업 리서치를 제공합니다. 세 가지 인터페이스, 하나의 API: REST, 호스팅형 MCP 서버, 그리고 이 CLI/SDK입니다. 레지스트리 읽기는 무료이며 키가 필요 없습니다.

• 사이트 및 문서: https://stackresolve.dev

• REST: https://api.stackresolve.dev (OpenAPI는 /openapi.json, llms.txt는 /llms.txt)

• 호스팅형 MCP(streamable HTTP): https://mcp.stackresolve.dev/mcp

• 에이전트용 MCP 서버 레지스트리: https://stackresolve.dev/mcp-servers

MCP 서버

호스팅형 서버는 설치가 필요 없습니다. 핸드셰이크와 레지스트리 읽기(search_tools, get_profile, compare_products, list_registry)는 키 없이 동작합니다. 사용량 기반 도구(resolve, how_to, audit, research_company, get_company, get_pricing)는 https://stackresolve.dev/developers에서 무료 키를 받아 x-api-key 헤더로 보내야 합니다.

Claude Code:

claude mcp add --transport http stackresolve https://mcp.stackresolve.dev/mcp

Cursor (~/.cursor/mcp.json):

{
  "mcpServers": {
    "stackresolve": {
      "url": "https://mcp.stackresolve.dev/mcp",
      "headers": { "x-api-key": "ar_..." }
    }
  }
}

Codex (~/.codex/config.toml):

[mcp_servers.stackresolve]
url = "https://mcp.stackresolve.dev/mcp"

[mcp_servers.stackresolve.headers]
x-api-key = "ar_..."

도구: resolve, how_to, find_tools_for_task, search_tools, compare_products, get_profile, list_registry, audit, generate_agent_interfaces, get_company, get_pricing, research_company, find_competitors, compare_companies, get_usage.

Related MCP server: mcp-registry-finder

CLI

npm i -g stackresolve
stackresolve find "scrape javascript-heavy sites from claude code"
stackresolve audit stripe.com
stackresolve company vercel.com
stackresolve --help

SDK

설치

npm install stackresolve

Node 18+가 필요합니다(내장 전역 fetch 사용). 런타임 의존성이 없습니다.

빠른 시작

import { StackResolve } from 'stackresolve'

const sr = new StackResolve({ apiKey: process.env.STACKRESOLVE_API_KEY })

// 1. Audit a domain: AgentReady scores, facts, and issues.
const report = await sr.audit('stripe.com')
console.log(report.scores.agentready, report.issues)

// 2. Structured company data.
const company = await sr.getCompany('vercel.com')
console.log(company.name, company.description)

// 3. Task -> ranked, agent-ready tools.
const tools = await sr.findTools('send transactional email from a Node service')
console.log(tools.results)

// 4. Run an Agent Discovery check (needs an API key).
const discovery = await sr.runDiscovery('firecrawl')
console.log(discovery)

인증

stackresolve.dev에서 API 키를 받으세요. 생성자에 전달하거나 STACKRESOLVE_API_KEY 환경 변수를 설정하세요:

const sr = new StackResolve({ apiKey: 'ar_...' })
// or, reading STACKRESOLVE_API_KEY from the environment:
const sr2 = new StackResolve()

키는 모든 요청에서 x-api-key 헤더로 전송됩니다. 공개 엔드포인트(감사, 검색, 프로필, 기업 데이터 등)는 익명 요청 속도 제한이 적용되지만 키 없이 동작합니다. 인증이 필요한 엔드포인트(모니터, 사용량, 디스커버리 실행)는 키가 필요합니다.

baseUrl 또는 STACKRESOLVE_BASE_URL 환경 변수를 사용하여 클라이언트를 다른 호스트로 지정할 수 있습니다:

const sr = new StackResolve({ apiKey, baseUrl: 'https://api.stackresolve.dev' })

오류

2xx가 아닌 모든 응답은 HTTP status와 파싱된 body를 담은 StackResolveError를 던집니다:

import { StackResolve, StackResolveError } from 'stackresolve'

try {
  await sr.getUsage()
} catch (err) {
  if (err instanceof StackResolveError) {
    console.error(err.status, err.body)
  }
}

메서드

AgentReady: audit(domain), findTools(task), search(query, requirements?), compare(slugs), getProfile(slug), listRegistry(opts?), getCategories(), getCategory(slug), getDiscovery(slug), runDiscovery(slug), getScoreHistory(slug), generate(domain, openapiUrl?), deploy(domain, openapiUrl?).

CompanyData: getCompany(domain), getPricing(domain), getCompetitors(domain), research(domain, question?), compareCompanies(domains).

모니터 + 계정(API 키 필요): listMonitors(), addMonitor(slug, opts?), runMonitorNow(slug), getUsage(), getMyProfile().

라이선스

MIT