BuyAPI

BuyAPI CLI + MCP 服务

为 AI 编码 Agent 提供公正的供应商情报。

BuyAPI 帮助 AI Agent 和开发者做出明智的基础设施决策。当你的 Agent 需要选择数据库、身份验证提供商、托管平台、支付处理商、电子邮件提供商或 UI 组件系统时，BuyAPI 会提供最新、结构化、中立的供应商比较，而不是默认依赖训练数据。

快速开始

远程 MCP（推荐）

托管端点是主要的安装方式，并提供当前由 7 个工具组成的接口。

添加到你的 MCP 客户端配置中：

{
  "mcpServers": {
    "buyapi": {
      "url": "https://buyapi.ai/api/mcp"
    }
  }
}

这是最简单的方式：客户端通过 HTTP 直接连接到 BuyAPI，无需本地进程，也无需安装 npm。

CLI 设置

运行设置程序，将 BuyAPI 安装到你的 Agent 中：

npx buyapi

直接运行 npx buyapi 会打开交互式设置流程。它会询问你使用哪个编码 Agent，默认安装托管 MCP 配置，在支持的情况下可添加 /stack 规划技能，还可以帮助你登录以获得更高的使用限额并同步技术栈。

也可以直接指定客户端：

npx buyapi setup cursor
npx buyapi setup claude-code
npx buyapi setup codex
npx buyapi setup windsurf
npx buyapi setup cline

默认情况下，设置程序会写入托管 MCP URL。当客户端需要本地 stdio 进程时，请使用 --local：

npx buyapi setup codex --local

Claude Code 和 Codex 也可以安装 /stack 规划工作流：

npx buyapi setup claude-code --skill
npx buyapi setup-skill codex

/stack 会检查本地仓库，询问缺失的约束条件，调用 BuyAPI MCP 获取最新供应商数据，并返回有来源依据的技术栈决策记录。除非你明确要求，否则它不会同步扫描数据。

如果你经常使用 CLI，不想每次都输入 npx，可以全局安装：

npm install -g buyapi
buyapi scan

在 MCP 客户端配置中，使用显式的 mcp 命令。客户端会将其作为本地 stdio 服务启动；你无需事先手动运行：

{
  "mcpServers": {
    "buyapi": {
      "command": "npx",
      "args": ["-y", "buyapi", "mcp"]
    }
  }
}

当 Agent 客户端不支持远程 MCP URL，或你想使用开源的本地传输方式时，请使用本地方式。托管 MCP 仍然是推荐的默认选项。旧版 buyapi-mcp 包已在 npm 上弃用，因此新用户只会看到一个规范的包名。

Stack 扫描与同步

CLI 提供了栈扫描器。普通扫描会先打印本地预览，然后在终端支持交互时询问是否保存私有栈：

npx buyapi scan

请从包含项目特征的应用、软件包或 monorepo 根目录运行，例如 package.json、锁文件、框架配置、convex/、prisma/、Python 清单或源代码导入。你也可以指定公开的 GitHub 仓库 URL：

npx buyapi scan https://github.com/owner/repo

如果未发现项目特征，CLI 会打印目录错误提示，而不是静默返回空栈。如果没有已知 BuyAPI 工具，Sync 也会跳过该栈，除非你传入 --allow-empty。

使用 --verbose 查看在 package.json 中发现的证据和未知软件包候选项：

npx buyapi scan --verbose

如需确保预览不会上传任何内容，请使用 --dry-run。如需在自动化流程中不经提示地保存私有栈，请先登录一次，然后再同步：

npx buyapi login
npx buyapi scan --sync --yes

检测使用 BuyAPI 自己的注册表，其中包含清单、标记文件、环境变量键、配置内容、导入、框架和语言等信号。未知运行时软件包会保留为候选项，让公开工具注册表能够了解新的 AI 原生工具，而无需复制第三方检测表。常规开发/构建工具会在进入审核队列前被过滤掉。

buyapi login 会打开浏览器，通过控制面板登录，创建 CLI API 密钥并将其保存在本地。你仍然可以通过 buyapi login ba_live_... 传入现有密钥，或在 CI 中使用 BUYAPI_API_KEY。如果密钥处于启用状态，buyapi whoami --quiet 会以 0 退出；如果未启用，则以 1 退出。Sync 会上传已知的检测到的工具，以及经过筛选的未知软件包名称、版本和证据，以便 BuyAPI 审核新兴工具。它不会上传源代码、源文件内容或环境变量值。

scan 是面向用户的 CLI 命令，不是 MCP 工具。MCP 服务应保持 stdout 静默，因为 stdout 用于传输 MCP 协议。

只读 CLI

