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ón | Llamada | |
|---|---|---|
| Listar los sitios | GET /sites | Gratis |
| Crear un sitio | POST /sites | Gratis |
| Obtener un sitio | GET /sites/{siteId} | Gratis |
| Analizar un sitio | POST /sites/{siteId}/analyze | De pago |
| Listar los conectores de un sitio | GET /sites/{siteId}/connectors | Gratis |
| Modificar un sitio | PATCH /sites/{siteId} | Gratis |
| Eliminar un sitio | DELETE /sites/{siteId} | Gratis |
| Marcar un sitio como favorito | PATCH /sites/{siteId}/favorite | Gratis |
| Obtener la salud de un sitio | GET /sites/{siteId}/health | Gratis |
| Obtener la accesibilidad de un sitio | GET /sites/{siteId}/accessibility | Gratis |
| Obtener una regla de accesibilidad | GET /sites/{siteId}/accessibility/{ruleId} | Gratis |
Listar los sitios
/sitesGratisTodos los sitios del espacio.
Herramienta MCP list_sites
curl https://app.semchat.io/api/v1/sites \
-H "Authorization: Bearer sk_live_…"{
"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
/sitesGratisCrea un sitio y, si quieres, lanza su análisis.
Herramienta MCP create_site
| Argumento | Tipo | Descripción |
|---|---|---|
nameobligatorio | string | El nombre del sitio.1–255 caracteres |
site_urlopcional | string | Su dirección. Necesaria para un análisis.hasta 500 caracteres |
descriptionopcional | string | hasta 2000 caracteres |
auto_analyzeopcional | boolean | Lanza el análisis al momento (de pago). Se omite sin créditos: needs_credits es entonces true. |
curl -X POST https://app.semchat.io/api/v1/sites \
-H "Authorization: Bearer sk_live_…" \
-H "Content-Type: application/json" \
-d '{"name": "…"}'{
"data": {
"id": "01a168f1-9d83-7253-a7ec-af716d6279e1",
"analysis_status": "idle",
"needs_credits": false
}
}Obtener un sitio
/sites/{siteId}GratisUn sitio, con todo lo que guardó su último análisis (resumen, salud, accesibilidad, palabras clave…).
Herramienta MCP get_site
| Argumento | Tipo | Descripción |
|---|---|---|
siteIden la ruta | string | Su id. |
curl https://app.semchat.io/api/v1/sites/{siteId} \
-H "Authorization: Bearer sk_live_…"{
"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
/sites/{siteId}/analyzeDe pagoLanza (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
| Argumento | Tipo | Descripción |
|---|---|---|
siteIden la ruta | string | Su id. |
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
/sites/{siteId}/connectorsGratisLas herramientas conectadas a este sitio.
Herramienta MCP list_site_connectors
| Argumento | Tipo | Descripción |
|---|---|---|
siteIden la ruta | string | Su id. |
curl https://app.semchat.io/api/v1/sites/{siteId}/connectors \
-H "Authorization: Bearer sk_live_…"Responde 200 con { "data": … }.
Modificar un sitio
/sites/{siteId}GratisModifica 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
| Argumento | Tipo | Descripción |
|---|---|---|
siteIden la ruta | string | Su id. |
nameopcional | string | El nombre del sitio (no puede quedar vacío).1–255 caracteres |
site_urlopcional | string | null | Su dirección. Vacío o null la borra. |
descriptionopcional | string | null | Vacío o null la borra. |
instructionsopcional | string | null | Lo que el asistente tiene en cuenta para este sitio. Vacío o null las borra. |
writing_styleopcional | string | null | La voz de los artículos escritos para el sitio; null lo borra. |
technologiesopcional | array | Las tecnologías con las que funciona el sitio (sus claves); [] las borra. |
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
/sites/{siteId}GratisElimina 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
| Argumento | Tipo | Descripción |
|---|---|---|
siteIden la ruta | string | Su id. |
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
/sites/{siteId}/favoriteGratisMarca 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
| Argumento | Tipo | Descripción |
|---|---|---|
siteIden la ruta | string | Su id. |
favoriteobligatorio | boolean | true lo marca con una estrella, false se la quita. |
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
/sites/{siteId}/healthGratisLa 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
| Argumento | Tipo | Descripción |
|---|---|---|
siteIden la ruta | string | Su id. |
curl https://app.semchat.io/api/v1/sites/{siteId}/health \
-H "Authorization: Bearer sk_live_…"{
"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
/sites/{siteId}/accessibilityGratisLa 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
| Argumento | Tipo | Descripción |
|---|---|---|
siteIden la ruta | string | Su id. |
curl https://app.semchat.io/api/v1/sites/{siteId}/accessibility \
-H "Authorization: Bearer sk_live_…"Responde 200 con { "data": … }.
Obtener una regla de accesibilidad
/sites/{siteId}/accessibility/{ruleId}GratisTodas 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
| Argumento | Tipo | Descripción |
|---|---|---|
siteIden la ruta | string | Su id. |
ruleIden la ruta | string | Su id. |
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.

