# Buscar en Google — SerpBase

Método de Botize — `serpbase.search` (acción).

Ejecuta una búsqueda en Google y devuelve los resultados orgánicos como datos: posición, título, enlace, dominio y descripción de cada uno, más las búsquedas relacionadas. Cuesta 1 crédito de SerpBase por ejecución. Si la búsqueda no devuelve nada, el paso responde igualmente con «Hay resultados» en no, de modo que la tarea sigue y puedes decidir qué hacer.

Es una acción: ocurre como paso de una tarea. Se pueden encadenar varias.

## Campos que se configuran

Nombre interno del campo, tipo y valores admitidos. En estos campos se pueden insertar etiquetas `{{...}}` de pasos anteriores.

- `q` *(string)* — Búsqueda
- `gl` *(string, one of: ""; "es"; "mx"; "ar"; "co"; "cl"; "pe"; "ve"; "ec"; "uy"; "us"; "ca"; "gb"; "ie"; "fr"; "de"; "it"; "pt"; "br"; "nl"; "be"; "ch"; "at"; "se"; "no"; "dk"; "fi"; "pl"; "gr"; "ro"; "tr"; "ru"; "ma"; "za"; "au"; "jp"; "in"; "cn")* — País de la búsqueda (código ISO). Vacío significa Estados Unidos
- `hl` *(string, one of: ""; "es"; "en"; "pt"; "ca"; "gl"; "eu"; "fr"; "de"; "it"; "nl"; "sv"; "no"; "da"; "fi"; "pl"; "cs"; "hu"; "ro"; "el"; "tr"; "ru"; "uk"; "ar"; "he"; "hi"; "id"; "ja"; "ko"; "zh-CN"; "th"; "vi")* — Idioma de los resultados (código ISO). Vacío significa inglés
- `device` *(string, one of: ""; "pc"; "mobile")* — Dispositivo: vacío para automático, pc para ordenador, mobile para móvil
- `page` *(string)* — Página de resultados, empezando en 1. Vacío significa la primera página

## Variables de salida

Datos que este paso deja disponibles. Se referencian en pasos posteriores con la etiqueta entre dobles llaves.

- `{{found}}` *(boolean)* — Hay resultados. No cuando Google no ha devuelto ningún resultado. El paso no detiene la tarea por su cuenta: pon una regla sobre este valor si quieres que se detenga.
- `{{query}}` *(text)* — Búsqueda
- `{{page}}` *(int)* — Página
- `{{results_count}}` *(int)* — Número de resultados
- `{{results}}` *(array)* — Resultados. Lista de resultados orgánicos. Cada elemento trae posición, título, enlace, dominio, descripción y fecha. Usa la app Iterador para ejecutar los pasos siguientes una vez por resultado.
- `{{first_title}}` *(text)* — Título del primer resultado
- `{{first_link}}` *(url)* — Enlace del primer resultado. Enlace del primer resultado orgánico, listo para usar sin tener que iterar.
- `{{first_snippet}}` *(text)* — Descripción del primer resultado
- `{{related_searches}}` *(array)* — Búsquedas relacionadas. Otras búsquedas que Google sugiere. No todos los países las devuelven.
- `{{credits_used}}` *(int)* — Créditos gastados

## Cuenta

Necesita una cuenta de SerpBase conectada en Botize: https://botize.com/es/app/serpbase/authenticate

## Esta app

Todos los disparadores y acciones de SerpBase: https://botize.com/es/app/serpbase.md

## Cómo montar esto

Un asistente de IA (Claude, ChatGPT, Cursor…) puede crear y editar estas tareas en la cuenta del usuario a través del conector MCP de Botize, incluido en todos los planes:

    https://webhook.botize.es/mcp

- Guía de conexión: https://botize.com/es/mcp
- Mapa para agentes: https://botize.com/llms.txt
- Cuenta nueva: https://botize.com/es/join (500 operaciones gratis, sin tarjeta)

---
Resumen legible por máquinas para asistentes de IA. Versión para personas: https://botize.com/es/method/serpbase/search