> For the complete documentation index, see [llms.txt](https://docs.airops.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.airops.com/docs/es/acciones/workflow-concepts/workflow-steps/seo-research/google-search-console.md).

# Google Search Console

<figure><img src="https://3036434873-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX2n5yPRPynbnWuO4SH0M%2Fuploads%2Fgit-blob-93740578d42ac5e9b13473bf0069b72c2122eb9e%2FCleanShot%202025-03-20%20at%2006.31.19%402x.png?alt=media" alt=""><figcaption></figcaption></figure>

AirOps te permite conectarte directamente a tu cuenta de Google Search Console para obtener valiosos datos de rendimiento de búsqueda dentro de tus flujos de trabajo, ayudándote a tomar decisiones basadas en datos con tu contenido.

### Cómo configurar el paso de integración de Google Search Console

1. **Añade el paso a tu flujo de trabajo**:
   * Haz clic en el botón "+" para añadir un nuevo paso
   * Selecciona "Google Search Console" en la sección "Integraciones" de los pasos disponibles
2. **Autenticación**:
   * Selecciona una conexión existente de Google Search Console en el desplegable o configura una nueva
3. **Tipo de acción**:
   * Elige una de las siguientes acciones disponibles:
     * **Obtener resumen del rendimiento de consultas**: Recupera datos de rendimiento de las consultas de búsqueda que llevaron a tu sitio
     * **Obtener resumen del rendimiento de páginas**: Recupera datos de rendimiento de páginas específicas de tu sitio
     * **Obtener desglose del rendimiento de consultas y páginas**: Proporciona métricas detalladas de rendimiento entre consultas y páginas
     * **Obtener el estado de indexación de la página**: Comprueba si una URL específica está indexada por Google y cuándo se indexó por última vez
4. **Configurar parámetros específicos de la acción**:
   * **Selección del sitio**: Elige qué propiedad de Google Search Console consultar
   * **URL**: Para acciones específicas de páginas, introduce la URL que quieres analizar
   * **Período**: Para los datos de rendimiento, selecciona el intervalo de tiempo entre las opciones predefinidas:
     * Últimos 7 días
     * Últimos 28 días
     * Últimos 30 días
     * Últimos 60 días
     * Últimos 90 días
     * Últimos 3 meses
     * Rango de fechas personalizado
5. **Los formatos de salida varían según el tipo de acción**:
   * **Rendimiento de consultas**: Devuelve datos que incluyen el texto de la consulta, clics, impresiones, CTR y posición en el siguiente formato JSON

```
{
  "queries": [
    {
      "query": "string",  // El texto de la consulta de búsqueda
      "clicks": number,   // Recuento de clics de esta consulta
      "impressions": number,  // Recuento de impresiones de esta consulta
      "ctr": number,      // Tasa de clics (formato decimal)
      "position": number  // Posición media en los resultados de búsqueda
    }
    // Se devolverán varios objetos de consulta
  ]
}
```

* **Rendimiento de página**: Devuelve datos sobre páginas específicas, incluidos clics, impresiones y posicionamiento

```
{
  "clicks": {
    "L7D": number,       // Total de clics en los últimos 7 días
    "L30D": number,      // Total de clics en los últimos 30 días
    "WoW Change": number, // Cambio de clics semana a semana (puede ser positivo o negativo)
    "MoM Change": number  // Cambio de clics mes a mes (puede ser positivo o negativo)
  },
  "impressions": {
    "L7D": number,       // Total de impresiones en los últimos 7 días
    "L30D": number,      // Total de impresiones en los últimos 30 días
    "WoW Change": number, // Cambio de impresiones semana a semana
    "MoM Change": number  // Cambio de impresiones mes a mes
  },
  "ctr": {
    "L7D": number,       // Tasa media de clics de los últimos 7 días (expresada como porcentaje)
    "L30D": number,      // Tasa media de clics de los últimos 30 días (expresada como porcentaje)
    "WoW Change": number, // Cambio de CTR semana a semana (puntos porcentuales)
    "MoM Change": number  // Cambio de CTR mes a mes (puntos porcentuales)
  },
  "position": {
    "L7D": number,       // Posición media en los resultados de búsqueda de los últimos 7 días
    "L30D": number,      // Posición media en los resultados de búsqueda de los últimos 30 días
    "WoW Change": number, // Cambio de posición semana a semana (un cambio negativo es una mejora)
    "MoM Change": number  // Cambio de posición mes a mes (un cambio negativo es una mejora)
  }
}
```

* **Desglose de consultas y páginas**: Muestra cómo rinden consultas específicas para páginas específicas

```
{
  "queries": [  // Matriz de objetos de consulta
    {
      "query": "string",     // El texto específico de la consulta de búsqueda que se está analizando
      "clicks": number,      // Total de clics recibidos de esta consulta en todas las páginas
      "impressions": number, // Total de impresiones de esta consulta en todas las páginas
      "ctr": number,         // Tasa de clics general de la consulta (expresada como porcentaje)
      "position": number,    // Posición media en los resultados de búsqueda para esta consulta
      
      "ranking_pages": [     // Matriz de páginas que posicionan para esta consulta
        {
          "url": "string",   // URL completa de la página posicionada
          "clicks": number,  // Número de clics que recibió esta página específica para esta consulta
          "impressions": number, // Número de impresiones que recibió esta página para esta consulta
          "ctr": number,     // Tasa de clics específica de la página (expresada como decimal)
          "position": number, // Posición media de esta página para esta consulta
          "clicks_percent_total": number, // Porcentaje del total de clics de la consulta que va a esta página
          "impressions_percent_total": number // Porcentaje del total de impresiones de la consulta que va a esta página
        }
        // Se devolverán varios objetos de página, ordenados por clics en orden descendente
      ]
    },
    // Se devolverán varios objetos de consulta, normalmente ordenados por clics en orden descendente
  ],
  
  "metadata": {
    "start_date": "string", // Fecha en formato ISO que marca el inicio del período del informe
    "end_date": "string",   // Fecha en formato ISO que marca el final del período del informe
    "queries": number,      // Número total de consultas únicas analizadas en este informe
    "urls": number          // Número total de URL únicas que aparecieron en los resultados de búsqueda
  }
}
```

* **Estado de indexación**: Devuelve si una página está indexada, junto con la fecha del último rastreo en el siguiente formato JSON

```
{
  "last_crawled_at": "string", // Marca de tiempo del último rastreo
  "indexed": boolean           // Si la página está indexada
}
```


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.airops.com/docs/es/acciones/workflow-concepts/workflow-steps/seo-research/google-search-console.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
