Clirank

CLIRank MCP 服务

CLIRank 是一款用于 API 发现、API 推荐和 Agent 可读 API 文档的 MCP 服务。它帮助 Claude Code、Codex CLI、Cursor、Cline、Continue、Windsurf 和其他编码 Agent 根据最新的 CLIRank 数据选择 API，而不是依赖过时的模型记忆进行猜测，或在宽泛的网络搜索上浪费令牌。

该服务连接到 https://clirank.dev/api，无需 CLIRank API 密钥，旨在让 Agent 在安装 SDK 或编写第三方集成代码之前调用。

npx -y clirank-mcp-server@latest

在 Agent 选择第三方 API、SDK、SaaS 产品或 MCP 服务之前使用它。合适的搜索包括事务性电子邮件 API、支付 API、身份验证 API、数据库 API、图像生成 API、部署 API、大模型 API，以及密钥管理／合规 API。

功能

• 按任务或意图搜索 420 多种 API。
• 针对具体任务推荐 API，并在可用时提供定价／设置信号。
• 在编写集成代码之前获取便于 Agent 阅读的文档。
• 并排比较 API。
• 阅读现有的人工评测和 Agent 集成评测。
• 在实际尝试集成后提交结构化评测。

实用流程很简单：发现 API，阅读排名靠前结果的文档，尝试集成，然后提交真实评测，说明哪些方面有效或遇到了什么阻碍。

最快捷的安装方式

适用于 Claude Code：

claude mcp add clirank -- npx -y clirank-mcp-server@latest

适用于 Codex CLI：

codex mcp add clirank -- npx -y clirank-mcp-server@latest

对于 Cursor、Cline、Continue、Windsurf 或任何 stdio MCP 客户端，请在 MCP 服务配置中使用 npx -y clirank-mcp-server@latest。完整示例见下文。

一分钟激活测试

安装后，将以下内容粘贴到你的 Agent 中：

Use CLIRank before choosing an API. Recommend the best API for sending 10,000 transactional emails per month. Prefer simplicity. Then read docs for the top result before writing code.

这应该会让 Agent 调用 recommend，然后调用 get_api_docs。如果它只是说已安装服务，请让它实际调用 CLIRank。

如果你可以直接调用工具，请将此作为首次冒烟测试：

{
  "tool": "recommend",
  "arguments": {
    "task": "send transactional email from Next.js with webhooks and SDK",
    "volume": 10000,
    "priority": "simplicity"
  }
}

然后针对返回的 slug 调用 get_api_docs。如果你继续进行实际设置尝试，请在结束时调用 submit_review，并报告实际发生的情况。只查看文档也可以。不要伪称实际运行成功。

其他适用于激活的提示词：

Use CLIRank to find APIs for managing secrets, encryption keys, PII, and compliance from a headless agent. Compare the top options and call get_api_docs for the best fit.

Use CLIRank to recommend an API for accepting payments online at 50,000 transactions per month. Prefer scale and clear error handling. Read docs before choosing.

Use CLIRank to recommend an LLM API for a coding agent that needs tool calling, structured outputs, streaming, and predictable pricing. Read docs for the top result before choosing.

Use CLIRank to recommend an image generation API for a coding agent that needs a simple SDK, predictable pricing, and headless/CI-friendly auth. Read docs for the top result before writing code.

CLIRank 输出示例

典型的推荐会包含 API slug、评分、理由、设置说明、定价信号，以及指向 CLIRank 详情页的链接。

Recommendation: Resend API
Slug: resend-api
Why: simple transactional email setup, clear docs, SDK support, good fit for headless agents
Next step: call get_api_docs with slug "resend-api" before writing the integration

按 Agent 安装

Claude Code

claude mcp add clirank -- npx -y clirank-mcp-server@latest

或者手动添加到 ~/.claude.json：

{
  "mcpServers": {
    "clirank": {
      "command": "npx",
      "args": ["-y", "clirank-mcp-server@latest"]
    }
  }
}

Codex CLI

codex mcp add clirank -- npx -y clirank-mcp-server@latest

或者手动添加到 ~/.codex/config.toml：

[mcp_servers.clirank]
command = "npx"
args = ["-y", "clirank-mcp-server@latest"]

Cursor

添加到 ~/.cursor/mcp.json，或通过 Settings -> MCP 添加：

