Verificaciones

Run a manual rank check

seo_rankings.checks.trigger

Starts a manual rank check of a project now: every ACTIVE keyword is sent to the SERP provider (DataForSEO, paid per keyword, engine and country, and device) and the positions are collected over the following minutes. The plan allows a limited number of manual checks per project per month (UTC; 409 limit_reached with resource rank_manual_checks when used up; scheduled checks are not affected), a check already in progress blocks a new one (409 rank_check_in_progress), and a project without active keywords has nothing to check (409 rank_no_active_keywords). Returns the batches and SERP tasks dispatched and the manual checks left this month. Results are NOT in the response: watch last_check_status in seo_rankings.projects.get (pending → collecting → completed) or subscribe to seo_rankings.check.completed; positions are then in seo_rankings.keywords.list. Not idempotent: each call is a new paid check. In demo organizations nothing is measured live: 403 demo_read_only, already on the dry run (no manual check of the month is used). Outside the app it needs a dry run and its confirm_token (it pays DataForSEO).

Pide confirmación: primero dry_run: true (vista previa y confirm_token, que vale 10 minutos y una sola vez), después el mismo cuerpo con confirm_token. En unas pocas, solo con ciertos datos: la descripción dice cuándo. Por qué y cómo: Vista previa y confirmación.

Alcance

seo_rankings:write

Permiso

Editar en el módulo

Tool del MCP

seo_rankings_checks_triggerEn la superficie completa; en la compacta, mb_execute_operation con id: "seo_rankings.checks.trigger".

Eventos que puede emitir

seo_rankings.check.completedseo_rankings.check.failed

Costo declarado: hasta 302 lecturas y 50 escrituras por llamada (cuentan en el cupo diario). Toca una plataforma externa (dataforseo): cuenta en el cupo de operaciones externas.

Parámetros

Respuesta

Errores

Ejemplo

curl -X POST "https://api.mb-suite.com/v1/seo/rankings/projects/{project_id}/check" \
  -H "Authorization: Bearer $MB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "dry_run": true
}'

Probar con tu API key de prueba

Con una API key de prueba el pedido va siempre a tu organización de práctica: datos de ejemplo que puedes reiniciar. En la práctica esta operación no se simula (toca otra plataforma): responde 409 sandbox_external_unavailable.