ValueSERP Rank Checker

Consulta la posición de una palabra clave para un dominio en Google usando la API de ValueSERP.

Flujo

1. Extraer keyword y domain del mensaje del usuario.
2. Ejecutar scripts/check_rank.py.
3. Presentar el resultado de forma clara en español.

Ejecutar la consulta

python3 scripts/check_rank.py "<keyword>" <domain>

Opciones adicionales:

• --gl co — país (default: Colombia)
• --hl es — idioma (default: español)
• --pages 10 — páginas a revisar (10 resultados/página, default: top 100)

Ejemplos:

python3 scripts/check_rank.py "noticias" eltiempo.com

Interpretar el resultado

Encontrado:

{
  "found": true,
  "keyword": "el tiempo",
  "domain": "eltiempo.com",
  "position": 3,
  "page": 1,
  "position_in_page": 3,
  "url": "https://eltiempo.com/...",
  "title": "El Tiempo - ..."
}

No encontrado:

{
  "found": false,
  "keyword": "el tiempo",
  "domain": "eltiempo.com",
  "pages_checked": 10,
  "message": "No se encontró 'eltiempo.com' en las primeras 100 posiciones."
}

Formato de respuesta al usuario

Cuando esté en posición:

eltiempo.com está en la posición #3 para "El tiempo" en Google Colombia. URL: https://...

Cuando no aparezca en top 100:

eltiempo.com no aparece en las primeras 100 posiciones para "El tiempo" en Google Colombia.

Si el usuario pide otro país o idioma, ajusta --gl y --hl según corresponda.