MB SuiteMB Suite
Menú

Referencia de la API · Auditoría Web

Issues

seo_site_auditor · issues · 4 operaciones

GET/v1/seo/site-auditor/runs/{run_id}/issuesGET/v1/seo/site-auditor/runs/{run_id}/issues/exportPOST/v1/seo/site-auditor/sites/{site_id}/ignore-rulesPOST/v1/seo/site-auditor/sites/{site_id}/ignore-rules/{rule_id}/unignore
GET/v1/seo/site-auditor/runs/{run_id}/issues

List the issues an audit found

seo_site_auditor.issues.list

LecturaIdempotenteDesde 2026-11-01

Lists the issues one audit found, the most serious first (critical, high, medium, low, info; then by affected pages), paginated by cursor (limit up to 200). Each issue has its check id, category, severity, title, description (what is wrong), impact (why it matters), how_to_fix, the affected URLs (up to 100 per issue; affected_urls_limit cuts them for a shorter answer) and their real count (affected_count), and metadata with the check's own data when it has any. state=active (default) lists the issues that count in the health score; state=ignored lists the ones an intentional rule left out of this audit, with the rule (ignore_rule) and partial_url_scope when the rule covered only some URLs. Filters: severity, category. The list is the audit as it ran: a rule added later applies from the next audit. An audit that failed or is still running has no issues (empty list). Not found (audit_run_not_found) if the audit does not exist. Requires view access to Site Audit.

Alcance
seo_site_auditor:read
Permiso
Ver el módulo
Tool del MCP
seo_site_auditor_issues_listEn la superficie completa; en la compacta, mb_execute_operation con id: "seo_site_auditor.issues.list".

Costo declarado: hasta 2 lecturas y 0 escrituras por llamada (cuentan en el cupo diario).

Parámetros

run_idstringrutarequerido

Audit id (id from seo_site_auditor.runs.list, or run_id from seo_site_auditor.runs.trigger).

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.

stateenumqueryopcional

active (default: the issues that count in the score) or ignored (the ones an intentional rule left out of this audit).

Valores: active, ignored · Por defecto: "active"

severityenumqueryopcional

Only issues of this severity.

Valores: critical, high, medium, low, info

categoryenumqueryopcional

Only issues of this category.

Valores: crawling, meta_tags, content, links, images, speed, security, sitemaps, redirects, usability, resources, localization, structured_data, open_graph

affected_urls_limitintegerqueryopcional

At most this many affected_urls per issue (0 to 100; affected_count keeps the real total). Default: all of them (an audit stores up to 100 per issue). For a short answer use 10; the whole list is also in seo_site_auditor.issues.export.

Respuesta

dataarray<object>
has_moreboolean
next_cursorstring

Errores

audit_run_not_foundinvalid_inputunknown_fieldauthentication_requiredscope_insufficientmodule_access_deniedoperation_not_foundrate_limitedquota_exceeded

Ejemplo

curl "https://api.mb-suite.com/v1/seo/site-auditor/runs/{run_id}/issues" \
  -H "Authorization: Bearer $MB_API_KEY"

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.

curl "https://api.mb-suite.com/v1/seo/site-auditor/runs/{run_id}/issues" \
  -H "Authorization: Bearer $MB_TEST_KEY"
GET/v1/seo/site-auditor/runs/{run_id}/issues/export

Export an audit's issues as CSV or JSON

seo_site_auditor.issues.export

LecturaIdempotenteDesde 2026-11-01

