Proporcionado por Semrush
Consultar el volumen, la dificultad y la intención de una palabra clave (Semrush)
Consulta las métricas de Semrush de una sola palabra clave en un país: volumen de búsqueda mensual, CPC, dificultad de palabra clave, densidad competitiva, intenciones de búsqueda, tendencia de volumen de doce meses y funciones SERP presentes. Indica una palabra clave y un código de país de dos letras, como US, además de un mes YYYY-MM opcional. Una palabra clave por llamada; varias palabras clave requieren varias llamadas.
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 Semrush endpoint /apis/v4/keywords/v1/metrics on Glasser.glasser run -p semrush -e '/apis/v4/keywords/v1/metrics' -i '{"country":"US","keyword":"espresso machine"}' --endpoint-version 5Usa la versión de endpoint 5. 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":"semrush","endpoint":"/apis/v4/keywords/v1/metrics","input":{"country":"US","keyword":"espresso machine"},"endpoint_version":5}'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 5; 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 semrush:/apis/v4/keywords/v1/metrics 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": [
"keyword",
"country"
],
"properties": {
"month": {
"type": "string",
"pattern": "^\\d{4}-(0[1-9]|1[0-2])$"
},
"country": {
"enum": [
"AF",
"AL",
"DZ",
"AO",
"AR",
"AM",
"AU",
"AT",
"AZ",
"BS",
"BH",
"BD",
"BY",
"BE",
"BZ",
"BO",
"BA",
"BW",
"BR",
"BN",
"BG",
"KH",
"CM",
"CA",
"CV",
"CL",
"CO",
"CR",
"HR",
"CY",
"CZ",
"CD",
"DK",
"DO",
"EC",
"EG",
"SV",
"EE",
"ET",
"FI",
"FR",
"GE",
"DE",
"GH",
"GR",
"GT",
"GY",
"HT",
"HN",
"HK",
"HU",
"IS",
"IN",
"ID",
"IE",
"IL",
"IT",
"JM",
"JP",
"JO",
"KZ",
"KW",
"LV",
"LB",
"LY",
"LT",
"LU",
"MG",
"MY",
"MT",
"MU",
"MX",
"MD",
"MN",
"ME",
"MA",
"MZ",
"NA",
"NP",
"NL",
"NZ",
"NI",
"NG",
"NO",
"OM",
"PK",
"PA",
"PY",
"PE",
"PH",
"PL",
"PT",
"QA",
"RO",
"RU",
"SA",
"SN",
"RS",
"SG",
"SK",
"SI",
"ZA",
"KR",
"ES",
"LK",
"SE",
"CH",
"TW",
"TH",
"TT",
"TN",
"TR",
"UA",
"AE",
"UK",
"US",
"UY",
"VE",
"VN",
"ZM",
"ZW",
"GB"
],
"type": "string",
"description": "Upper-case two-letter code from Semrush's supported list (https://developer.semrush.com/api/v4/seo/keyword-reports/), e.g. \"US\", \"UK\", \"DE\", \"FR\", \"JP\". Semrush writes the United Kingdom as \"UK\"; \"GB\" is accepted and sent as \"UK\"."
},
"keyword": {
"type": "string",
"maxLength": 255,
"minLength": 1
}
},
"additionalProperties": false
}{
"country": "US",
"keyword": "espresso machine"
}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
| Datos devueltos | Se cobra solo cuando se devuelven datos. | $0.0011 |
|---|---|---|
| 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 |