本地软件包无需启动 MCP 客户端即可查询 BuyAPI：

npx buyapi search "realtime database with preview environments" --category database
npx buyapi details /database/convex
npx buyapi compare /database/convex /database/supabase --query "realtime SaaS"
npx buyapi recommend "B2B AI SaaS with teams and usage billing" --users 1000
npx buyapi cost /email/ses --emails 50000

在只读命令中使用 --json 可打印原始结构化响应。

何时使用 BuyAPI

当问题涉及供应商或技术栈决策时，请使用 BuyAPI：

Should I use Convex, Supabase, or Neon for a realtime B2B SaaS?

Estimate the email cost for 50,000 transactional sends/month.

What auth provider should I use for organizations, SSO later, and a generous free tier?

做出决策后，如果 Agent 需要精确的 API、代码示例或特定版本的设置步骤，请使用 Context7 等实现文档工具。

更好地获取答案的提示

• 如果知道供应商 ID，请使用 BuyAPI 供应商 ID，例如 /database/convex、/database/supabase、/hosting/vercel。
• 询问成本时，请提供工作负载数据：用户数、月活跃用户数、邮件发送量、存储空间、带宽或月订单量。
• 请说明重要的限制条件：独立创始人、B2B SaaS、未来需要符合 HIPAA/SOC2、无需信用卡的免费套餐、预览环境、实时协作或低锁定风险。
• 如果你想了解权衡，而非仅获取单一建议，请询问替代方案。

常见启动语料库 ID：

/database/convex
/database/supabase
/database/neon
/auth/clerk
/hosting/vercel
/payments/stripe
/email/resend
/ui-components/shadcn-ui

可用工具

vendors.resolve

按查询搜索供应商。类别为可选项。返回匹配的供应商及其定价摘要、市场定位、置信度和明确的未知语料库回退结果。

Query: "I need a database for a real-time collaborative app"
Category: "database"

-> Returns: Convex, Supabase, Neon, PlanetScale, Firebase with comparison metadata

vendors.details

获取详细的供应商资料：具体定价数值、免费套餐限制、扩展特性、已知注意事项、来源溯源信息和直接对比。

Vendor ID: /database/supabase
Query: "free tier limits for a side project"

-> Returns: Full pricing tiers, 500MB DB limit, 50K auth users, scaling triggers, and sources

vendors.evidence

获取与供应商、类别、技术栈或对比相关的近期已审核证据条目。

Subject type: "vendor"
Subject ID: /database/supabase

-> Returns: Evidence summaries with source URLs, stance, confidence, and observed dates

stacks.findSimilar

查找与某个供应商相关的公开技术栈资料，或近期精选的技术栈示例。

Vendor ID: /database/convex

-> Returns: Similar stack profiles with project summary, audience, stage, tools, and confidence

vendors.compare

针对某项工作负载或决策，对比两个或多个指定供应商。

Vendor IDs: ["/database/convex", "/database/supabase", "/database/neon"]
Query: "realtime TypeScript SaaS with preview environments"

-> Returns: Structured decision matrix with fit, capability-by-capability yes/no/unknown coverage, tradeoffs, estimated cost, confidence, and sources

vendors.estimateCost

根据明确的工作负载输入执行确定性成本估算，而不是把计算留给模型。

Vendor IDs: ["/email/ses"]
Workload: { "emailSendsPerMonth": 50000 }

-> Returns: Amazon SES estimated at $5/month, basis, assumptions, unknowns, and sources

stacks.recommend

描述你的项目，获取完整的技术栈推荐，包括成本预测、决策矩阵、假设、未知因素、替代方案和来源。

此工具适用于技术栈、供应商和工具的选择，不适用于 CSS 布局、TypeScript 编译器错误或框架 API 用法等本地实现问题。

Project: "SaaS for restaurant inventory with real-time updates"
Constraints: "Solo founder, under $50/month until 1000 users"
Stack context: [{ "vendorSlug": "/database/convex", "category": "database", "confidence": "high" }]

-> Returns: Full stack (hosting + DB + auth + payments + email) with structured cost and decision data

按客户端配置

{
  "mcpServers": {
    "buyapi": {
      "url": "https://buyapi.ai/api/mcp"
    }
  }
}

{
  "mcpServers": {
    "buyapi": {
      "url": "https://buyapi.ai/api/mcp"
    }
  }
}

{
  "servers": {
    "buyapi": {
      "url": "https://buyapi.ai/api/mcp"
    }
  }
}

{
  "mcpServers": {
    "buyapi": {
      "url": "https://buyapi.ai/api/mcp"
    }
  }
}

