StackResolve

stackresolve

适用于 StackResolve API 的官方 TypeScript/Node SDK。

StackResolve 可帮助 Agent 发现、评估、选择、安装和使用软件 （AgentReady），并将网络研究整合为结构化的公司数据调用 （CompanyData）。此 SDK 是对线上 REST API 的轻量级类型化封装。

为你的编码 Agent 准备的一行命令

npx stackresolve@latest install

如果你还没有 API 密钥，此命令会为你创建一个；在这台机器上为每个编码 Agent 注册托管 MCP 服务（Claude Code、Cursor、Codex、Windsurf、VS Code），将 StackResolve 技能写入 ~/.claude/skills/stackresolve/SKILL.md，并通过 API 验证密钥。此命令可以安全地重复运行，并会备份所有更改的文件。

npx stackresolve@latest install --dry-run     # show what would change
npx stackresolve@latest install --cursor      # one agent only
npx stackresolve@latest install --project --rules   # also wire up the current repo

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。

CLI

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

安装

npm install stackresolve      # SDK
npm i -g stackresolve         # CLI

需要 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 响应都会抛出 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()。

其他语言和框架

Python SDK：

pip install stackresolve

LangChain 工具，让 Agent 无需反复搜索和抓取，就能挑选软件并研究公司：

pip install langchain-stackresolve

from langchain_stackresolve import StackResolveToolkit
tools = StackResolveToolkit().get_tools()

直接使用 REST：https://api.stackresolve.dev，OpenAPI 位于 /openapi.json，llms.txt 位于 /llms.txt。

许可证

MIT