Strumenti AI Rank Lab, all'interno del tuo agente AI

Introduzione

Endpoint e autenticazione

POST https://www.airanklab.com/api/v1/mcp

Claude.ai (App Web)

To connect the MCP server directly in the Claude.ai web interface, open the Aggiungi connettore personalizzato dialog. Claude.ai does not support custom headers, so your credentials go in the URL query string instead.

Paste the following URL into the URL del server MCP remoto field, replacing the placeholders with your actual API key and secret. Leave the Advanced OAuth fields blank.

https://www.airanklab.com/api/v1/mcp?x-api-key=YOUR_API_KEY&x-api-secret=YOUR_API_SECRET

Claude Code

Un comando aggiunge il server a Claude Code (CLI v1.x o successiva):

claude mcp add --transport http airanklab https://www.airanklab.com/api/v1/mcp \
  --header "x-api-key: YOUR_API_KEY" \
  --header "x-api-secret: YOUR_API_SECRET"

Then ask Claude Code things like “esegui il controllo SEO + AEO + GEO su example.com e riassumi i problemi critici” or “chi viene citato da Google's AI Overview per ‘miglior CRM per startup’ in India su mobile?” — it will call the seo-aeo-geo-audit and google-ai-overview tools for you.

Claude Desktop

Add this to your Claude Desktop configuration (Impostazioni → Sviluppatore → Modifica Config, file claude_desktop_config.json), then restart the app:

{
  "mcpServers": {
    "airanklab": {
      "url": "https://www.airanklab.com/api/v1/mcp",
      "headers": {
        "x-api-key": "YOUR_API_KEY",
        "x-api-secret": "YOUR_API_SECRET"
      }
    }
  }
}

Cursor

Add the same block to ~/.cursor/mcp.json (global) or .cursor/mcp.json in your project:

{
  "mcpServers": {
    "airanklab": {
      "url": "https://www.airanklab.com/api/v1/mcp",
      "headers": {
        "x-api-key": "YOUR_API_KEY",
        "x-api-secret": "YOUR_API_SECRET"
      }
    }
  }
}

Strumenti disponibili e prezzi

Gli strumenti MCP rispecchiano gli endpoint degli strumenti REST uno a uno e spendono lo stesso saldo crediti — uno strumento costa lo stesso sia che lo si chiami dalla dashboard, dall'API REST o da MCP. Le letture dei dati sono gratuite; le chiamate a strumenti fallite vengono rimborsate automaticamente.

The three Google tools (google-search, google-ai-overview, google-ai-mode) take a paese and a dispositivo— name the country (“India”), its ISO code (“IN”) or its numeric location code (2356), and pick desktop or mobile. Results differ markedly between the two, so measure the one your buyers actually use. The search-locations tool lists every supported market. The GA4 and Search Console tools are free because they read your own Google data — connect those accounts in the dashboard first.

ai-citation-check asks ChatGPT, Perplexity, Claude and Gemini the same question in one call and reports which of them cite you — it is billed per engine, so naming fewer engines costs less. The backlink tools (backlinks-overview, backlinks-history, backlinks-list, domini-di-riferimento, testo-di-ancoraggio, autorità-di-dominio-in-blocco) work on qualsiasidomain, not just the ones registered on your account, so an agent can research a competitor’s link profile directly. The free filtri-backlink tool lists the presets, modes and fields the filtered backlink queries accept.

Strumenti a lunga esecuzione

Limiti di frequenza

MCP requests count against the same per-key limit as the REST API: 60 richieste al minuto by default. A 429 response includes Riprova dopo. Need a higher limit? Contattaci.

Risorse correlate

• Riferimento API REST — full endpoint documentation with request/response samples.
• Specifica OpenAPI (JSON) — machine-readable schema for codegen.
• Raccolta Postman — ready-made requests for every endpoint.
• Area di test API — try every endpoint live from the dashboard.