StackResolve

stackresolve

StackResolve API 用の公式 TypeScript/Node SDK です。

StackResolve は、エージェントがソフトウェアを発見、評価、選択、インストール、利用できるようにし（AgentReady）、ウェブ調査を構造化された企業データの呼び出しに圧縮します（CompanyData）。この SDK は、稼働中の REST API を薄く型付けしてラップしたものです。

コーディングエージェントに指示する一文

npx stackresolve@latest install

API キーがない場合は発行し、マシン上のすべてのコーディングエージェント（Claude Code、Cursor、Codex、Windsurf、VS Code）にホスト型 MCP サーバーを登録し、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 ヘッダーとして送信されます。公開エンドポイント（audit、search、profiles、company data など）はキーなしで利用できますが、匿名利用のレート制限が適用されます。制限付きエンドポイント（monitors、usage、discovery runs）にはキーが必要です。

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()。

その他の言語とフレームワーク

Python SDK：

pip install stackresolve

検索とスクレイピングを繰り返すことなく、エージェントがソフトウェアを選び、企業を調査できる LangChain ツール：

pip install langchain-stackresolve

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

REST API を直接利用する場合：https://api.stackresolve.dev、OpenAPI は /openapi.json、llms.txt は /llms.txt にあります。

ライセンス

MIT