Skip to main content
Glama

gads_search_terms

Read-only

[DEMO SINTÉTICA] Búsquedas reales que escribieron los usuarios y dispararon nuestros anuncios de Google Ads. Muestra términos exactos con clics y gasto. Útil para encontrar oportunidades (nuevas keywords) o exclusiones (queries irrelevantes). Usar para "qué buscan los usuarios", "términos de búsqueda", "search terms".

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
date_rangeNoPeríodo a consultar. Ejemplos: "últimos 30 días", "enero 2025", "2025-01-01 a 2025-01-31", "este mes", "mes pasado". Por defecto: últimos 30 días.

Output Schema

TableJSON Schema
NameRequiredDescriptionDefault
dataYesHasta 100 filas ordenadas por gasto; una consulta puede aparecer en varios días o campañas.
demoNoSolo aparece en demo; todos sus datos son ficticios.
noticeNoAviso obligatorio de datos sintéticos cuando demo es true.
sample_periodNoPeríodo fijo de los ejemplos sintéticos; no cambia al solicitar otro rango.
requested_periodNoRango solicitado a la demo; no es el período real de sus ejemplos.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • changedOutput schema / (root)
      Previous value: -nullNew value: +{
      +  "additionalProperties": false,
      +  "description": "Estadísticas de la cuenta autenticada en data. Si demo es true, son ejemplos sintéticos; sample_period es su período y requested_period solo el rango solicitado.",
      +  "properties": {
      +    "data": {
      +      "description": "Hasta 100 filas ordenadas por gasto; una consulta puede aparecer en varios días o campañas.",
      +      "items": {
      +        "additionalProperties": false,
      +        "description": "Fila de consulta publicitaria, sin agregación adicional del servidor.",
      +        "properties": {
      +          "campaign": {
      +            "description": "Nombre de campaña.",
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "clicks": {
      +            "description": "Clics registrados. null indica ausencia del valor en la fuente.",
      +            "type": [
      +              "number",
      +              "null"
      +            ]
      +          },
      +          "conversions": {
      +            "description": "Conversiones atribuidas; pueden ser fraccionarias. null indica ausencia del valor en la fuente.",
      +            "type": [
      +              "number",
      +              "null"
      +            ]
      +          },
      +          "impressions": {
      +            "description": "Impresiones registradas. null indica ausencia del valor en la fuente.",
      +            "type": [
      +              "number",
      +              "null"
      +            ]
      +          },
      +          "searchTerm": {
      +            "description": "Consulta real que disparó el anuncio.",
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "spend": {
      +            "description": "Gasto en la moneda de la cuenta publicitaria; consultar el resumen del mismo canal para conocerla.",
      +            "type": "number"
      +          }
      +        },
      +        "required": [
      +          "campaign",
      +          "searchTerm",
      +          "impressions",
      +          "clicks",
      +          "spend",
      +          "conversions"
      +        ],
      +        "type": "object"
      +      },
      +      "type": "array"
      +    },
      +    "demo": {
      +      "const": true,
      +      "description": "Solo aparece en demo; todos sus datos son ficticios.",
      +      "type": "boolean"
      +    },
      +    "notice": {
      +      "description": "Aviso obligatorio de datos sintéticos cuando demo es true.",
      +      "type": "string"
      +    },
      +    "requested_period": {
      +      "additionalProperties": false,
      +      "description": "Rango solicitado a la demo; no es el período real de sus ejemplos.",
      +      "properties": {
      +        "from": {
      +          "description": "Fecha YYYY-MM-DD.",
      +          "format": "date",
      +          "type": "string"
      +        },
      +        "to": {
      +          "description": "Fecha YYYY-MM-DD.",
      +          "format": "date",
      +          "type": "string"
      +        }
      +      },
      +      "required": [
      +        "from",
      +        "to"
      +      ],
      +      "type": "object"
      +    },
      +    "sample_period": {
      +      "additionalProperties": false,
      +      "description": "Período fijo de los ejemplos sintéticos; no cambia al solicitar otro rango.",
      +      "properties": {
      +        "from": {
      +          "description": "Fecha YYYY-MM-DD.",
      +          "format": "date",
      +          "type": "string"
      +        },
      +        "to": {
      +          "description": "Fecha YYYY-MM-DD.",
      +          "format": "date",
      +          "type": "string"
      +        }
      +      },
      +      "required": [
      +        "from",
      +        "to"
      +      ],
      +      "type": "object"
      +    }
      +  },
      +  "required": [
      +    "data"
      +  ],
      +  "type": "object"
      +}
  2. First observed

TDQS

Score is being calculated.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.