Documentación - ScrapeGooSerp

Introducción

ScrapeGooSerp es una herramienta profesional de escritorio diseñada para automatizar búsquedas masivas en Google con características avanzadas de anti-detección, almacenamiento automático en base de datos SQLite y una API REST local completa.

Gratis y Sin Límites

Descarga y usa ScrapeGooSerp sin restricciones ni costos ocultos.

Súper Rápido

Procesa hasta 100 resultados por keyword con velocidad optimizada.

API Integrada

Servidor REST local con documentación Swagger incluida.

Inicio Rápido

🚀 En 3 pasos

Descarga e instala

Obtén ScrapeGooSerp desde /descargar e instálalo en Windows 10/11.

Configura proxy residencial

Introduce tus credenciales de proxy en formato usuario:pass@host:puerto

¡Empieza a hacer scraping!

Añade keywords y comienza a extraer datos de Google automáticamente.

Requisitos del Sistema

Sistema Operativo

Windows 10 (32-bit / 64-bit)
Windows 11 (32-bit / 64-bit)

Hardware Mínimo

• RAM: 1GB (recomendado 2GB+)
• Disco: 500MB libres
• Conexión estable a Internet

⚠️ Proxy Residencial Obligatorio

ScrapeGooSerp requiere un proxy residencial para funcionar. Sin proxy válido, la aplicación no podrá realizar búsquedas en Google.

Formato requerido:

usuario:contraseña@hostname:puerto

Ejemplo: user123:[email protected]:8080

Instalación

Proceso de instalación

Descarga el instalador

Obtén la última versión desde la página de descarga.

Ir a descarga

Ejecuta como administrador

Haz clic derecho en el instalador y selecciona "Ejecutar como administrador".

Completa la instalación

Sigue las instrucciones del instalador. Se creará un acceso directo en el escritorio.

Aviso de Windows Defender

ℹ️ SmartScreen puede mostrar un aviso

Al ejecutar el instalador por primera vez, es posible que Windows Defender SmartScreen muestre un aviso de seguridad. Esto es normal para aplicaciones que aún no tienen un certificado de firma digital extendido. ScrapeGooSerp es completamente seguro.

Si aparece este aviso:

Haz clic en "Más información"

Verás un enlace que dice "Más información" en el aviso de Windows Defender.

Selecciona "Ejecutar de todas formas"

Aparecerá un botón "Ejecutar de todas formas" que te permitirá continuar con la instalación.

Continúa con la instalación

El instalador se ejecutará normalmente y podrás completar la instalación de ScrapeGooSerp.

✅ ¿Por qué sucede esto?

Los certificados de firma digital extendidos (EV Code Signing) cuestan varios miles de dólares anuales. ScrapeGooSerp es una herramienta legítima y segura que actualmente utiliza un certificado estándar. Tu antivirus puede escanearlo sin problemas. Este aviso desaparecerá cuando el software obtenga más descargas y Microsoft reconozca la aplicación.

Configuración de Proxies

💡 Parámetros recomendados

Para obtener los mejores resultados y evitar bloqueos, configura tu proveedor de proxies con estos parámetros:

Configuración General

• Tipo: Residential proxies
• País: Random (recomendado)
• Duración sesión: Rotating

Conexión

• Tipo conexión: Hostname
• Formato: user:pass@host:port
• Protocolo: HTTP/HTTPS

Ejemplo de configuración visual

Panel de configuración de proxy residencial con parámetros recomendados

Panel de configuración del proveedor con los parámetros recomendados
Haz clic para ampliar

Ejemplo de formato final

# Datos del proveedor

Endpoint: rp.provider.com:8080

Username: user_abc123

Password: password_xyz789

# Formato final para ScrapeGooSerp

user_abc123:[email protected]:8080

Búsquedas Masivas

ScrapeGooSerp está optimizado para procesar múltiples palabras clave de forma simultánea, obteniendo hasta 100 resultados por búsqueda con anti-detección avanzada.

Características Principales

✓

Hasta 100 resultados por palabra clave
Extrae todos los resultados disponibles con paginación automática
⚡

Procesamiento por lotes simultáneo
Múltiples búsquedas en paralelo para mayor eficiencia
📊

Progreso en tiempo real
Monitor visual del estado de cada búsqueda

Anti-detección Avanzada

