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ón | Llamada | |
|---|---|---|
| Listar las palabras clave | GET /sites/{siteId}/keywords | Gratis |
| Añadir una palabra clave | POST /sites/{siteId}/keywords | Gratis |
| Modificar una palabra clave | PATCH /sites/{siteId}/keywords/{keywordId} | Gratis |
| Eliminar una palabra clave | DELETE /sites/{siteId}/keywords/{keywordId} | Gratis |
Listar las palabras clave
/sites/{siteId}/keywordsGratisLas 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
| Argumento | Tipo | Descripción |
|---|---|---|
siteIden la ruta | string | Su id. |
curl https://app.semchat.io/api/v1/sites/{siteId}/keywords \
-H "Authorization: Bearer sk_live_…"{
"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
/sites/{siteId}/keywordsGratisAñ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
| Argumento | Tipo | Descripción |
|---|---|---|
siteIden la ruta | string | Su id. |
keywordobligatorio | string | La palabra clave.1–255 caracteres |
volumeopcional | string | null | Su volumen de búsqueda mensual, si se conoce. |
difficultyopcional | string | null | Su dificultad, 0–100, si se conoce. |
intentopcional | string | null | informational, commercial, transactional o navigational. |
priorityopcional | string | high, medium (por defecto) o low.high | medium | low |
rationaleopcional | string | null | Por qué apuntar a ella. |
source_langopcional | string | El idioma en que está escrito el texto (p. ej. "fr", "en"). Si se omite: el idioma del contenido del sitio.2–5 caracteres |
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
/sites/{siteId}/keywords/{keywordId}GratisCambia 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
| Argumento | Tipo | Descripción |
|---|---|---|
siteIden la ruta | string | Su id. |
keywordIden la ruta | string | Su id. |
keywordopcional | string | 1–255 caracteres |
volumeopcional | string | null | |
difficultyopcional | string | null | |
intentopcional | string | null | |
priorityopcional | string | high | medium | low |
rationaleopcional | string | null | |
source_langopcional | string | El idioma de la nueva palabra clave o de la nueva justificación. Se ignora si ninguna de las dos cambia.2–5 caracteres |
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
/sites/{siteId}/keywords/{keywordId}GratisQuita una palabra clave objetivo del sitio.
Herramienta MCP delete_keyword
| Argumento | Tipo | Descripción |
|---|---|---|
siteIden la ruta | string | Su id. |
keywordIden la ruta | string | Su id. |
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.