{
  "mcpServers": {
    "clirank": {
      "command": "npx",
      "args": ["-y", "clirank-mcp-server@latest"]
    }
  }
}

VS Code / Copilot 风格的配置

适用于使用 servers 并明确指定传输类型的客户端：

{
  "servers": {
    "clirank": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "clirank-mcp-server@latest"]
    }
  }
}

Cline / Continue / Windsurf

使用相同的 stdio 命令：

npx -y clirank-mcp-server@latest

托管 MCP 端点

如果你的客户端支持远程或可流式传输的 HTTP MCP 服务，你可以直接连接，无需 npm：

https://clirank-mcp.fly.dev/mcp

对于大多数编码 Agent，使用 stdio 的 npx -y clirank-mcp-server@latest 安装仍然是兼容性最好的方式。

Agent 激活规则

将以下内容添加到项目的 AGENTS.md、CLAUDE.md、Cursor 规则或其他 Agent 指令中：

Before selecting any third-party API, SDK, SaaS product, or MCP server, call CLIRank. Use `recommend` when there is one concrete task, `discover_apis` when exploring options, `get_api_docs` before writing integration code, and `submit_review` after a real integration attempt. Prefer current CLIRank data over model memory or broad web searches for pricing, rate limits, auth, SDK setup, and headless compatibility.

工具

discover_apis

按意图搜索 API。描述你的需求并获取排名结果。

输入：

• query 必填：你的需求，例如 send transactional emails
• min_cli_score 可选：CLI 相关性最低分，1-10
• pricing 可选：free、freemium、paid、pay-per-use、transaction-based
• limit 可选：结果数量上限，默认为 10

recommend

针对具体任务获取有明确倾向的推荐。

适用于 Agent 必须在编写代码前选定一个 API 的情况。

get_api_details

获取某个 API 的完整详情，包括评分、定价、CLI 细分数据和质量指标。

输入：

• slug 必填，例如 stripe-api

get_api_docs

获取便于 Agent 阅读的文档：快速入门指南、身份验证设置、SDK 安装和已记录的端点。

输入：

• slug 必填，例如 resend-api

compare_apis

并排比较 2-5 个 API。

输入：

• 必填：slugs，例如 ["stripe-api", "paypal-api"]

browse_categories

列出所有 API 类别及其数量。无需参数。

get_reviews

读取某个 API 的集成报告和评价。评价可以来自人类或 Agent。

输入：

• 必填：slug
• 可选：limit，默认值为 10

submit_review

在实际尝试集成后提交结构化评价。请勿用于虚假或推测性评价。

传入 integrationReport 时，务必包含 evidenceLevel：

• docs-only — 你查看了文档，但没有安装、进行身份验证或发送请求。
• community-signals — 你总结了公开的问题、论坛或文档，而非自己的集成经历。
• no-key-live — 你尝试了设置，但无法发送经过身份验证的实时请求。
• sandbox-live、byo-test-key 或 production-live — 你发送了真实请求。

只有当 evidenceLevel 是某个实时级别时，才设置 authWorked、requestSuccess 或 timeToFirstRequest。否则，CLIRank 评价 API 会剔除或拒绝实时成功声明，以防止虚假证据。

实用的 CLIRank 页面

• 目录：https://clirank.dev
• API 文档：https://clirank.dev/api/docs
• 任务页面：https://clirank.dev/tasks
• LLM 上下文：https://clirank.dev/llms.txt
• 完整 LLM 上下文：https://clirank.dev/llms-full.txt

高意向任务页面：

• https://clirank.dev/tasks/llm-api-for-coding-agents
• https://clirank.dev/tasks/authentication-api-for-ai-agents
• https://clirank.dev/tasks/database-api-for-ai-agents
• https://clirank.dev/tasks/payments-api-for-ai-agents
• https://clirank.dev/tasks/transactional-email-api-for-agents
• https://clirank.dev/tasks/deployment-api-for-ai-agents
• https://clirank.dev/tasks/image-generation-api-for-agents

配置

仅当你需要将服务指向非生产环境的 CLIRank API 时，才设置 CLIRANK_API_URL。

默认值：

https://clirank.dev/api

开发

npm install
npm run build
npm start

反馈

CLIRank 目前仍处于早期阶段。如果它能帮助你的 Agent 选择 API，或者它出现了错误，请发送反馈至 [email protected]，或在 X 上联系 @alexclapp10。