🔄

Rotación de user agents
Simula diferentes navegadores automáticamente
⏱️

Delays aleatorios
Intervalos variables entre peticiones
🔁

Detección automática de CAPTCHA
Sistema de reintentos inteligente

Configuración Global Disponible

Idioma y Región

Personalizable según el mercado objetivo

Número de Resultados

Configurable de 1 a 100 por búsqueda

Base de Datos SQLite

Todas las búsquedas se almacenan automáticamente en una base de datos SQLite local con estructura optimizada para consultas avanzadas y análisis detallado.

Tabla 'searches' (Metadatos)

• ID único - Identificador de cada búsqueda
• Palabra clave - Término de búsqueda utilizado
• Fecha - Timestamp de ejecución
• Total de resultados - Número de resultados obtenidos
• Proxy usado - Registro del proxy utilizado
• Tiempo de ejecución - Duración en segundos

Tabla 'search_results' (Resultados)

• Título - Título completo del resultado
• URL - Enlace al sitio web
• Descripción completa - Snippet del resultado
• Posición (1-100) - Ranking en la búsqueda
• Dominio extraído - Dominio principal
• Vinculado por ID - Relación con búsqueda padre

Operaciones Avanzadas

✓

Almacenamiento automático
Todas las búsquedas se guardan automáticamente
🔍

Consultas avanzadas
Filtros por keyword, fecha, dominio y posición

📊

Paginación inteligente
Manejo eficiente de grandes volúmenes
🗂️

100% local y privado
Tus datos nunca salen de tu computadora

Tablas principales

∞

Resultados almacenables

Campos por resultado

100%

Local y privado

Exportación Flexible

ScrapeGooSerp ofrece múltiples formatos de exportación para adaptarse a tus necesidades profesionales. Desde simple CSV hasta exportación completa en todos los formatos.

Formatos de Exportación Disponibles

database

Solo almacena en SQLite local

json

Con metadatos completos

csv

Columnas estructuradas

excel

Formato profesional

all

Todos los formatos

Exportación Inmediata

🚀

Control total de formatos
Elige exactamente cómo quieres tus datos
🗂️

Exportación múltiple
Usa "all" para generar todos los formatos
🔄

Datos limpios y seguros
Limpieza automática de caracteres especiales

Casos de Uso Profesional

📊

Análisis en Excel
Perfecto para reportes profesionales
🔗

Integraciones API
JSON estructurado para aplicaciones
📈

Importación rápida
CSV compatible con herramientas SEO

API REST Local - Visión General

ScrapeGooSerp incluye un servidor FastAPI local que se ejecuta en http://localhost:8000 con documentación interactiva Swagger disponible en /docs.

Características

• Documentación Swagger automática
• CORS habilitado para integraciones
• Endpoints RESTful estándar
• Respuestas en JSON
• Manejo de errores HTTP

Acceso Rápido

Servidor local:

http://localhost:8000

Documentación:

http://localhost:8000/docs

Estado del servidor:

GET /health

Endpoints de la API

La API REST de ScrapeGooSerp ofrece endpoints completos para automatizar búsquedas, monitorear el progreso y recuperar resultados.

Endpoints de Búsqueda

POST /search

Descripción: Ejecuta búsquedas masivas con múltiples palabras clave

Parámetros requeridos:

• keywords - Lista de palabras clave
• max_results - Resultados por keyword (1-100)
• output_format - database, json, csv, excel, all

Respuesta:

• task_id - ID único de la tarea
• status - Estado inicial
• message - Descripción del proceso

GET /search/{task_id}/status

Descripción: Consulta el estado y progreso de una búsqueda activa

Parámetros:

• task_id - ID de la tarea (URL param)

Respuesta:

• status - running, completed, failed
• progress - Porcentaje completado
• current_keyword - Keyword actual

Endpoints de Resultados

GET /results/{search_id}

Descripción: Recupera todos los resultados de una búsqueda específica

Parámetros:

• search_id - ID de búsqueda
• page - Página (opcional)
• limit - Límite por página (opcional)

Respuesta:

• results - Array de resultados
• total - Total de resultados
• pagination - Info de paginación

GET /results/search

Descripción: Busca resultados con filtros avanzados

Query parameters:

• keyword - Filtrar por keyword
• domain - Filtrar por dominio
• position_min/max - Rango posición

