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ónLlamada
Obtener el espacioGET /workspaceGratis
Obtener el usoGET /usageGratis
Listar las habilidadesGET /skillsGratis
Listar los conectoresGET /connectorsGratis
Buscar en el espacioPOST /searchGratis
Modificar el espacioPATCH /workspaceGratis
Activar o desactivar una habilidadPATCH /skills/{skillId}Gratis
Listar las preferencias de herramientasGET /workspace/toolsGratis
Listar las preferencias de herramientas de un sitioGET /sites/{siteId}/toolsGratis
Activar o desactivar una herramientaPATCH /workspace/toolsGratis
Desconectar un conectorDELETE /connectors/{provider}Gratis
Desconectar un conector de un sitioDELETE /sites/{siteId}/connectors/{provider}Gratis

Obtener el espacio

GET/workspaceGratis

El 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

Petición
curl https://app.semchat.io/api/v1/workspace \
  -H "Authorization: Bearer sk_live_…"
Respuesta · 200
{
  "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

GET/usageGratis

El uso del periodo actual, en porcentaje, desglosado por categoría.

Herramienta MCP get_usage

Petición
curl https://app.semchat.io/api/v1/usage \
  -H "Authorization: Bearer sk_live_…"
Respuesta · 200
{
  "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

GET/skillsGratis

Las habilidades disponibles para el chat del espacio.

Herramienta MCP list_skills

Petición
curl https://app.semchat.io/api/v1/skills \
  -H "Authorization: Bearer sk_live_…"
Respuesta · 200
{
  "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

GET/connectorsGratis

Las 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

Petición
curl https://app.semchat.io/api/v1/connectors \
  -H "Authorization: Bearer sk_live_…"

Responde 200 con { "data": … }.

Buscar en el espacio

POST/searchGratis

Busca 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

ArgumentoTipoDescripción
queryobligatoriostringLo que se busca, sin tener en cuenta acentos ni mayúsculas. Vacío: lo más reciente de cada tipo.hasta 100 caracteres
limitopcionalintegerComo máximo este número por tipo (50 por defecto y como máximo).≥ 1, ≤ 50
Petición
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

PATCH/workspaceGratis

Modifica 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

ArgumentoTipoDescripción
nameopcionalstring1–255 caracteres
descriptionopcionalstring | null
custom_instructionsopcionalstring | nullInstrucciones que el asistente sigue en cada conversación del espacio.
company_nameopcionalstring | null
company_websiteopcionalstring | null
company_sirenopcionalstring | nullEl número de registro de la empresa.
company_addressopcionalstring | null
Petición
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

PATCH/skills/{skillId}Gratis

Activa 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

ArgumentoTipoDescripción
skillIden la rutastringSu id.
enabledobligatorioboolean
Petición
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

GET/workspace/toolsGratis

Las 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

Petición
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

GET/sites/{siteId}/toolsGratis

Las 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

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

Responde 200 con { "data": … }.

Activar o desactivar una herramienta

PATCH/workspace/toolsGratis

Activa o desactiva una herramienta para el asistente, en el espacio o en un sitio.

Herramienta MCP set_tool_pref

ArgumentoTipoDescripción
tool_nameobligatoriostringLa herramienta, tal como la nombra list_tool_prefs.1–64 caracteres
enabledobligatorioboolean
site_idopcionalstringSolo para este sitio (por defecto: el espacio).al menos 1 carácter
Petición
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

DELETE/connectors/{provider}Gratis

Desconecta 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

ArgumentoTipoDescripción
provideren la rutastringSu id.
Petición
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

DELETE/sites/{siteId}/connectors/{provider}Gratis

Desconecta una herramienta conectada a este sitio (se borra su acceso guardado).

  • provider tal como lo muestra list_site_connectors.

Herramienta MCP disconnect_site_connector

ArgumentoTipoDescripción
siteIden la rutastringSu id.
provideren la rutastringSu id.
Petición
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.

¿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