DocumentaciónReferencia de la API

Palabras clave

Las palabras clave de un sitio: listarlas, añadirlas, cambiarlas y eliminarlas.

Cada operación de esta página es también una herramienta MCP, con el mismo nombre. Las marcadas Gratis no cuestan nada; las marcadas De pago usan los créditos del espacio, como en la aplicación (Cuánto cuesta).

OperaciónLlamada
Listar las palabras claveGET /sites/{siteId}/keywordsGratis
Añadir una palabra clavePOST /sites/{siteId}/keywordsGratis
Modificar una palabra clavePATCH /sites/{siteId}/keywords/{keywordId}Gratis
Eliminar una palabra claveDELETE /sites/{siteId}/keywords/{keywordId}Gratis

Listar las palabras clave

GET/sites/{siteId}/keywordsGratis

Las palabras clave objetivo del sitio, de su análisis o añadidas a mano, con su volumen, su dificultad y su posición actual.

  • El texto se devuelve tal como está guardado, en el idioma en que se escribió (source_lang; null = el idioma del contenido del sitio). La aplicación lo traduce al mostrarlo; la API no.

Herramienta MCP list_keywords

ArgumentoTipoDescripción
siteIden la rutastringSu id.
Petición
curl https://app.semchat.io/api/v1/sites/{siteId}/keywords \
  -H "Authorization: Bearer sk_live_…"
Respuesta · 200
{
  "data": [
    {
      "id": "01a15ea4-c1e0-7957-b667-9b025ed3641e",
      "keyword": "agence seo lyon",
      "volume": 1900,
      "difficulty": 45,
      "cpc": 1.8,
      "competition": 40,
      "current_position": 4,
      "traffic": 475,
      "url": "https://alpha.example.com/services",
      "intent": "commercial",
      "priority": "high",
      "rationale": "Opportunité sur « agence seo lyon ».",
      "source": "auto",
      "source_lang": "fr",
      "created_at": "2026-10-21T13:26:58.000Z"
    },
    {
      "id": "01a15ea4-c1e0-7e93-9a50-38742b693311",
      "keyword": "audit seo",
      "volume": 2400,
      "difficulty": 60,
      "cpc": 1.8,
      "competition": 40,
      "current_position": 12,
      "traffic": 200,
      "url": "https://alpha.example.com/services",
      "intent": "commercial",
      "priority": "high",
      "rationale": "Opportunité sur « audit seo ».",
      "source": "auto",
      "source_lang": "fr",
      "created_at": "2026-10-21T13:26:58.000Z"
    }
  ]
}

Añadir una palabra clave

POST/sites/{siteId}/keywordsGratis

Añade una palabra clave objetivo al sitio.

  • Se guarda tal cual, como palabra clave manual: no se obtiene ningún dato de palabras clave (no se factura nada). Responde con la palabra clave.

Herramienta MCP add_keyword

ArgumentoTipoDescripción
siteIden la rutastringSu id.
keywordobligatoriostringLa palabra clave.1–255 caracteres
volumeopcionalstring | nullSu volumen de búsqueda mensual, si se conoce.
difficultyopcionalstring | nullSu dificultad, 0–100, si se conoce.
intentopcionalstring | nullinformational, commercial, transactional o navigational.
priorityopcionalstringhigh, medium (por defecto) o low.high | medium | low
rationaleopcionalstring | nullPor qué apuntar a ella.
source_langopcionalstringEl idioma en que está escrito el texto (p. ej. "fr", "en"). Si se omite: el idioma del contenido del sitio.2–5 caracteres
Petición
curl -X POST https://app.semchat.io/api/v1/sites/{siteId}/keywords \
  -H "Authorization: Bearer sk_live_…" \
  -H "Content-Type: application/json" \
  -d '{"keyword": "…"}'

Responde 201 con { "data": … }.

Modificar una palabra clave

PATCH/sites/{siteId}/keywords/{keywordId}Gratis

Cambia una palabra clave objetivo: la palabra clave, sus cifras, su intención, su prioridad o su justificación.

  • Responde con la palabra clave tal como queda.

Herramienta MCP update_keyword

ArgumentoTipoDescripción
siteIden la rutastringSu id.
keywordIden la rutastringSu id.
keywordopcionalstring1–255 caracteres
volumeopcionalstring | null
difficultyopcionalstring | null
intentopcionalstring | null
priorityopcionalstringhigh | medium | low
rationaleopcionalstring | null
source_langopcionalstringEl idioma de la nueva palabra clave o de la nueva justificación. Se ignora si ninguna de las dos cambia.2–5 caracteres
Petición
curl -X PATCH https://app.semchat.io/api/v1/sites/{siteId}/keywords/{keywordId} \
  -H "Authorization: Bearer sk_live_…" \
  -H "Content-Type: application/json" \
  -d '{"keyword": "…"}'

Responde 200 con { "data": … }.

Eliminar una palabra clave

DELETE/sites/{siteId}/keywords/{keywordId}Gratis

Quita una palabra clave objetivo del sitio.

Herramienta MCP delete_keyword

ArgumentoTipoDescripción
siteIden la rutastringSu id.
keywordIden la rutastringSu id.
Petición
curl -X DELETE https://app.semchat.io/api/v1/sites/{siteId}/keywords/{keywordId} \
  -H "Authorization: Bearer sk_live_…"

Responde 204 con { "data": … }.

¿No encuentras la respuesta? Escríbenos.

¿Listo para impulsar tu web?

Haz tu primera pregunta - semchat te responde con un plan de acción claro en segundos.

Gratis · sin registro · en 5 segundos