DocumentaciónReferencia de la API
Competidores
Los competidores de un sitio, su análisis y sus enlaces entrantes.
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 competidores | GET /sites/{siteId}/competitors | Gratis |
| Añadir un competidor | POST /sites/{siteId}/competitors | Gratis |
| Eliminar un competidor | DELETE /sites/{siteId}/competitors/{competitorId} | Gratis |
| Analizar un competidor | POST /sites/{siteId}/competitors/{competitorId}/profile | De pago |
| Obtener los enlaces entrantes de un competidor | GET /sites/{siteId}/competitors/{competitorId}/backlinks | De pago |
Listar los competidores
/sites/{siteId}/competitorsGratisLos competidores del sitio, con su perfil una vez analizados.
Herramienta MCP list_competitors
| Argumento | Tipo | Descripción |
|---|---|---|
siteIden la ruta | string | Su id. |
curl https://app.semchat.io/api/v1/sites/{siteId}/competitors \
-H "Authorization: Bearer sk_live_…"{
"data": [
{
"id": "01a15ea4-c1e0-7285-bdde-d36e70d2d1b9",
"url": "https://comp1.example.com",
"name": "Concurrent Un",
"source": "auto",
"profiled_at": "2026-10-21T13:26:58.000Z",
"metrics": {
"traffic": 5200,
"keywords": 400,
"overlap": 40,
"reason": "Mêmes mots-clés à Lyon."
},
"profile": {
"summary": "Concurrent Un accompagne les PME.",
"positioning": "Agence généraliste.",
"topics": [
"SEO",
"SEA"
],
"strengths": [
"Notoriété"
],
"tech": [
"wordpress"
],
"pageCount": 24
}
},
{
"id": "01a15ea4-c1e0-7042-931d-3fa2cb1f4ffc",
"url": "https://comp2.example.com",
"name": "Concurrent Deux",
"source": "auto",
"profiled_at": "2026-10-21T13:26:58.000Z",
"metrics": {
"traffic": 4200,
"keywords": 350,
"overlap": 30,
"reason": "Mêmes mots-clés à Lyon."
},
"profile": {
"summary": "Concurrent Deux accompagne les PME.",
"positioning": "Agence généraliste.",
"topics": [
"SEO",
"SEA"
],
"strengths": [
"Notoriété"
],
"tech": [
"wordpress"
],
"pageCount": 24
}
}
]
}Añadir un competidor
/sites/{siteId}/competitorsGratisAñade un competidor y, si quieres, analiza su perfil (de pago).
- Responde con su id y
analyzing: false cuando no se lanzó ningún análisis (no se pidió, o no hay créditos; el competidor se guarda igualmente).
Herramienta MCP add_competitor
| Argumento | Tipo | Descripción |
|---|---|---|
siteIden la ruta | string | Su id. |
urlobligatorio | string | La dirección del competidor.1–500 caracteres |
nameopcional | string | hasta 255 caracteres |
auto_analyzeopcional | boolean | Analiza su perfil en segundo plano (de pago). Se omite sin créditos. |
curl -X POST https://app.semchat.io/api/v1/sites/{siteId}/competitors \
-H "Authorization: Bearer sk_live_…" \
-H "Content-Type: application/json" \
-d '{"url": "https://example.com"}'Responde 201 con { "data": … }.
Eliminar un competidor
/sites/{siteId}/competitors/{competitorId}GratisQuita un competidor de los del sitio.
Herramienta MCP delete_competitor
| Argumento | Tipo | Descripción |
|---|---|---|
siteIden la ruta | string | Su id. |
competitorIden la ruta | string | Su id. |
curl -X DELETE https://app.semchat.io/api/v1/sites/{siteId}/competitors/{competitorId} \
-H "Authorization: Bearer sk_live_…"Responde 204 con { "data": … }.
Analizar un competidor
/sites/{siteId}/competitors/{competitorId}/profileDe pagoAnaliza un competidor (un rastreo superficial de su sitio y un resumen hecho por IA: qué hace, su posicionamiento, sus temas, sus puntos fuertes y lo que le falta frente a tu sitio) y lo guarda en el competidor.
- Se factura como el mismo análisis en la aplicación (una llamada a la IA). 402 INSUFFICIENT_TOKENS sin créditos.
- Sin background, espera al perfil (hasta unos minutos) y responde con el competidor y su perfil.
Herramienta MCP profile_competitor
| Argumento | Tipo | Descripción |
|---|---|---|
siteIden la ruta | string | Su id. |
competitorIden la ruta | string | Su id. |
backgroundopcional | boolean | Responde al momento (202, status analyzing) y guarda el perfil cuando llega: léelo con list_competitors. |
localeopcional | string | El idioma en que se escribe el perfil (fr, en, es, de, pt, it). Por defecto: el del creador de la clave.2–5 caracteres |
curl -X POST https://app.semchat.io/api/v1/sites/{siteId}/competitors/{competitorId}/profile \
-H "Authorization: Bearer sk_live_…" \
-H "Content-Type: application/json" \
-d '{"background": true}'Responde 200 con { "data": … }.
Obtener los enlaces entrantes de un competidor
/sites/{siteId}/competitors/{competitorId}/backlinksDe pagoLas cifras de enlaces entrantes de un competidor: rank (0–100), dominios de referencia, enlaces entrantes, puntuación de spam.
- Gratis cuando el perfil de enlaces entrantes guardado del sitio (get_backlinks) ya cubre a este competidor; si no, una llamada de datos de pago, como en la aplicación.
- 402 INSUFFICIENT_TOKENS sin créditos cuando haría falta una llamada de pago.
Herramienta MCP get_competitor_backlinks
| Argumento | Tipo | Descripción |
|---|---|---|
siteIden la ruta | string | Su id. |
competitorIden la ruta | string | Su id. |
curl https://app.semchat.io/api/v1/sites/{siteId}/competitors/{competitorId}/backlinks \
-H "Authorization: Bearer sk_live_…"Responde 200 con { "data": … }.
¿No encuentras la respuesta? Escríbenos.

