DocumentaciónReferencia de la API
Espacio de trabajo
El espacio, su uso, la búsqueda, las habilidades, las preferencias de herramientas y los conectores.
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 | |
|---|---|---|
| Obtener el espacio | GET /workspace | Gratis |
| Obtener el uso | GET /usage | Gratis |
| Listar las habilidades | GET /skills | Gratis |
| Listar los conectores | GET /connectors | Gratis |
| Buscar en el espacio | POST /search | Gratis |
| Modificar el espacio | PATCH /workspace | Gratis |
| Activar o desactivar una habilidad | PATCH /skills/{skillId} | Gratis |
| Listar las preferencias de herramientas | GET /workspace/tools | Gratis |
| Listar las preferencias de herramientas de un sitio | GET /sites/{siteId}/tools | Gratis |
| Activar o desactivar una herramienta | PATCH /workspace/tools | Gratis |
| Desconectar un conector | DELETE /connectors/{provider} | Gratis |
| Desconectar un conector de un sitio | DELETE /sites/{siteId}/connectors/{provider} | Gratis |
Obtener el espacio
/workspaceGratisEl espacio, su plan y qué parte de los créditos del periodo se ha usado.
- Los créditos nunca se muestran como cifras brutas: solo como porcentajes del periodo.
Herramienta MCP get_workspace
curl https://app.semchat.io/api/v1/workspace \
-H "Authorization: Bearer sk_live_…"{
"data": {
"id": "01995d03-8ea0-79ee-8ee3-c2eed260b3bc",
"name": "Acme",
"plan": {
"id": "starter",
"name": "Starter",
"features": {
"gsc": true,
"market_data": true,
"agents": 11,
"backlinks": true,
"weekly_reports": true,
"ai_writer": true
}
},
"balance": {
"used_pct": 12.5,
"remaining_pct": 87.5,
"period_resets_at": "2026-11-12T13:26:58.000Z"
},
"settings": {
"description": null,
"custom_instructions": "Nous sommes une agence SEO lyonnaise.",
"company_name": null,
"company_website": null,
"company_siren": null,
"company_address": null
}
}
}Obtener el uso
/usageGratisEl uso del periodo actual, en porcentaje, desglosado por categoría.
Herramienta MCP get_usage
curl https://app.semchat.io/api/v1/usage \
-H "Authorization: Bearer sk_live_…"{
"data": {
"period": "current",
"used_pct": 12.5,
"remaining_pct": 87.5,
"by_category_pct": {
"conversations": 2.5,
"seo_tools": 2.5,
"visuals": 2.5,
"documents": 2.5,
"site_analysis": 2.5
}
}
}Listar las habilidades
/skillsGratisLas habilidades disponibles para el chat del espacio.
Herramienta MCP list_skills
curl https://app.semchat.io/api/v1/skills \
-H "Authorization: Bearer sk_live_…"{
"data": [
{
"id": "cocon-semantique",
"name": "Topic cluster",
"when_to_use": "Quand l'utilisateur demande : cocon sémantique.",
"enabled": true
},
{
"id": "seo-audit",
"name": "SEO audit",
"when_to_use": "Quand l'utilisateur demande : audit seo.",
"enabled": true
}
]
}Listar los conectores
/connectorsGratisLas herramientas conectadas a nivel del espacio (Search Console, GA4, Slack, Notion…).
- La mayoría de las conexiones son por sitio: consulta list_site_connectors.
Herramienta MCP list_connectors
curl https://app.semchat.io/api/v1/connectors \
-H "Authorization: Bearer sk_live_…"Responde 200 con { "data": … }.
Buscar en el espacio
/searchGratisBusca en las conversaciones, los sitios, las tareas programadas, los conectores y las habilidades del espacio por nombre, dirección, mensaje o cuenta, como hace el buscador de la aplicación (⌘K).
- Cada tipo llega con
more: true cuando hay más resultados que los devueltos. - Las conversaciones se buscan por su título.
Herramienta MCP search_workspace
| Argumento | Tipo | Descripción |
|---|---|---|
queryobligatorio | string | Lo que se busca, sin tener en cuenta acentos ni mayúsculas. Vacío: lo más reciente de cada tipo.hasta 100 caracteres |
limitopcional | integer | Como máximo este número por tipo (50 por defecto y como máximo).≥ 1, ≤ 50 |
curl -X POST https://app.semchat.io/api/v1/search \
-H "Authorization: Bearer sk_live_…" \
-H "Content-Type: application/json" \
-d '{"query": "…"}'Responde 200 con { "data": … }.
Modificar el espacio
/workspaceGratisModifica los ajustes del espacio: su nombre, su descripción, las instrucciones personalizadas para el asistente y los datos de la empresa.
- Solo el propietario o un administrador (el rol del creador de la clave): si no, 403 FORBIDDEN.
- Solo cambian los campos indicados; un texto vacío (o null) borra un campo. Hace falta al menos un campo.
Herramienta MCP update_workspace
| Argumento | Tipo | Descripción |
|---|---|---|
nameopcional | string | 1–255 caracteres |
descriptionopcional | string | null | |
custom_instructionsopcional | string | null | Instrucciones que el asistente sigue en cada conversación del espacio. |
company_nameopcional | string | null | |
company_websiteopcional | string | null | |
company_sirenopcional | string | null | El número de registro de la empresa. |
company_addressopcional | string | null |
curl -X PATCH https://app.semchat.io/api/v1/workspace \
-H "Authorization: Bearer sk_live_…" \
-H "Content-Type: application/json" \
-d '{"name": "…"}'Responde 200 con { "data": … }.
Activar o desactivar una habilidad
/skills/{skillId}GratisActiva o desactiva una de las habilidades del espacio para su chat.
- Solo el propietario o un administrador (el rol del creador de la clave): si no, 403 FORBIDDEN.
Herramienta MCP set_skill
| Argumento | Tipo | Descripción |
|---|---|---|
skillIden la ruta | string | Su id. |
enabledobligatorio | boolean |
curl -X PATCH https://app.semchat.io/api/v1/skills/{skillId} \
-H "Authorization: Bearer sk_live_…" \
-H "Content-Type: application/json" \
-d '{"enabled": true}'Responde 200 con { "data": … }.
Listar las preferencias de herramientas
/workspace/toolsGratisLas herramientas de los conectores que el asistente puede usar, cada una activada o desactivada para el espacio.
- Una herramienta está activada salvo que se haya desactivado. Cada sitio hereda estas preferencias, salvo que defina las suyas: consulta list_site_tool_prefs.
Herramienta MCP list_tool_prefs
curl https://app.semchat.io/api/v1/workspace/tools \
-H "Authorization: Bearer sk_live_…"Responde 200 con { "data": … }.
Listar las preferencias de herramientas de un sitio
/sites/{siteId}/toolsGratisLas herramientas de los conectores que el asistente puede usar en las conversaciones de este sitio, cada una activada o desactivada.
- La elección propia del sitio si la hizo; si no, la del espacio.
Herramienta MCP list_site_tool_prefs
| Argumento | Tipo | Descripción |
|---|---|---|
siteIden la ruta | string | Su id. |
curl https://app.semchat.io/api/v1/sites/{siteId}/tools \
-H "Authorization: Bearer sk_live_…"Responde 200 con { "data": … }.
Activar o desactivar una herramienta
/workspace/toolsGratisActiva o desactiva una herramienta para el asistente, en el espacio o en un sitio.
Herramienta MCP set_tool_pref
| Argumento | Tipo | Descripción |
|---|---|---|
tool_nameobligatorio | string | La herramienta, tal como la nombra list_tool_prefs.1–64 caracteres |
enabledobligatorio | boolean | |
site_idopcional | string | Solo para este sitio (por defecto: el espacio).al menos 1 carácter |
curl -X PATCH https://app.semchat.io/api/v1/workspace/tools \
-H "Authorization: Bearer sk_live_…" \
-H "Content-Type: application/json" \
-d '{"tool_name": "…", "enabled": true}'Responde 200 con { "data": … }.
Desconectar un conector
/connectors/{provider}GratisDesconecta una herramienta conectada a nivel del espacio (se borra su acceso guardado).
- provider tal como lo muestra list_connectors (google_search_console, google_analytics_4, notion, slack, wordpress, webflow, microsoft_clarity, bing_webmaster_tools, yandex_metrica).
- Las conexiones propias de los sitios no se tocan: consulta disconnect_site_connector. Conectar una herramienta se hace en la aplicación.
Herramienta MCP disconnect_connector
| Argumento | Tipo | Descripción |
|---|---|---|
provideren la ruta | string | Su id. |
curl -X DELETE https://app.semchat.io/api/v1/connectors/{provider} \
-H "Authorization: Bearer sk_live_…"Responde 200 con { "data": … }.
Desconectar un conector de un sitio
/sites/{siteId}/connectors/{provider}GratisDesconecta una herramienta conectada a este sitio (se borra su acceso guardado).
- provider tal como lo muestra list_site_connectors.
Herramienta MCP disconnect_site_connector
| Argumento | Tipo | Descripción |
|---|---|---|
siteIden la ruta | string | Su id. |
provideren la ruta | string | Su id. |
curl -X DELETE https://app.semchat.io/api/v1/sites/{siteId}/connectors/{provider} \
-H "Authorization: Bearer sk_live_…"Responde 200 con { "data": … }.
¿No encuentras la respuesta? Escríbenos.

