BuyAPI

BuyAPI CLI + MCP サーバー

AI コーディングエージェント向けの、公平なベンダー情報です。

BuyAPI は、AI エージェントと開発者がインフラに関する情報に基づいた判断を下せるよう支援します。エージェントがデータベース、認証プロバイダー、ホスティングプラットフォーム、決済処理サービス、メールプロバイダー、UI コンポーネントシステムを選ぶ必要があるとき、BuyAPI は学習データ由来の既定値ではなく、最新の構造化された中立的なベンダー比較情報を提供します。

クイックスタート

リモート MCP（推奨）

ホスト型エンドポイントが主なインストール方法で、最新の 7 ツールの仕様を公開しています。

MCP クライアントの設定に追加します：

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

最も簡単な方法です。クライアントはローカルプロセスも npm のインストールも必要とせず、HTTP 経由で BuyAPI に直接接続します。

CLI のセットアップ

セットアップを実行して、BuyAPI をエージェントにインストールします：

npx buyapi

引数なしで npx buyapi を実行すると、対話形式のセットアップフローが開始されます。使用しているコーディングエージェントを尋ね、既定ではホスト型 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 を呼び出して最新のベンダーデータを取得し、出典付きの Stack Decision Record を返します。明示的に依頼しない限り、スキャンデータは同期しません。

CLI を頻繁に使い、npx を入力したくない場合は、グローバルにインストールします：

npm install -g buyapi
buyapi scan

MCP クライアントの設定では、明示的な mcp コマンドを使用します。クライアントがローカル stdio サーバーとして起動するため、事前に手動で実行する必要はありません：

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

エージェントクライアントがリモート MCP URL に対応していない場合や、オープンソースのローカルトランスポートを使用したい場合は、ローカルの方法を使用してください。ホスト型 MCP が引き続き推奨される既定の方法です。以前の buyapi-mcp パッケージは npm で非推奨になっているため、新しいユーザーには標準のパッケージ名が 1 つだけ表示されます。

Stack Scan And Sync

CLI にはスタックスキャナーがあります。通常のスキャンでは最初にローカルプレビューが表示され、ターミナルが対話型の場合は、プライベートスタックを保存するかどうかを尋ねます。

npx buyapi scan

package.json、ロックファイル、フレームワーク設定、convex/、prisma/、Python のマニフェスト、ソースコードのインポートなど、プロジェクトを示す情報を含むアプリ、パッケージ、またはモノレポのルートから実行してください。パブリックな GitHub リポジトリの URL を指定することもできます。

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

プロジェクトを示す情報が見つからない場合、CLI はスタックが空のまま何も通知せずに終了するのではなく、間違ったフォルダーで実行している場合の案内を表示します。また、--allow-empty を指定しない限り、既知の BuyAPI ツールが 0 件のスタックは Sync でスキップされます。

--verbose を指定すると、package.json で見つかった証拠と未知のパッケージ候補を確認できます。

npx buyapi scan --verbose

アップロードを行わないことが保証されたプレビューには、--dry-run を使用してください。自動化でプロンプトを表示せずにプライベートスタックを保存するには、最初に一度ログインしてから、Sync を実行します。

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 ツールではありません。stdout は MCP プロトコルで使用されるため、MCP サーバーは stdout に出力しないでください。

読み取り専用 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?

決定後、エージェントが正確な API、コード例、またはバージョン固有のセットアップ手順を必要とする場合は、Context7 などの実装ドキュメント用ツールを使用してください。

回答の質を高めるためのヒント

• ベンダー ID が分かっている場合は使用してください。例：/database/convex、/database/supabase、/hosting/vercel。
• コストについて尋ねる場合は、ユーザー数、月間アクティブユーザー数、メール送信数、ストレージ、帯域幅、月間注文数などのワークロードの数値を含めてください。
• 重要な制約を含めてください。例：創業者 1 人、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

ワークロードや意思決定の条件に合わせて、2 つ以上の特定のベンダーを比較します。

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 サーバーは、BuyAPI バックエンド API を呼び出す、軽量な TypeScript クライアントです。ベンダーデータは含まれていません。軽量な比較機能とコストのフォーマット処理はホストされたエンドポイントを踏襲し、ベンダー情報は 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 サーバーのコマンドにバナーやプロンプトを追加しないでください。標準出力は MCP プロトコルメッセージ専用です。
• 匿名ユーザーのレート制限に達した場合は、BuyAPI ダッシュボードで API キーを作成し、クライアントが環境変数に対応している場合は BUYAPI_API_KEY として渡してください。
• ツールやベンダーが見つからない場合も、BuyAPI に問い合わせてください。不明なリクエストは、今後のコーパス拡充に向けた需要シグナルとして扱われます。

免責事項

BuyAPI のプロファイルは、一次情報、手動レビュー、公開されている根拠、構造化された推定を組み合わせたものです。ベンダーデータは古くなったり、不完全になったりすることがあり、特に価格や制限はその可能性があります。BuyAPI は意思決定を支援するものとして利用し、本番環境に関する重要な契約事項はベンダーに直接確認してください。また、報告機能が利用可能な場合は、古くなった情報をウェブサイトから報告してください。

ライセンス

MIT