DocumentaciónReferencia de la API

Sitios

Los sitios, su análisis, su salud y su accesibilidad.

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 los sitiosGET /sitesGratis
Crear un sitioPOST /sitesGratis
Obtener un sitioGET /sites/{siteId}Gratis
Analizar un sitioPOST /sites/{siteId}/analyzeDe pago
Listar los conectores de un sitioGET /sites/{siteId}/connectorsGratis
Modificar un sitioPATCH /sites/{siteId}Gratis
Eliminar un sitioDELETE /sites/{siteId}Gratis
Marcar un sitio como favoritoPATCH /sites/{siteId}/favoriteGratis
Obtener la salud de un sitioGET /sites/{siteId}/healthGratis
Obtener la accesibilidad de un sitioGET /sites/{siteId}/accessibilityGratis
Obtener una regla de accesibilidadGET /sites/{siteId}/accessibility/{ruleId}Gratis

Listar los sitios

GET/sitesGratis

Todos los sitios del espacio.

Herramienta MCP list_sites

Petición
curl https://app.semchat.io/api/v1/sites \
  -H "Authorization: Bearer sk_live_…"
Respuesta · 200
{
  "data": [
    {
      "id": "01a08133-4de0-7b5b-87f5-c4c169f01517",
      "name": "Alpha Conseil",
      "site_url": "https://alpha.example.com",
      "analysis_status": "ready",
      "created_at": "2026-09-08T13:26:58.000Z"
    },
    {
      "id": "01a0ce72-b1e0-738d-9205-34630681ef77",
      "name": "Beta Shop",
      "site_url": "https://beta.example.com",
      "analysis_status": "idle",
      "created_at": "2026-09-23T13:26:58.000Z"
    }
  ]
}

Crear un sitio

POST/sitesGratis

Crea un sitio y, si quieres, lanza su análisis.

Herramienta MCP create_site

ArgumentoTipoDescripción
nameobligatoriostringEl nombre del sitio.1–255 caracteres
site_urlopcionalstringSu dirección. Necesaria para un análisis.hasta 500 caracteres
descriptionopcionalstringhasta 2000 caracteres
auto_analyzeopcionalbooleanLanza el análisis al momento (de pago). Se omite sin créditos: needs_credits es entonces true.
Petición
curl -X POST https://app.semchat.io/api/v1/sites \
  -H "Authorization: Bearer sk_live_…" \
  -H "Content-Type: application/json" \
  -d '{"name": "…"}'
Respuesta · 201
{
  "data": {
    "id": "01a168f1-9d83-7253-a7ec-af716d6279e1",
    "analysis_status": "idle",
    "needs_credits": false
  }
}

Obtener un sitio

GET/sites/{siteId}Gratis

Un sitio, con todo lo que guardó su último análisis (resumen, salud, accesibilidad, palabras clave…).

Herramienta MCP get_site

ArgumentoTipoDescripción
siteIden la rutastringSu id.
Petición
curl https://app.semchat.io/api/v1/sites/{siteId} \
  -H "Authorization: Bearer sk_live_…"
Respuesta · 200
{
  "data": {
    "id": "01a08133-4de0-7b5b-87f5-c4c169f01517",
    "name": "Alpha Conseil",
    "site_url": "https://alpha.example.com",
    "description": null,
    "analysis_status": "ready",
    "analysis_stage": null,
    "last_analyzed_at": "2026-10-21T13:26:58.000Z",
    "site_context": {
      "description": "Alpha Conseil, agence de référencement naturel pour les PME lyonnaises.",
      "platform": "inconnu",
      "language": "fr",
      "country": "FR",
      "positioning": "Le SEO durable et expliqué sans jargon pour les PME.",
      "primaryTopics": [
        "audit SEO",
        "contenus"
      ],
      "targetKeywords": [
        "…",
        "…"
      ],
      "kpis": {
        "organic_traffic_estimate": 1840,
        "keywords_count": 312,
        "authority_score": null
      },
      "suggestedInstructions": "Parle simplement à des dirigeants de PME non techniques.",
      "analyzedAt": "2026-10-21T13:26:58.272Z",
      "contentLang": "fr",
      "health": {
        "score": 72,
        "label": "good",
        "pagesChecked": 6,
        "items": [
          "…",
          "…"
        ],
        "checkedAt": "2026-10-21T13:26:58.272Z"
      },
      "accessibility": {
        "score": 78,
        "totalIssues": 4,
        "byLevel": "…",
        "findings": [
          "…",
          "…"
        ],
        "checkedAt": "2026-10-21T13:26:58.272Z"
      },
      "pageVisibility": {
        "checkedPages": 6,
        "indexable": 6,
        "noindex": 0,
        "visibleButShouldnt": "…",
        "hiddenButShould": "…",
        "checkedAt": "2026-10-21T13:26:58.272Z"
      },
      "actionPlan": {
        "scorecard": "…",
        "focus": "…",
        "priorityOrder": [
          "content",
          "backlinks"
        ],
        "summary": "Un site sain qui manque de contenus et de liens.",
        "generatedAt": "2026-10-21T13:26:58.272Z"
      }
    },
    "instructions": null,
    "writing_style": null,
    "technologies": [],
    "favorite": false,
    "created_at": "2026-09-08T13:26:58.000Z"
  }
}

Analizar un sitio

