StackSherpa

stacksherpa

智能 API 推荐引擎。涵盖 28 个类别中的 450 多家服务商，包含定价、已知问题、合规数据和 GitHub Issue 实时追踪。

浏览目录 →

快速开始

# 1. Install the CLI
npm install -g stacksherpa

# 2. Install the Claude Code skill (Claude will auto-consult stacksherpa when you need an API)
mkdir -p ~/.claude/skills/api-selection
curl -sL https://raw.githubusercontent.com/astein91/stacksherpa/main/skills/api-selection/SKILL.md \
  -o ~/.claude/skills/api-selection/SKILL.md

# 3. Try it
stacksherpa providers email --pretty

无需 API 密钥。该目录是一个共享的只读数据库。

---

浏览目录

访问 stacksherpa.vercel.app，探索服务商、比较选项，查看定价和已知问题——无需安装。

CLI 用法

stacksherpa categories --pretty                # List all 28 categories
stacksherpa providers email --pretty            # All email providers + your profile
stacksherpa providers database --pretty         # All database providers
stacksherpa provider stripe --pretty            # Deep-dive on one provider

stacksherpa profile --pretty                    # View your project profile
stacksherpa profile --set '{"project.scale": "startup"}'
stacksherpa profile --set '{"constraints.compliance": ["SOC2"]}'

stacksherpa decide --api Resend --category email --outcome positive
stacksherpa report --id <decision-id> --success

stacksherpa projects list --pretty

所有命令均输出 JSON。添加 --pretty 可使用便于阅读的格式。

Claude Code 技能

快速开始会全局安装该技能（~/.claude/skills/）。你也可以在单个项目中安装：

mkdir -p .claude/skills/api-selection
curl -sL https://raw.githubusercontent.com/astein91/stacksherpa/main/skills/api-selection/SKILL.md \
  -o .claude/skills/api-selection/SKILL.md

安装后，Claude 会在推荐任何 API 集成方案之前，自动静默运行 stacksherpa providers <category>。无需斜杠命令——该技能会自动触发。

替代方案 — 不使用技能，只添加说明： 将以下内容添加到项目的 CLAUDE.md：

## API Selection
When implementing features that require external APIs:
1. Run `stacksherpa providers <category>` via Bash before choosing a provider
2. Pick the best match based on the returned profile, pricing, and issues
3. After integration, run `stacksherpa decide --api X --category Y --outcome positive`

类别（28 个）

分组	类别
核心	auth、database、storage、email、payments、analytics、monitoring、search
消息传递	sms、push、realtime、chat
AI	ai、ai-audio、ai-video、ai-image、vector-db
基础设施	cache、jobs、message-queue、hosting、cdn、feature-flags
内容与数据	cms、media、maps、web-search、finance

每家服务商包含的信息

• 描述、网站、文档 URL、定价 URL
• 优势（开发体验、可靠性、成本、性能、支持、安全性、可定制性）
• 适用场景（个人项目 / 初创公司 / 成长期 / 企业）
• 不适用场景 / 最适合的情况（具体条件）
• 替代方案（带链接的服务商 ID）
• 合规认证（SOC2、HIPAA、GDPR、PCI-DSS、ISO27001）
• 生态系统适配度（vercel、supabase、aws、cloudflare 等）
• 可自托管标记
• 实时定价 — 从服务商网站抓取
• 已知问题 — 从 GitHub 抓取（反应数、严重程度、解决方法）

项目配置

在项目根目录创建 .stacksherpa/profile.json，个性化推荐：

{
  "project": {
    "name": "my-app",
    "stack": { "language": "TypeScript", "framework": "Next.js", "hosting": "Vercel" },
    "scale": "startup"
  },
  "constraints": {
    "compliance": ["SOC2"],
    "budgetCeiling": { "monthly": 100 }
  },
  "preferences": {
    "prioritize": ["dx", "reliability"],
    "avoidProviders": ["sendgrid"]
  }
}

~/.stacksherpa/defaults.json 中的全局默认设置适用于所有项目（本地配置文件优先）。

数据架构

Turso (shared, read-only for CLI clients)
  providers      — 450+ providers with rich metadata
  pricing        — versioned pricing snapshots
  known_issues   — scraped from GitHub (reactions, severity)
  discovery_log  — audit trail of bootstrap runs

Local (~/.stacksherpa/)
  defaults.json  — global defaults across all projects

Local (<project>/.stacksherpa/)
  profile.json   — project constraints & preferences
  decisions.json — API selection history

你的数据绝不会离开你的设备。Turso 目录为只读。

---

保持目录数据最新

该目录由 Agent 流水线维护，无需手动录入数据。

步骤	时间安排	功能
GitHub Issues	每次运行	从服务商代码仓库抓取反应数不少于 2 的 Issue
定价	每次运行	通过 Firecrawl 重新抓取最多 3 家数据过期的服务商
发现	每月 1 日和 15 日	通过 Exa 搜索发现新服务商
Agent 刷新	每日（AI），每周一（全部）	Claude Haiku 使用实时网络数据重新评估服务商档案
初始化	每月 1 日	对全部 28 个类别进行完整的 Agent 式发现

服务商审核

npm run cron:review -- --list                    # See pending providers
npm run cron:review -- --approve pinecone qdrant # Approve specific ones
npm run cron:review -- --reject some-blog        # Reject bad entries

环境变量（维护者专用）

变量	用途	说明
TURSO_AUTH_TOKEN	所有读取操作	Turso 只读访问权限
TURSO_WRITE_TOKEN	Cron 任务	为抓取器 / Agent 提供写入权限
ANTHROPIC_API_KEY	Agent 刷新、初始化	为 Agent 流水线提供 Claude Haiku
EXA_API_KEY	初始化	用于发现服务商的网络搜索
FIRECRAWL_API_KEY	定价、元数据	网站抓取
GITHUB_TOKEN	Issue 抓取	提高 GitHub API 的速率限制

开发

npm install
npm run build                                     # Type-check
npm run dev -- providers email --pretty            # Run CLI locally
npm test                                           # Run tests
npm run cron:bootstrap -- --category jobs --dry-run # Bootstrap one category
npm run cron:agent-refresh -- --full               # Full agent refresh

许可证

MIT