DocumentaciónReferencia de la API

Plan de acción

El plan de acción de un sitio: listar, añadir, cambiar y eliminar sus tareas.

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 tareasGET /sites/{siteId}/todosGratis
Crear una tareaPOST /sites/{siteId}/todosGratis
Modificar una tareaPATCH /sites/{siteId}/todos/{todoId}Gratis
Eliminar una tareaDELETE /sites/{siteId}/todos/{todoId}Gratis

Listar las tareas

GET/sites/{siteId}/todosGratis

El plan de acción del sitio.

Herramienta MCP list_todos

ArgumentoTipoDescripción
siteIden la rutastringSu id.
Petición
curl https://app.semchat.io/api/v1/sites/{siteId}/todos \
  -H "Authorization: Bearer sk_live_…"
Respuesta · 200
{
  "data": [
    {
      "id": "01a15ea4-c1e0-7c64-bc14-c499bd6f1b83",
      "title": "Corriger le point technical n°1",
      "description": "Corriger le point technical n°1 - détail.",
      "category": "technical",
      "priority": "high",
      "status": "a_faire",
      "source": "audit_auto",
      "created_at": "2026-10-21T13:26:58.000Z"
    },
    {
      "id": "01a15ea4-c1e0-74b9-8ca0-f4c3410b0f0f",
      "title": "Corriger le point technical n°2",
      "description": "Corriger le point technical n°2 - détail.",
      "category": "technical",
      "priority": "medium",
      "status": "fait",
      "source": "audit_auto",
      "created_at": "2026-10-21T13:27:58.000Z"
    }
  ]
}

Crear una tarea

POST/sites/{siteId}/todosGratis

Añade una tarea al plan de acción del sitio.

  • Se añade como tarea manual (source manuel), pendiente (status a_faire). Responde con la tarea.

Herramienta MCP create_todo

ArgumentoTipoDescripción
siteIden la rutastringSu id.
titleobligatoriostringLo que hay que hacer.1–500 caracteres
descriptionopcionalstringhasta 4000 caracteres
priorityopcionalstringhigh, medium (por defecto) o low.high | medium | low
categoryopcionalstringEl pilar del plan al que pertenece. Por defecto, technical.technical | content | accessibility | backlinks | competitors
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}/todos \
  -H "Authorization: Bearer sk_live_…" \
  -H "Content-Type: application/json" \
  -d '{"title": "…"}'
Respuesta · 201
{
  "data": {
    "id": "01a168f1-9dac-7584-b809-fc4ed6d1cffe",
    "title": "Add alt text to the gallery images",
    "description": null,
    "category": "technical",
    "priority": "high",
    "status": "a_faire",
    "source": "manuel",
    "created_at": "2026-10-23T13:27:07.000Z"
  }
}

Modificar una tarea

PATCH/sites/{siteId}/todos/{todoId}Gratis

Cambia una tarea del plan de acción: su estado (pendiente, en curso, hecha, ignorada), su título, su descripción o su prioridad.

  • Responde con la tarea tal como queda.
  • 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 update_todo

ArgumentoTipoDescripción
siteIden la rutastringSu id.
todoIden la rutastringSu id.
statusopcionalstringa_faire (pendiente), en_cours (en curso), fait (hecha) o ignore (ignorada).a_faire | en_cours | fait | ignore
titleopcionalstring1–500 caracteres
descriptionopcionalstring | null
priorityopcionalstringhigh | medium | low
source_langopcionalstringEl idioma del nuevo título o de la nueva descripción. Se ignora si ninguno de los dos cambia.2–5 caracteres
Petición
curl -X PATCH https://app.semchat.io/api/v1/sites/{siteId}/todos/{todoId} \
  -H "Authorization: Bearer sk_live_…" \
  -H "Content-Type: application/json" \
  -d '{"status": "a_faire"}'

Responde 200 con { "data": … }.

Eliminar una tarea

DELETE/sites/{siteId}/todos/{todoId}Gratis

Quita una tarea del plan de acción.

Herramienta MCP delete_todo

ArgumentoTipoDescripción
siteIden la rutastringSu id.
todoIden la rutastringSu id.
Petición
curl -X DELETE https://app.semchat.io/api/v1/sites/{siteId}/todos/{todoId} \
  -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