CLIRank

Pesquise, compare e obtenha documentação para mais de 210 APIs classificadas por relevância para CLI e agentes.

GitHub
6
Experimente este MCPPatrocinado

Documentação

Servidor MCP CLIRank

CLIRank é um servidor MCP para descoberta de APIs, recomendações de APIs e documentação de APIs legível por agentes. Ele ajuda Claude Code, Codex CLI, Cursor, Cline, Continue, Windsurf e outros agentes de codificação a escolher APIs com dados atuais do CLIRank, em vez de adivinhar com base em memória desatualizada do modelo ou gastar tokens em buscas amplas na web.

O servidor se conecta a https://clirank.dev/api, não requer chave de API do CLIRank e foi projetado para ser chamado antes de um agente instalar um SDK ou escrever código de integração de terceiros.

npx -y clirank-mcp-server@latest

Use antes de um agente escolher uma API de terceiros, SDK, produto SaaS ou servidor MCP. Boas buscas incluem APIs de e-mail transacional, APIs de pagamento, APIs de autenticação, APIs de banco de dados, APIs de geração de imagens, APIs de implantação, APIs de LLM e APIs de segredos/conformidade.

O que ele faz

  • Busca em mais de 420 APIs por tarefa ou intenção.
  • Recomenda uma API para um trabalho concreto, com sinais de preço/configuração quando disponíveis.
  • Busca documentação amigável para agentes antes de escrever código de integração.
  • Compara APIs lado a lado.
  • Lê avaliações existentes de integrações humanas e de agentes.
  • Envia uma avaliação estruturada após uma tentativa real de integração.

O ciclo útil é simples: descubra APIs, leia a documentação do melhor resultado, tente a integração e, em seguida, envie uma avaliação real com o que funcionou ou o que bloqueou você.

Caminho de instalação mais rápido

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 ou qualquer cliente MCP stdio, use npx -y clirank-mcp-server@latest na configuração do servidor MCP. Exemplos completos estão abaixo.

Teste de ativação em um minuto

Após instalar, cole isto no seu 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.

Isso deve fazer o agente chamar recommend e depois get_api_docs. Se ele apenas disser que instalou o servidor, peça para ele realmente chamar o CLIRank.

Se você puder chamar ferramentas diretamente, use isto como primeiro teste de fumaça:

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

Em seguida, chame get_api_docs para o slug retornado. Se você continuar em uma tentativa real de configuração, termine com submit_review e relate o que realmente aconteceu. Somente documentação é aceitável. Sucesso ao vivo falso não é.

Outros prompts de ativação úteis:

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.

Exemplo de saída do CLIRank

Uma recomendação típica inclui o slug da API, pontuação, justificativa, notas de configuração, sinais de preço e links de volta para as páginas de detalhes do 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

Instalação por agente

Claude Code

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

Ou adicione manualmente ao ~/.claude.json:

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

Codex CLI

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

Ou adicione manualmente ao ~/.codex/config.toml:

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

Cursor

Adicione ao ~/.cursor/mcp.json ou via Configurações -> MCP:

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

Configuração estilo VS Code / Copilot

Para clientes que usam servers com um tipo de transporte explícito:

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

Cline / Continue / Windsurf

Use o mesmo comando stdio:

npx -y clirank-mcp-server@latest

Endpoint MCP hospedado

Se o seu cliente suporta servidores MCP HTTP remotos ou transmitíveis, você pode conectar diretamente sem npm:

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

Para a maioria dos agentes de codificação, a instalação stdio npx -y clirank-mcp-server@latest ainda é o caminho mais compatível.

Regra de ativação do agente

Adicione isto ao AGENTS.md, CLAUDE.md, regras do Cursor ou outras instruções do agente do seu projeto:

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.

Ferramentas

discover_apis

Busque APIs por intenção. Descreva o que você precisa e obtenha resultados classificados.

Entradas:

  • query obrigatório: o que você precisa, por exemplo send transactional emails
  • min_cli_score opcional: pontuação mínima de relevância da CLI, 1-10
  • pricing opcional: free, freemium, paid, pay-per-use, transaction-based
  • limit opcional: máximo de resultados, padrão 10

recommend

Obtenha uma recomendação opinativa para uma tarefa concreta.

Útil quando o agente precisa escolher uma API antes de escrever código.

get_api_details

Obtenha detalhes completos de uma API, incluindo pontuações, preços, detalhamento da CLI e métricas de qualidade.

Entrada:

  • slug obrigatório, por exemplo stripe-api

get_api_docs

Obtenha documentação amigável para agentes: guia de início rápido, configuração de autenticação, instalação do SDK e endpoints documentados.

Entrada:

  • slug obrigatório, por exemplo resend-api

compare_apis

Compare de 2 a 5 APIs lado a lado.

Entrada:

  • slugs obrigatório, por exemplo ["stripe-api", "paypal-api"]

browse_categories

Liste todas as categorias de APIs com contagens. Sem parâmetros.

get_reviews

Leia relatórios de integração e avaliações de uma API. As avaliações podem vir de humanos ou agentes.

Entradas:

  • slug obrigatório
  • limit opcional, padrão 10

submit_review

Envie uma avaliação estruturada após uma tentativa real de integração. Não use isto para avaliações falsas ou especulativas.

Ao passar integrationReport, sempre inclua evidenceLevel:

  • docs-only — você inspecionou a documentação, mas não instalou, autenticou ou fez uma solicitação.
  • community-signals — você resumiu problemas/fóruns/documentação públicos, não sua própria integração.
  • no-key-live — você tentou a configuração, mas não conseguiu fazer uma solicitação ao vivo autenticada.
  • sandbox-live, byo-test-key ou production-live — você fez uma solicitação real.

Somente defina authWorked, requestSuccess ou timeToFirstRequest quando evidenceLevel for um dos níveis ao vivo. Caso contrário, a API de avaliação do CLIRank remove ou rejeita alegações de sucesso ao vivo para evitar evidências falsas.

Páginas úteis do CLIRank

Páginas de tarefas de alta intenção:

Configuração

Defina CLIRANK_API_URL somente se você precisar apontar o servidor para uma API CLIRank que não seja de produção.

Padrão:

https://clirank.dev/api

Desenvolvimento

npm install
npm run build
npm start

Feedback

CLIRank está em fase inicial. Se ele ajudar seu agente a escolher uma API, ou se ele errar algo, envie feedback para alex@clirank.dev ou @alexclapp10 no X.