# Comparar con competidores

`compare_competitors`

Tabla de la marca y sus competidores en la última semana, ordenada por share of voice. Sirve para ver quién aparece más que la marca y en qué modelo.

**Permiso:** Lectura. Funciona con cualquier token.

## Parámetros

| Nombre | Tipo | Obligatorio | Descripción |
| --- | --- | --- | --- |
| `model` | una de `total`, `chatgpt`, `claude`, `gemini`, `perplexity` | No | Modelo a comparar; total (todos) por defecto. |

## Ejemplo de llamada

No tienes que escribir esto: tu agente decide cuándo usar la herramienta según lo que le pidas. Es la llamada MCP equivalente, con valores de relleno:

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "compare_competitors",
    "arguments": {}
  }
}
```

## Ejemplo de respuesta

Lo que devuelve con sin parámetros, para una marca ficticia («Altavista Seguros»). Tu respuesta tendrá los datos de tu empresa.

```json
{
  "week": "2026-10-12",
  "model": "total",
  "brands": [
    {
      "rank": 1,
      "brand": "rival-uno.example",
      "isClient": false,
      "shareOfVoice": 42,
      "mentionRate": 66,
      "avgPosition": null,
      "positiveSentiment": null
    },
    {
      "rank": 2,
      "brand": "Altavista Seguros",
      "isClient": true,
      "shareOfVoice": 31,
      "mentionRate": 52,
      "avgPosition": 2.1,
      "positiveSentiment": 82
    },
    {
      "rank": 3,
      "brand": "rival-dos.example",
      "isClient": false,
      "shareOfVoice": 17,
      "mentionRate": 31,
      "avgPosition": null,
      "positiveSentiment": null
    },
    {
      "rank": 4,
      "brand": "comparador.example",
      "isClient": false,
      "shareOfVoice": 5,
      "mentionRate": 12,
      "avgPosition": null,
      "positiveSentiment": null
    }
  ],
  "trackedCompetitorsNotSeen": 0
}
```