Comparar dos semanas

Compara dos semanas medidas: métricas total y por modelo, share of voice de cada competidor y las preguntas que más subieron o bajaron. Sin argumentos compara la última semana con la anterior.

Permiso: Lectura. Funciona con cualquier token.

Parámetros

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:

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "compare_weeks",
    "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.

{
  "company": "Altavista Seguros",
  "week": "2026-10-12",
  "comparedWith": "2026-10-05",
  "weeksBetween": 1,
  "scopes": [
    {
      "model": "total",
      "current": {
        "visibility": 46,
        "mentionRate": 52,
        "shareOfVoice": 31,
        "avgPosition": 2.1,
        "citationRate": 24,
        "positiveSentiment": 82,
        "executions": 48
      },
      "previous": {
        "visibility": 40,
        "mentionRate": 47,
        "shareOfVoice": 27,
        "avgPosition": 2.1,
        "citationRate": 19,
        "positiveSentiment": 82,
        "executions": 48
      },
      "change": {
        "visibility": 6,
        "mentionRate": 5,
        "shareOfVoice": 4,
        "citationRate": 5
      }
    },
    {
      "model": "chatgpt",
      "current": {
        "visibility": 51,
        "mentionRate": 58,
        "shareOfVoice": 36,
        "avgPosition": 2.1,
        "citationRate": 30,
        "positiveSentiment": 82,
        "executions": 12
      },
      "previous": {
        "visibility": 45,
        "mentionRate": 52,
        "shareOfVoice": 31,
        "avgPosition": 2.1,
        "citationRate": 24,
        "positiveSentiment": 82,
        "executions": 12
      },
      "change": {
        "visibility": 6,
        "mentionRate": 6,
        "shareOfVoice": 5,
        "citationRate": 6
      }
    },
    {
      "model": "claude",
      "current": {
        "visibility": 44,
        "mentionRate": 50,
        "shareOfVoice": 28,
        "avgPosition": 2.1,
        "citationRate": 22,
        "positiveSentiment": 82,
        "executions": 12
      },
      "previous": {
        "visibility": 38,
        "mentionRate": 45,
        "shareOfVoice": 25,
        "avgPosition": 2.1,
        "citationRate": 17,
        "positiveSentiment": 82,
        "executions": 12
      },
      "change": {
        "visibility": 6,
        "mentionRate": 5,
        "shareOfVoice": 3,
        "citationRate": 5
      }
    },
    {
      "model": "gemini",
      "current": {
        "visibility": 41,
        "mentionRate": 50,
        "shareOfVoice": 29,
        "avgPosition": 2.1,
        "citationRate": 22,
        "positiveSentiment": 82,
        "executions": 12
      },
      "previous": {
        "visibility": 37,
        "mentionRate": 45,
        "shareOfVoice": 25,
        "avgPosition": 2.1,
        "citationRate": 17,
        "positiveSentiment": 82,
        "executions": 12
      },
      "change": {
        "visibility": 4,
        "mentionRate": 5,
        "shareOfVoice": 4,
        "citationRate": 5
      }
    },
    {
      "model": "perplexity",
      "current": {
        "visibility": 47,
        "mentionRate": 50,
        "shareOfVoice": 31,
        "avgPosition": 2.1,
        "citationRate": 22,
        "positiveSentiment": 82,
        "executions": 12
      },
      "previous": {
        "visibility": 40,
        "mentionRate": 46,
        "shareOfVoice": 27,
        "avgPosition": 2.1,
        "citationRate": 18,
        "positiveSentiment": 82,
        "executions": 12
      },
      "change": {
        "visibility": 7,
        "mentionRate": 4,
        "shareOfVoice": 4,
        "citationRate": 4
      }
    }
  ],
  "competitors": [
    {
      "brand": "rival-uno.example",
      "shareOfVoice": 42,
      "previousShareOfVoice": 44,
      "change": -2
    },
    {
      "brand": "rival-dos.example",
      "shareOfVoice": 17,
      "previousShareOfVoice": 15,
      "change": 2
    },
    {
      "brand": "comparador.example",
      "shareOfVoice": 5,
      "previousShareOfVoice": 4,
      "change": 1
    }
  ],
  "promptsCompared": 2,
  "biggestDrops": [
    {
      "id": "pr_mejor_seguro_auto",
      "text": "¿Cuál es el mejor seguro de auto en Chile?",
      "visibility": 38,
      "previousVisibility": 52,
      "change": -14
    }
  ],
  "biggestGains": [
    {
      "id": "pr_seguro_barato",
      "text": "¿Dónde contratar un seguro de auto barato?",
      "visibility": 61,
      "previousVisibility": 44,
      "change": 17
    }
  ],
  "notes": "change es la diferencia en puntos porcentuales (semana actual menos la comparada). Las preguntas usan el puntaje total de cada semana."
}