POST/sites/{siteId}/analyzeDe pago

Lanza (o vuelve a lanzar) el análisis completo del sitio: rastreo, salud técnica, competidores, palabras clave, plan de acción.

  • Se ejecuta en segundo plano (unos minutos): consulta get_site hasta que analysis_status sea ready o error.
  • Se factura exactamente como un análisis lanzado en la aplicación. 402 INSUFFICIENT_TOKENS sin créditos.
  • Un nuevo análisis conserva el plan de acción existente y añade lo nuevo.

Herramienta MCP analyze_site

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

Responde 202 con { "data": … }.

Listar los conectores de un sitio

GET/sites/{siteId}/connectorsGratis

Las herramientas conectadas a este sitio.

Herramienta MCP list_site_connectors

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

Responde 200 con { "data": … }.

Modificar un sitio

PATCH/sites/{siteId}Gratis

Modifica los ajustes del sitio: nombre, dirección, descripción, instrucciones, estilo de redacción, tecnologías.

  • Solo cambian los campos indicados. Responde con el sitio y sus ajustes.
  • Cambiar la dirección no vuelve a lanzar el análisis: para eso, llama a analyze_site.

Herramienta MCP update_site

ArgumentoTipoDescripción
siteIden la rutastringSu id.
nameopcionalstringEl nombre del sitio (no puede quedar vacío).1–255 caracteres
site_urlopcionalstring | nullSu dirección. Vacío o null la borra.
descriptionopcionalstring | nullVacío o null la borra.
instructionsopcionalstring | nullLo que el asistente tiene en cuenta para este sitio. Vacío o null las borra.
writing_styleopcionalstring | nullLa voz de los artículos escritos para el sitio; null lo borra.
technologiesopcionalarrayLas tecnologías con las que funciona el sitio (sus claves); [] las borra.
Petición
curl -X PATCH https://app.semchat.io/api/v1/sites/{siteId} \
  -H "Authorization: Bearer sk_live_…" \
  -H "Content-Type: application/json" \
  -d '{"name": "…"}'

Responde 200 con { "data": … }.

Eliminar un sitio

DELETE/sites/{siteId}Gratis

Elimina el sitio.

  • Borrado lógico, como en la aplicación: el sitio sale de las listas y sus endpoints responden 404. Nada más cambia: sus conversaciones, documentos y datos guardados se conservan.

Herramienta MCP delete_site

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

Responde 200 con { "data": … }.

Marcar un sitio como favorito

PATCH/sites/{siteId}/favoriteGratis

Marca o desmarca el sitio con una estrella.

  • Marcarlo no cuenta como actividad: el sitio mantiene su lugar en el orden «Actividad».

Herramienta MCP set_site_favorite

ArgumentoTipoDescripción
siteIden la rutastringSu id.
favoriteobligatoriobooleantrue lo marca con una estrella, false se la quita.
Petición
curl -X PATCH https://app.semchat.io/api/v1/sites/{siteId}/favorite \
  -H "Authorization: Bearer sk_live_…" \
  -H "Content-Type: application/json" \
  -d '{"favorite": true}'

Responde 200 con { "data": … }.

Obtener la salud de un sitio

GET/sites/{siteId}/healthGratis

La salud técnica del sitio: la puntuación y los problemas del último análisis, el historial de la puntuación y qué recuentos de problemas han cambiado desde el análisis anterior.

Herramienta MCP get_site_health

ArgumentoTipoDescripción
siteIden la rutastringSu id.
Petición
curl https://app.semchat.io/api/v1/sites/{siteId}/health \
  -H "Authorization: Bearer sk_live_…"
Respuesta · 200
{
  "data": {
    "health": {
      "score": 72,
      "label": "good",
      "pages_checked": 6,
      "items": [
        "…",
        "…"
      ],
      "checked_at": "2026-10-21T13:26:58.272Z"
    },
    "history": [
      {
        "score": 61,
        "label": "fair",
        "pages_checked": 6,
        "analyzed_at": "2026-09-23T13:26:58.000Z"
      },
      {
        "score": 72,
        "label": "good",
        "pages_checked": 6,
        "analyzed_at": "2026-10-21T13:26:58.000Z"
      }
    ],
    "changes": [
      {
        "key": "noDescription",
        "before": 3,
        "after": 1
      },
      {
        "key": "thin",
        "before": 3,
        "after": 2
      }
    ]
  }
}

Obtener la accesibilidad de un sitio

GET/sites/{siteId}/accessibilityGratis

La accesibilidad del sitio (WCAG 2.1 A y AA): la puntuación y los hallazgos por regla del último análisis, y el historial de la puntuación.

Herramienta MCP get_site_accessibility

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

Responde 200 con { "data": … }.

Obtener una regla de accesibilidad

GET/sites/{siteId}/accessibility/{ruleId}Gratis

Todas las páginas en las que falla una regla de accesibilidad (el rule_id de un hallazgo), con los elementos que fallan.

  • pages tiene un tope; page_count es el número exacto de páginas afectadas.

Herramienta MCP get_accessibility_rule

ArgumentoTipoDescripción
siteIden la rutastringSu id.
ruleIden la rutastringSu id.
Petición
curl https://app.semchat.io/api/v1/sites/{siteId}/accessibility/{ruleId} \
  -H "Authorization: Bearer sk_live_…"

Responde 200 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