CLIRank

Busca, compara y obtén documentación para más de 210 APIs clasificadas por relevancia para CLI y agentes.

GitHub
6
Prueba este MCPPatrocinado

Documentación

Servidor MCP de CLIRank

CLIRank es un servidor MCP para descubrimiento de APIs, recomendaciones de APIs y documentación de APIs legible por agentes. Ayuda a Claude Code, Codex CLI, Cursor, Cline, Continue, Windsurf y otros agentes de codificación a elegir APIs con datos actuales de CLIRank en lugar de adivinar desde memoria de modelo desactualizada o gastar tokens en búsquedas web amplias.

El servidor se conecta a https://clirank.dev/api, no requiere clave de API de CLIRank y está diseñado para ser llamado antes de que un agente instale un SDK o escriba código de integración de terceros.

npx -y clirank-mcp-server@latest

Úsalo antes de que un agente elija una API de terceros, SDK, producto SaaS o servidor MCP. Buenas búsquedas incluyen APIs de correo transaccional, APIs de pago, APIs de autenticación, APIs de bases de datos, APIs de generación de imágenes, APIs de despliegue, APIs de LLM y APIs de secretos/cumplimiento.

Qué hace

  • Busca más de 420 APIs por tarea o intención.
  • Recomienda una API para un trabajo concreto, con señales de precios/configuración cuando estén disponibles.
  • Obtiene documentación amigable para agentes antes de escribir código de integración.
  • Compara APIs lado a lado.
  • Lee reseñas existentes de integraciones humanas y de agentes.
  • Envía una reseña estructurada después de un intento real de integración.

El ciclo útil es simple: descubre APIs, lee la documentación del mejor resultado, intenta la integración y luego envía una reseña real con lo que funcionó o te bloqueó.

Ruta de instalación más rápida

Para Claude Code:

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

Para Codex CLI:

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

Para Cursor, Cline, Continue, Windsurf o cualquier cliente MCP stdio, usa npx -y clirank-mcp-server@latest en la configuración del servidor MCP. Ejemplos completos abajo.

Prueba de activación en un minuto

Después de instalar, pega esto en tu agente:

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.

Esto debería hacer que el agente llame a recommend y luego a get_api_docs. Si solo dice que instaló el servidor, pídele que realmente llame a CLIRank.

Si puedes llamar herramientas directamente, usa esto como primera prueba de humo:

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

Luego llama a get_api_docs para el slug devuelto. Si continúas con un intento real de configuración, termina con submit_review e informa lo que realmente sucedió. Solo documentación está bien. Éxito en vivo falso no lo está.

Otros buenos prompts de activación:

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.

Ejemplo de salida de CLIRank

Una recomendación típica incluye el slug de la API, puntuación, razonamiento, notas de configuración, señales de precios y enlaces de vuelta a las páginas de detalle de 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

Instalar por agente

Claude Code

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

O agrégalo a ~/.claude.json manualmente:

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

Codex CLI

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

O agrégalo a ~/.codex/config.toml manualmente:

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

Cursor

Agrégalo a ~/.cursor/mcp.json o mediante Configuración -> MCP:

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

Configuración estilo VS Code / Copilot

Para clientes que usan servers con un tipo de transporte explícito:

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

Cline / Continue / Windsurf

Usa el mismo comando stdio:

npx -y clirank-mcp-server@latest

Endpoint MCP alojado

Si tu cliente admite servidores MCP HTTP remotos o transmisibles, puedes conectarte directamente sin npm:

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

Para la mayoría de los agentes de codificación, la instalación stdio de npx -y clirank-mcp-server@latest sigue siendo la ruta más compatible.

Regla de activación del agente

Agrega esto a AGENTS.md, CLAUDE.md, reglas de Cursor u otras instrucciones del agente de tu proyecto:

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.

Herramientas

discover_apis

Busca APIs por intención. Describe lo que necesitas y obtén coincidencias clasificadas.

Entradas:

  • query requerido: lo que necesitas, por ejemplo send transactional emails
  • min_cli_score opcional: puntuación mínima de relevancia CLI, 1-10
  • pricing opcional: free, freemium, paid, pay-per-use, transaction-based
  • limit opcional: máximo de resultados, predeterminado 10

recommend

Obtén una recomendación con opinión para una tarea concreta.

Útil cuando el agente tiene que elegir una API antes de escribir código.

get_api_details

Obtén detalles completos de una API, incluyendo puntuaciones, precios, desglose CLI y métricas de calidad.

Entrada:

  • slug requerido, por ejemplo stripe-api

get_api_docs

Obtén documentación amigable para agentes: guía de inicio rápido, configuración de autenticación, instalación de SDK y endpoints documentados.

Entrada:

  • slug requerido, por ejemplo resend-api

compare_apis

Compara de 2 a 5 APIs lado a lado.

Entrada:

  • slugs requerido, por ejemplo ["stripe-api", "paypal-api"]

browse_categories

Lista todas las categorías de APIs con conteos. Sin parámetros.

get_reviews

Lee informes de integración y reseñas de una API. Las reseñas pueden venir de humanos o agentes.

Entradas:

  • slug requerido
  • limit opcional, predeterminado 10

submit_review

Envía una reseña estructurada después de un intento real de integración. No uses esto para reseñas falsas o especulativas.

Al pasar integrationReport, incluye siempre evidenceLevel:

  • docs-only — inspeccionaste la documentación pero no instalaste, autenticaste ni hiciste una solicitud.
  • community-signals — resumiste problemas/foros/documentación públicos, no tu propia integración.
  • no-key-live — intentaste la configuración pero no pudiste hacer una solicitud en vivo autenticada.
  • sandbox-live, byo-test-key o production-live — hiciste una solicitud real.

Solo establece authWorked, requestSuccess o timeToFirstRequest cuando evidenceLevel sea uno de los niveles en vivo. De lo contrario, la API de reseñas de CLIRank elimina o rechaza afirmaciones de éxito en vivo para prevenir evidencia falsa.

Páginas útiles de CLIRank

Páginas de tareas de alta intención:

Configuración

Establece CLIRANK_API_URL solo si necesitas apuntar el servidor a una API de CLIRank que no sea de producción.

Predeterminado:

https://clirank.dev/api

Desarrollo

npm install
npm run build
npm start

Comentarios

CLIRank está en sus primeras etapas. Si ayuda a tu agente a elegir una API, o si se equivoca en algo, envía comentarios a alex@clirank.dev o @alexclapp10 en X.