{"skill":{"slug":"valueserp-rank-checker","displayName":"ValueSERP Rank Checker","summary":"Verifica la posición de una palabra clave para un dominio específico en Google usando la API de ValueSERP. Úsalo cuando el usuario pregunte \"¿en qué posición...","description":"---\nname: valueserp-rank-checker\ndescription: Verifica la posición de una palabra clave para un dominio específico en Google usando la API de ValueSERP. Úsalo cuando el usuario pregunte \"¿en qué posición está [keyword] en [dominio]?\", \"¿cómo rankea [dominio] para [keyword]?\", \"revisa el ranking de [keyword]\", o cualquier consulta sobre posicionamiento SEO de un dominio en Google. Por defecto busca en Google Colombia (español).\nmetadata:\n  openclaw:\n    primaryEnv: VALUESERP_API_KEY\n    requires:\n      env:\n        - VALUESERP_API_KEY\n    envVars:\n      - name: VALUESERP_API_KEY\n        required: true\n        description: API key de ValueSERP. Obtén la tuya en https://app.valueserp.com\n    emoji: \"📊\"\n    homepage: https://www.valueserp.com/docs/search-api/overview\n---\n\n# ValueSERP Rank Checker\n\nConsulta la posición de una palabra clave para un dominio en Google usando la API de ValueSERP.\n\n## Flujo\n\n1. Extraer `keyword` y `domain` del mensaje del usuario.\n2. Ejecutar `scripts/check_rank.py`.\n3. Presentar el resultado de forma clara en español.\n\n## Ejecutar la consulta\n\n```bash\npython3 scripts/check_rank.py \"<keyword>\" <domain>\n```\n\nOpciones adicionales:\n- `--gl co` — país (default: Colombia)\n- `--hl es` — idioma (default: español)\n- `--pages 10` — páginas a revisar (10 resultados/página, default: top 100)\n\nEjemplos:\n```bash\npython3 scripts/check_rank.py \"noticias\" eltiempo.com\n```\n\n## Interpretar el resultado\n\n**Encontrado:**\n```json\n{\n  \"found\": true,\n  \"keyword\": \"el tiempo\",\n  \"domain\": \"eltiempo.com\",\n  \"position\": 3,\n  \"page\": 1,\n  \"position_in_page\": 3,\n  \"url\": \"https://eltiempo.com/...\",\n  \"title\": \"El Tiempo - ...\"\n}\n```\n\n**No encontrado:**\n```json\n{\n  \"found\": false,\n  \"keyword\": \"el tiempo\",\n  \"domain\": \"eltiempo.com\",\n  \"pages_checked\": 10,\n  \"message\": \"No se encontró 'eltiempo.com' en las primeras 100 posiciones.\"\n}\n```\n\n## Formato de respuesta al usuario\n\nCuando esté en posición:\n> **eltiempo.com** está en la posición **#3** para \"*El tiempo*\" en Google Colombia.\n> URL: https://...\n\nCuando no aparezca en top 100:\n> **eltiempo.com** no aparece en las primeras 100 posiciones para \"*El tiempo*\" en Google Colombia.\n\nSi el usuario pide otro país o idioma, ajusta `--gl` y `--hl` según corresponda.\n","tags":{"latest":"0.1.1"},"stats":{"comments":0,"downloads":309,"installsAllTime":0,"installsCurrent":0,"stars":0,"versions":2},"createdAt":1778361120173,"updatedAt":1778492888959},"latestVersion":{"version":"0.1.1","createdAt":1778361552981,"changelog":"Remove SSL verification bypass","license":"MIT-0"},"metadata":{"setup":[{"key":"VALUESERP_API_KEY","required":true}],"os":null,"systems":null},"owner":{"handle":"jorgejaramillo","userId":"s178gaekjnqpzr12qpmsbe62hs86dj40","displayName":"Jorge Jaramillo","image":"https://avatars.githubusercontent.com/u/1000755?v=4"},"moderation":null}