Exports the active issues of one audit as a file, returned inline in content: format=csv (default; columns severity, category, issue, affected pages, how to fix, with the header and the severity and category names in the caller's language) or format=json (every field of every issue). Also returns a suggested file_name, the content_type and issue_count. Use seo_site_auditor.issues.list to read them page by page instead. Errors: audit_run_not_found (404), audit_issues_not_found (404: the audit failed or is still running). Requires view access to Site Audit.

Alcance
seo_site_auditor:read
Permiso
Ver el módulo
Tool del MCP
seo_site_auditor_issues_exportEn la superficie completa; en la compacta, mb_execute_operation con id: "seo_site_auditor.issues.export".

Costo declarado: hasta 2 lecturas y 0 escrituras por llamada (cuentan en el cupo diario).

Parámetros

run_idstringrutarequerido

Audit id (id from seo_site_auditor.runs.list, or run_id from seo_site_auditor.runs.trigger).

formatenumqueryopcional

csv (default: severity, category, issue, affected pages, how to fix) or json (every field of every active issue).

Valores: csv, json · Por defecto: "csv"

Respuesta

formatenum

Valores: csv, json

file_namestring
content_typestring
issue_countnumber
contentstring

Errores

audit_run_not_foundinvalid_inputunknown_fieldauthentication_requiredscope_insufficientmodule_access_deniedoperation_not_foundrate_limitedquota_exceeded

Ejemplo

curl "https://api.mb-suite.com/v1/seo/site-auditor/runs/{run_id}/issues/export" \
  -H "Authorization: Bearer $MB_API_KEY"

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.

curl "https://api.mb-suite.com/v1/seo/site-auditor/runs/{run_id}/issues/export" \
  -H "Authorization: Bearer $MB_TEST_KEY"
POST/v1/seo/site-auditor/sites/{site_id}/ignore-rules

Mark an issue as intentional for a site

seo_site_auditor.issues.ignore

EscrituraDesde 2026-11-01

Adds an intentional rule to a site so an issue stops counting from the next audit (e.g. a page that is noindex on purpose): issue_id is the check id (id of an item of seo_site_auditor.issues.list), reason is required, and url_pattern (starts with / or *) limits the rule to the affected URLs that match it; without it, the whole issue. Past audits keep their results; the next one lists the issue under state=ignored and leaves it out of the health score. Errors: unknown_issue_id (400: not a check of the audit engine; details.suggestions lists the closest ids), audit_site_not_found (404), ignore_rule_exists (409: same issue and pattern), limit_reached (409, resource audit_ignore_rules: 100 rules per site). Returns the rule (its id is what seo_site_auditor.issues.unignore takes). Requires edit access to Site Audit.

Alcance
seo_site_auditor:write
Permiso
Editar en el módulo
Tool del MCP
seo_site_auditor_issues_ignoreEn la superficie completa; en la compacta, mb_execute_operation con id: "seo_site_auditor.issues.ignore".

Costo declarado: hasta 1 lecturas y 1 escrituras por llamada (cuentan en el cupo diario).

Parámetros

site_idstringrutarequerido

Audited site id (id from seo_site_auditor.sites.list).

issue_idstringcuerporequerido

Issue id: the id of the check, e.g. meta_description_missing (id of an item of seo_site_auditor.issues.list).

reasonstringcuerporequerido

Why it is intentional (required; shown to the team next to the issue).

url_patternstringcuerpoopcional

Only the affected URLs that match this pattern (starts with / or *). Without it, the whole issue.

Respuesta

idstring
issue_idstring
url_patternstring | null
reasonstring
ignored_by_user_idstring | null
ignored_by_namestring | null
ignored_atnumber | null

Errores

invalid_inputunknown_fieldauthentication_requiredscope_insufficientcrm_action_deniedidempotency_key_reusedrate_limitedquota_exceeded

Ejemplo

curl -X POST "https://api.mb-suite.com/v1/seo/site-auditor/sites/{site_id}/ignore-rules" \
  -H "Authorization: Bearer $MB_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "issue_id": "ISSUE_ID",
  "reason": "REASON"
}'

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.

curl -X POST "https://api.mb-suite.com/v1/seo/site-auditor/sites/{site_id}/ignore-rules" \
  -H "Authorization: Bearer $MB_TEST_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
  "issue_id": "ISSUE_ID",
  "reason": "REASON"
}'
POST/v1/seo/site-auditor/sites/{site_id}/ignore-rules/{rule_id}/unignore

Reactivate an issue marked as intentional

seo_site_auditor.issues.unignore

EscrituraDesde 2026-11-01

Removes an intentional rule from a site (rule_id: id of an item of ignore_rules in seo_site_auditor.sites.get), so the issue counts again from the next audit; past audits keep their results. Returns the removed rule, so it can be added back with seo_site_auditor.issues.ignore. Errors: audit_site_not_found (404), ignore_rule_not_found (404). Requires edit access to Site Audit.

Alcance
seo_site_auditor:write
Permiso
Editar en el módulo
Tool del MCP
seo_site_auditor_issues_unignoreEn la superficie completa; en la compacta, mb_execute_operation con id: "seo_site_auditor.issues.unignore".

Costo declarado: hasta 1 lecturas y 1 escrituras por llamada (cuentan en el cupo diario).

Parámetros

site_idstringrutarequerido

Audited site id (id from seo_site_auditor.sites.list).

rule_idstringrutarequerido

Ignore rule id (id of an item of ignore_rules in seo_site_auditor.sites.get).

Respuesta

oktrue
ruleobject

Errores

invalid_inputunknown_fieldauthentication_requiredscope_insufficientcrm_action_deniedidempotency_key_reusedrate_limitedquota_exceeded

Ejemplo

curl -X POST "https://api.mb-suite.com/v1/seo/site-auditor/sites/{site_id}/ignore-rules/{rule_id}/unignore" \
  -H "Authorization: Bearer $MB_API_KEY"

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.

curl -X POST "https://api.mb-suite.com/v1/seo/site-auditor/sites/{site_id}/ignore-rules/{rule_id}/unignore" \
  -H "Authorization: Bearer $MB_TEST_KEY"