DocumentaciónReferencia de la API
Ideas de contenido
Las ideas de contenido de un sitio: listarlas, añadirlas y eliminarlas.
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 las ideas de contenido | GET /sites/{siteId}/content-ideas | Gratis |
| Añadir una idea de contenido | POST /sites/{siteId}/content-ideas | Gratis |
| Eliminar una idea de contenido | DELETE /sites/{siteId}/content-ideas/{ideaId} | Gratis |
Listar las ideas de contenido
/sites/{siteId}/content-ideasGratisLas ideas de contenido del sitio: artículos por escribir, cada uno con su palabra clave, su enfoque y su justificación.
- 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 list_content_ideas
| Argumento | Tipo | Descripción |
|---|---|---|
siteIden la ruta | string | Su id. |
curl https://app.semchat.io/api/v1/sites/{siteId}/content-ideas \
-H "Authorization: Bearer sk_live_…"{
"data": [
{
"id": "01a15ea4-c1e0-7736-9a1d-b79cfd3e485e",
"title": "Combien coûte un audit SEO ?",
"content_type": "faq",
"primary_keyword": "référencement naturel pme",
"volume": 880,
"difficulty": 35,
"intent": "informational",
"angle": "Angle : combien coûte un audit seo ?",
"rationale": "Fort intérêt, peu de concurrence.",
"source": "auto",
"source_lang": "fr",
"created_at": "2026-10-21T13:26:58.000Z"
},
{
"id": "01a15ea4-c1e0-7aec-b48b-474893e6ef98",
"title": "Les 7 erreurs SEO des PME",
"content_type": "listicle",
"primary_keyword": "stratégie de contenu seo",
"volume": 590,
"difficulty": 40,
"intent": "informational",
"angle": "Angle : les 7 erreurs seo des pme",
"rationale": "Fort intérêt, peu de concurrence.",
"source": "auto",
"source_lang": "fr",
"created_at": "2026-10-21T13:26:58.000Z"
}
]
}Añadir una idea de contenido
/sites/{siteId}/content-ideasGratisAñade una idea de contenido al sitio.
- Se añade como idea manual. Responde con la idea.
Herramienta MCP add_content_idea
| Argumento | Tipo | Descripción |
|---|---|---|
siteIden la ruta | string | Su id. |
titleobligatorio | string | El título del artículo.1–300 caracteres |
content_typeopcional | string | null | blog_post, guide, comparison, faq, how_to, listicle o landing. |
primary_keywordopcional | string | null | La palabra clave a la que apunta. |
intentopcional | string | null | informational, commercial, transactional o navigational. |
angleopcional | string | null | Lo que debe tratar el artículo. |
rationaleopcional | string | null | Por qué escribirlo. |
volumeopcional | string | null | |
difficultyopcional | string | null | |
source_langopcional | string | El idioma en que está escrito el texto (p. ej. "fr", "en"). Si se omite: el idioma del contenido del sitio.2–5 caracteres |
curl -X POST https://app.semchat.io/api/v1/sites/{siteId}/content-ideas \
-H "Authorization: Bearer sk_live_…" \
-H "Content-Type: application/json" \
-d '{"title": "…"}'Responde 201 con { "data": … }.
Eliminar una idea de contenido
/sites/{siteId}/content-ideas/{ideaId}GratisQuita una idea de contenido del sitio.
Herramienta MCP delete_content_idea
| Argumento | Tipo | Descripción |
|---|---|---|
siteIden la ruta | string | Su id. |
ideaIden la ruta | string | Su id. |
curl -X DELETE https://app.semchat.io/api/v1/sites/{siteId}/content-ideas/{ideaId} \
-H "Authorization: Bearer sk_live_…"Responde 204 con { "data": … }.
¿No encuentras la respuesta? Escríbenos.

