MCP de Bison

Crear o editar un competidor

Edición

save_competitor

Crea un competidor de la marca, dentro del límite de competidores del plan, o edita uno existente por su id (de list_competitors). Para crear, name y website_url son obligatorios. Al editar, solo cambian los campos enviados; una lista reemplaza a la guardada. Los alias sirven para reconocer menciones con otro nombre y cuentan desde la próxima corrida semanal. Sin confirm devuelve la vista previa.

Permiso: Edición. Requiere un token de «Lectura y edición».

Cambia datos

Modifica información de tu empresa en Bison. Tu agente debería pedirte confirmación antes de usarla.

Parámetros

Nombre	Tipo	Obligatorio	Descripción
`competitor_id`	texto	No	id de list_competitors para editar; omítelo para crear uno.
`name`	texto (1 a 120 caracteres)	No	Nombre de la marca competidora, como la nombra la IA. Obligatorio al crear.
`website_url`	texto (3 a 300 caracteres)	No	Sitio principal, por ejemplo rival.cl. Se guarda solo el dominio. Obligatorio al crear.
`aliases`	lista (hasta 20 elementos, de hasta 80 caracteres cada uno)	No	Otros nombres con que aparece (siglas, nombre comercial, sin tildes). Evita alias de 3 letras o menos: calzan dentro de otras palabras.
`website_urls_extra`	lista (hasta 10 elementos, de hasta 300 caracteres cada uno)	No	Otros dominios de la misma marca, por ejemplo el de otro país.
`competitor_type`	una de `direct`, `indirect`	No	direct: vende lo mismo; indirect: resuelve la misma necesidad de otra forma. direct al crear.
`status`	una de `active`, `inactive`	No	inactive deja de compararlo sin borrarlo. active al crear.
`confirm`	booleano	No	false u omitido: solo devuelve la vista previa sin guardar. true: lo hace.

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": "save_competitor",
    "arguments": {
      "name": "<name>"
    }
  }
}

Ejemplo de vista previa

Sin confirm, con {"name":"Rival Tres","website_url":"rival-tres.example","aliases":["R3","Rival 3"]}, no guarda nada y devuelve esto, para una marca ficticia («Altavista Seguros»). Para guardar, repite la llamada con confirm: true.

{
  "saved": false,
  "changed": true,
  "id": null,
  "created": true,
  "quota": {
    "used": 2,
    "limit": 20
  },
  "changes": {
    "company_name": {
      "before": null,
      "after": "Rival Tres"
    },
    "website_url": {
      "before": null,
      "after": "https://rival-tres.example"
    },
    "aliases": {
      "before": null,
      "after": [
        "R3",
        "Rival 3"
      ]
    }
  },
  "warnings": [
    "Alias muy cortos (R3): pueden aparecer dentro de otras palabras y contar menciones falsas."
  ],
  "notes": "Vista previa: no se guardó nada. Muéstrale el cambio al usuario y repite la llamada con confirm: true para guardarlo. Los alias cuentan desde la próxima corrida semanal."
}