YepAPI/skills

Flujo de Trabajo de Investigación de Competidores

Análisis competitivo entre dominios utilizando los endpoints de YepAPI.

Endpoints Utilizados

Endpoint	Costo	Propósito
POST /v1/seo/domain/overview	$0.01	Tráfico, palabras clave, backlinks, rango del dominio
POST /v1/seo/competitors	$0.04	Dominios competidores SEO por superposición de palabras clave
POST /v1/seo/keyword-gap	$0.04	Análisis de brecha de palabras clave entre dos dominios

Flujo de Trabajo

Paso 1: Visión General del Dominio

Ejecuta POST /v1/seo/domain/overview en el dominio del usuario.

{
  "domain": "example.com"
}

Devuelve: tráfico orgánico, total de palabras clave, cantidad de backlinks, rango del dominio.

Paso 2: Descubrir Competidores

Ejecuta POST /v1/seo/competitors en el dominio del usuario.

{
  "domain": "example.com"
}

Devuelve: dominios competidores con porcentaje de superposición de palabras clave y estimaciones de tráfico.

Paso 3: Comparar los Principales Competidores

Para los 2-3 competidores principales, ejecuta POST /v1/seo/domain/overview en cada uno.

{
  "domain": "competitor.com"
}

Compara: tráfico, recuento de palabras clave, perfiles de backlinks, rango del dominio.

Paso 4: Análisis de Brecha de Palabras Clave

Ejecuta POST /v1/seo/keyword-gap entre el dominio del usuario y el principal competidor.

{
  "domain": "example.com",
  "competitor": "competitor.com"
}

Devuelve: palabras clave por las que el competidor aparece en los resultados de búsqueda y el usuario no, ordenadas por volumen y dificultad.

Paso 5: Presentar los Hallazgos

• Quién está ganando en general (tráfico, autoridad)
• Dónde están las brechas de palabras clave (términos de alto valor que el usuario está perdiendo)
• Qué atacar a continuación (priorizado por oportunidad: alto volumen + baja dificultad)

Reglas

• Comienza con la visión general del dominio — la más económica a $0.01, ofrece métricas base
• Limita las inmersiones profundas en competidores a los 3 principales — controla los costos
• El análisis de brecha de palabras clave es el resultado más accionable — inclúyelo siempre

Manejo de Errores

• NO_CREDITS (402) — Indica al usuario que agregue créditos en https://yepapi.com/dashboard
• UPSTREAM_ERROR (502) — Reintenta una vez; si falla de nuevo, omite ese paso y anótalo
• VALIDATION_ERROR (400) — Verifica el formato del dominio; usa el dominio desnudo sin protocolo
• RATE_LIMITED (429) — Espera y reintenta; respeta la cabecera Retry-After