Respuesta:

• results - Resultados filtrados
• filters_applied - Filtros aplicados
• total_filtered - Total filtrado

Endpoints del Sistema

GET /proxy/status

Descripción: Verifica el estado y conectividad del proxy configurado

Sin parámetros

Respuesta:

• status - active, inactive, error
• proxy_info - Info del proxy
• last_check - Última verificación

GET /health

Descripción: Endpoint de salud para verificar que la API está funcionando

Sin parámetros

Respuesta:

• status - "OK"
• timestamp - Hora actual
• version - Versión de la API

Ejemplos de Uso de la API

Ejemplos prácticos de cómo utilizar la API REST de ScrapeGooSerp para automatizar búsquedas y recuperar resultados.

1 Ejecutar Búsqueda Básica

Solicitud:

POST http://localhost:8000/search
Content-Type: application/json

{
  "keywords": ["zapatos deportivos", "zapatillas running"],
  "max_results": 50,
  "output_format": "json",
  "language": "es",
  "country": "ES"
}

Respuesta:

{
  "task_id": "search_1234567890",
  "status": "started",
  "message": "Búsqueda iniciada para 2 palabras clave",
  "keywords": ["zapatos deportivos", "zapatillas running"],
  "estimated_time": "2-3 minutos"
}

2 Consultar Estado de Búsqueda

Solicitud:

GET http://localhost:8000/search/search_1234567890/status

Respuesta (en progreso):

{
  "task_id": "search_1234567890",
  "status": "running",
  "progress": 65,
  "current_keyword": "zapatillas running",
  "completed_keywords": ["zapatos deportivos"],
  "results_found": 47,
  "estimated_remaining": "1 minuto"
}

3 Recuperar Resultados

Solicitud:

GET http://localhost:8000/results/search_1234567890?page=1&limit=10

Respuesta:

{
  "search_id": "search_1234567890",
  "total": 93,
  "page": 1,
  "limit": 10,
  "results": [
    {
      "position": 1,
      "title": "Zapatos Deportivos Premium - Mejor Precio",
      "url": "https://ejemplo.com/zapatos-deportivos",
      "description": "Encuentra los mejores zapatos deportivos...",
      "domain": "ejemplo.com",
      "keyword": "zapatos deportivos"
    },
    {
      "position": 2,
      "title": "Zapatillas Running Profesionales",
      "url": "https://tienda.com/zapatillas-running",
      "description": "Zapatillas para running de alta calidad...",
      "domain": "tienda.com",
      "keyword": "zapatos deportivos"
    }
  ]
}

4 Búsqueda con Filtros Avanzados

Solicitud:

GET http://localhost:8000/results/search?keyword=zapatos&domain=amazon.es&position_min=1&position_max=10

Respuesta:

{
  "filters_applied": {
    "keyword": "zapatos",
    "domain": "amazon.es",
    "position_range": [1, 10]
  },
  "total_filtered": 3,
  "results": [
    {
      "position": 2,
      "title": "Amazon.es: Zapatos - Envío Gratis",
      "url": "https://amazon.es/zapatos",
      "description": "Encuentra zapatos de todas las marcas...",
      "domain": "amazon.es",
      "keyword": "zapatos deportivos"
    }
  ]
}

5 Verificar Estado del Proxy

Solicitud:

GET http://localhost:8000/proxy/status

Respuesta:

{
  "status": "active",
  "proxy_info": {
    "host": "proxy.provider.com",
    "port": 8080,
    "type": "residential"
  },
  "last_check": "2025-01-15T10:30:00Z",
  "response_time": "245ms",
  "success_rate": "98.5%"
}

💡 Consejos para usar la API

• Siempre verifica el estado del proxy antes de iniciar búsquedas
• Usa el endpoint de estado para monitorear búsquedas largas
• El formato "all" exporta en todos los formatos disponibles

• Implementa retry logic para manejar errores temporales
• Usa paginación para navegar por los resultados almacenados
• Consulta /docs para documentación Swagger completa

¿Necesitas más ayuda?

Si tienes dudas sobre la configuración, problemas técnicos o quieres sugerir mejoras, nuestro equipo está aquí para ayudarte.

Soporte Técnico Descargar Aplicación

Documentación actualizada: Septiembre 2025 • Versión 1.0