Lists the organization's keyword labels (name, color, order) in the order of the app, paginated by cursor. Labels group tracked keywords (by topic, landing page, priority…) and filter seo_rankings.keywords.list; assign them with seo_rankings.keywords.bulk.set_labels. Create them with seo_rankings.labels.create, rename, recolor or move them with seo_rankings.labels.update and delete them with seo_rankings.labels.delete. created_by_name is the name of who created it (null for the ones created in the app, which does not record it).
Alcance
seo_rankings:read
Permiso
Ver el módulo
Tool del MCP
seo_rankings_labels_listEn la superficie completa; en la compacta, mb_execute_operation con id: "seo_rankings.labels.list".
Costo declarado: hasta 100 lecturas y 0 escrituras por llamada (cuentan en el cupo diario).
Parámetros
limitintegerqueryopcional
How many items this page brings at most (see the maximum and the default in the schema).
Por defecto: 50
cursorstringqueryopcional
The next_cursor of the previous page, exactly as it came (only for the same list and filters); without it, the first page.
Creates a keyword label at the end of the organization's list, the same labels the Rankings screen manages: name (1 to 60 characters) and an optional hex color such as #3b82f6 (without it, the color of the app's palette for its position). Like the screen, it does not check for another label with the same name: look it up first with seo_rankings.labels.list. Assign it with seo_rankings.keywords.bulk.set_labels or label_ids when adding keywords. Returns label_id and the label. Requires edit access to Rankings.
Alcance
seo_rankings:write
Permiso
Editar en el módulo
Tool del MCP
seo_rankings_labels_createEn la superficie completa; en la compacta, mb_execute_operation con id: "seo_rankings.labels.create".
Costo declarado: hasta 1 lecturas y 1 escrituras por llamada (cuentan en el cupo diario).
Parámetros
namestringcuerporequerido
Label name (1 to 60 characters).
colorstringcuerpoopcional
Hex color such as #3b82f6; without it, the color of the app's palette for its position.
Changes a keyword label, sent inside updates: name (1 to 60 characters), a hex color such as #3b82f6 and order (its position in the list, 0 = first; the other labels keep theirs, as when the app saves one label). The keywords that carry it keep it. Setting what it already has changes nothing (changed false, no write). 404 rank_label_not_found when the label is not in this organization. Unknown fields are rejected. Returns the label and changed. Requires edit access to Rankings.
Alcance
seo_rankings:write
Permiso
Editar en el módulo
Tool del MCP
seo_rankings_labels_updateEn la superficie completa; en la compacta, mb_execute_operation con id: "seo_rankings.labels.update".
Costo declarado: hasta 1 lecturas y 1 escrituras por llamada (cuentan en el cupo diario).
Parámetros
label_idstringrutarequerido
Keyword label id (from seo_rankings.labels.list).
updatesobjectcuerporequerido
The fields to change (at least one): name, color, order.
Deletes a keyword label and takes it off every keyword of the organization that carries it, as the Rankings screen does; the keywords themselves and their history are not touched. The label stays 30 days in the trash: restored (platform.trash.restore), it comes back with its id, name, color and order but not on the keywords, so reassign it with seo_rankings.keywords.bulk.set_labels. Outside the app it needs a dry run, which names the label and counts the keywords that lose it, and its confirm_token. 404 rank_label_not_found when the label is not in this organization. Returns ok and keywords_updated. Requires edit access to Rankings.
Con una API key, este DELETE se ejecuta directo: el registro queda 30 días en la papelera y la respuesta trae su trash_item_id. Con un token OAuth, y por el MCP, pide dry_run → confirm_token.
Alcance
seo_rankings:writey «Permitir eliminar» (seo_rankings:delete en OAuth)
Permiso
Editar en el módulo
Tool del MCP
seo_rankings_labels_deleteEn la superficie completa; en la compacta, mb_execute_operation con id: "seo_rankings.labels.delete".
Costo declarado: hasta 501 lecturas y 501 escrituras por llamada (cuentan en el cupo diario).
Parámetros
label_idstringrutarequerido
Keyword label id (from seo_rankings.labels.list).
Respuesta
oktrue
keywords_updatednumber
Keywords that carried the label and lost it.
trash_item_idstring
The trash item this deletion left: the item_id of platform.trash.restore (POST /trash/{item_id}/restore). Missing if nothing went to the trash.
trash_item_idsarray<string>
Only when the deletion left more than one copy: all of them, the first being trash_item_id.
trash_expires_atnumber
When the copy leaves the trash for good (epoch ms): 30 days after the deletion.
