# Consultar la posición de un dominio en Google — SerpBase

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

Busca una palabra clave en Google y te dice en qué posición aparece un dominio, junto con la URL concreta que posiciona. Los subdominios cuentan como parte del dominio. Para en cuanto lo encuentra, y cada página de resultados que tiene que leer cuesta 1 crédito de SerpBase. Si el dominio no aparece, el paso responde igualmente, con «Aparece en los resultados» en no y posición 0, para que puedas poner una regla y enterarte.

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)* — Palabra clave a buscar
- `site` *(string)* — Dominio a buscar, tipo ejemplo.com. Los subdominios cuentan como el mismo dominio
- `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
- `max_pages` *(string, one of: "1"; "2"; "3")* — Cuántas páginas de resultados leer como máximo: 1 (top 10), 2 (top 20) o 3 (top 30). Cada página cuesta 1 crédito

## Variables de salida

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

- `{{found}}` *(boolean)* — Aparece en los resultados. No cuando el dominio no aparece en los resultados que se han leído. El paso no detiene la tarea por su cuenta: pon una regla sobre este valor para decidir qué pasa.
- `{{position}}` *(int)* — Posición. Posición global contando entre páginas, o sea que el resultado 3 de la página 2 es la posición 13. Vale 0 cuando el dominio no aparece.
- `{{page}}` *(int)* — Página
- `{{url}}` *(url)* — URL que posiciona. La página concreta del dominio que posiciona, que no siempre es la que esperas.
- `{{title}}` *(text)* — Título en Google
- `{{snippet}}` *(text)* — Descripción en Google
- `{{query}}` *(text)* — Palabra clave
- `{{site}}` *(text)* — Dominio
- `{{results_scanned}}` *(int)* — Resultados revisados
- `{{pages_scanned}}` *(int)* — Páginas leídas
- `{{credits_used}}` *(int)* — Créditos gastados. Créditos que ha gastado de verdad esta ejecución. Es 1 cuando el dominio se ha encontrado en la primera página.

## 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/check_position