stackresolve

Официальный TypeScript/Node SDK для API StackResolve.

StackResolve — это веб-разведка для ИИ-агентов: поиск, сравнение и аудит программного обеспечения для задачи; реестр с оценками готовых к использованию агентами инструментов и 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)

Аутентификация

Получите API-ключ на stackresolve.dev. Передайте его в конструктор или задайте переменную окружения STACKRESOLVE_API_KEY:

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

Ключ отправляется в заголовке x-api-key в каждом запросе. Публичные конечные точки (аудит, поиск, профили, данные о компаниях, ...) работают без ключа, но с учётом анонимного ограничения частоты запросов. Закрытые конечные точки (мониторы, использование, запуски discovery) требуют ключ.

Вы можете указать клиенту другой хост с помощью baseUrl или переменной окружения STACKRESOLVE_BASE_URL:

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

Ошибки

Любой ответ с кодом вне диапазона 2xx вызывает исключение StackResolveError, содержащее HTTP status и разобранный body:

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