Proporcionado por DataForSEO
Leer el historial mensual del volumen de búsquedas y el CPC de una lista de palabras clave (DataForSEO)
Leer cómo fueron el volumen de búsquedas de Google, el costo por clic y la competencia de cada palabra clave en meses anteriores, para una lista de palabras clave en una ubicación y un idioma. Una fila por cada palabra clave proporcionada, con un historial de instantáneas mensuales de esas métricas. Una solicitud por llamada, con el precio establecido según la tarifa del proveedor de datos; un conjunto de resultados vacío se informa como sin resultados.
Cómo ejecutarlo
Paso 1Configurar
Una vez: pega esto en el chat de tu agente. Skill instala el CLI e inicia sesión por sí solo. Si tu agente no puede usar un shell, conéctalo mediante MCP en su lugar.
set up https://glasser.ai/SKILL.md
Show me how to use the DataForSEO endpoint /v3/dataforseo_labs/google/historical_keyword_data/live on Glasser.glasser run -p dataforseo -e '/v3/dataforseo_labs/google/historical_keyword_data/live' -i '{"keywords":["iphone"],"language_code":"en","location_code":2840}' --endpoint-version 2Usa la versión de endpoint 2. Comprueba el precio actual antes de ejecutar. Instala e inicia sesión primero en Comenzar.
Una vez por Run:
IDEMPOTENCY_KEY=$(uuidgen)Ejecútalo y copia este mismo bloque para volver a enviarlo:
curl -X POST https://api.glasser.ai/v1/runs \
-H "Authorization: Bearer gl_..." \
-H "Idempotency-Key: $IDEMPOTENCY_KEY" \
-H "Content-Type: application/json" \
-d '{"provider":"dataforseo","endpoint":"/v3/dataforseo_labs/google/historical_keyword_data/live","input":{"keywords":["iphone"],"language_code":"en","location_code":2840},"endpoint_version":2}'Reutiliza la misma Idempotency-Key para volver a enviarlo: el segundo envío es una lectura del primer Run. Una clave nueva crea un Run y un Charge nuevos. Usa la versión de endpoint 2; comprueba el precio actual antes de ejecutar.
Paso 2Prueba una tarea de ejemplo específica
Cuando necesites priorizar una lista breve de palabras clave, puedes comparar las métricas de volumen de búsquedas para comprender la demanda de los temas que estás considerando.
Copia este prompt en tu agente para revisar la demanda de búsqueda de tu lista breve de palabras clave.
Use dataforseo:/v3/dataforseo_labs/google/historical_keyword_data/live on Glasser.
Check demand for my keyword shortlist using the search-volume metrics actually returned.Estructura del endpoint
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"keywords"
],
"properties": {
"tag": {
"type": "string",
"maxLength": 2048,
"minLength": 1
},
"keywords": {
"type": "array",
"items": {
"type": "string",
"maxLength": 2048,
"minLength": 1
},
"maxItems": 100,
"minItems": 1
},
"language_code": {
"type": "string",
"maxLength": 2048,
"minLength": 1
},
"language_name": {
"type": "string"
},
"location_code": {
"type": "integer"
},
"location_name": {
"type": "string"
}
},
"additionalProperties": false
}{
"keywords": [
"iphone"
],
"language_code": "en",
"location_code": 2840
}Este endpoint no publica ningún esquema de salida. Recibes el cuerpo de respuesta propio del proveedor de datos, sin cambios — no garantizamos una estructura que no podemos asegurar.
Cómo funcionan los precios
| Tarifa base | El mismo precio con o sin datos coincidentes. | $0.012 |
|---|---|---|
| Por fila | Por cada fila devuelto. | $0.00012 |
| Máximo por Run | El cargo total no superará este importe. | $0.024 |
| Error del proveedor de datos | El proveedor de datos no pudo responder. | $0.00 |
| Tiempo de espera agotado | El Run superó su límite de tiempo. | $0.00 |
| Error interno | Un error interno impidió completar la operación. | $0.00 |