{
  "mcpServers": {
    "buyapi": {
      "command": "npx",
      "args": ["-y", "buyapi", "mcp"]
    }
  }
}

API 密钥

BuyAPI 目前可在匿名速率限制下无需 API 密钥使用。登录用户可以创建仪表板 API 密钥，以使用密钥访问、用量分析和技术栈同步功能。

本地软件包会读取 BUYAPI_API_KEY，或读取通过 buyapi login 保存的密钥：

{
  "mcpServers": {
    "buyapi": {
      "url": "https://buyapi.ai/api/mcp",
      "env": {
        "BUYAPI_API_KEY": "ba_live_..."
      }
    }
  }
}

CLI 参考

buyapi                             # Show setup guidance
buyapi setup <client>              # Install MCP config for an agent
buyapi setup <client> --skill      # Install MCP config and the /stack skill
buyapi setup-skill <client>        # Install the /stack skill only
buyapi mcp                         # Run the local MCP server over stdio
buyapi login                       # Browser login and local key storage
buyapi login <api-key>             # Store an existing API key
buyapi logout                      # Remove the stored API key
buyapi whoami                      # Verify the active local key
buyapi whoami --quiet              # Auth check for scripts
buyapi scan [dir]                  # Scan locally, then optionally save stack
buyapi scan https://github.com/x/y  # Scan a public GitHub repo
buyapi scan --sync --yes           # Save detected tools without prompts
buyapi search <query>              # Search vendors
buyapi details <vendorId>          # Fetch one vendor profile
buyapi compare <ids...>            # Compare vendors
buyapi recommend <prompt>          # Recommend a stack
buyapi cost <ids...>               # Estimate cost from workload flags
buyapi --version                   # Print the CLI version

常用标志：

--category <name>       Limit search/cost to a category
--query <text>          Add workload or decision context
--client <name>         Setup target: claude-code, cursor, codex, windsurf, cline
--local                 Write local stdio MCP config during setup
--skill                 Also install the /stack planning skill during setup
--print                 Print setup config instead of writing it
--name <text>           Stack name for scan sync
--stack-name <text>     Alias for --name
--stack <slug>          Stable stack slug/name to update
--summary <text>        Stack notes for scan sync
--sync                  Save scan output to your dashboard
--dry-run               Preview scan output without uploading
--verbose               Include scanner evidence details
--all                   Include lower-confidence supporting detections
--allow-empty           Save even when no known tools were detected
--force                 Alias for --allow-empty
--yes                   Skip sync confirmation prompt
--users <n>             Monthly active users
--emails <n>            Email sends per month
--orders <n>            Monthly orders
--json                  Print raw structured JSON

覆盖的类别

工作原理

此 MCP 服务是一个轻量级 TypeScript 客户端，会调用 BuyAPI 后端 API。它不包含供应商数据；轻量级比较和成本格式化逻辑与托管端点保持一致，而供应商信息由 buyapi.ai 提供。

源代码完全开源，你可以确认其中没有提示词注入或隐藏行为。scan 会先在本地预览，只有在明确确认或使用 --sync 后才会上传；--dry-run 则绝不会上传。同步会发送检测到的工具元数据、推导出的技术栈上下文、检查过的文件名、提供的仓库 URL 元数据，以及供审核的筛选后未知软件包候选项。它不会发送源代码或环境变量值。

数据透明度

• 所有供应商数据都可在 buyapi.ai 公开查看
• 每个资料页面都会显示最后更新时间和数据来源
• BuyAPI 不接受供应商付费以影响排名
• 错误数据报告、编辑建议、评论和供应商认领请求均设有审核流程；供应商自助编辑功能尚未上线。

故障排除

• 如果你的 MCP 客户端支持远程 MCP URL，请优先使用 https://buyapi.ai/api/mcp。
• 如果不支持远程 MCP，请使用 command: "npx" 和 args: ["-y", "buyapi", "mcp"] 配置本地 stdio 服务。
• 不要在 stdio 服务命令中添加横幅或提示词；stdout 专用于 MCP 协议消息。
• 如果触及匿名速率限制，请在 BuyAPI 仪表板中创建 API 密钥，并在客户端支持环境变量时将其作为 BUYAPI_API_KEY 传入。
• 如果缺少某个工具或供应商，仍可向 BuyAPI 提出请求。未知请求会被视为未来扩展语料库的需求信号。

免责声明

BuyAPI 资料结合了第一方来源、人工审核、公开证据和结构化估算。供应商数据可能过时或不完整，尤其是定价和限制信息。请将 BuyAPI 作为决策支持工具，对重要的生产承诺直接向供应商核实，并在网站开放报告流程后报告过时信息。

许可证

MIT