Referência da API · Auditoria Web

Issues

seo_site_auditor · issues · 4 operações

GET/v1/seo/site-auditor/runs/{run_id}/issuesList the issues an audit found GET/v1/seo/site-auditor/runs/{run_id}/issues/exportExport an audit's issues as CSV or JSON POST/v1/seo/site-auditor/sites/{site_id}/ignore-rulesMark an issue as intentional for a site POST/v1/seo/site-auditor/sites/{site_id}/ignore-rules/{rule_id}/unignoreReactivate an issue marked as intentional

GET/v1/seo/site-auditor/runs/{run_id}/issues

List the issues an audit found

seo_site_auditor.issues.list

LeituraIdempotenteDesde 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.

Escopo: seo_site_auditor:read
Permissão: Ver o módulo
Tool do MCP: seo_site_auditor_issues_listNa superfície completa; na compacta, mb_execute_operation com id: "seo_site_auditor.issues.list".

Custo declarado: até 2 leituras e 0 escritas por chamada (contam na cota diária).

Parâmetros

run_idstringrotaobrigatório

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).

Padrão: 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 · Padrão: "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.

Resposta

dataarray<object>

has_moreboolean

next_cursorstring

Erros

audit_run_not_found invalid_input unknown_field authentication_required scope_insufficient module_access_denied operation_not_found rate_limited quota_exceeded

Exemplo

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

Testar com a sua API key de teste

Com uma API key de teste o pedido vai sempre para a sua organização de prática: dados de exemplo que você pode 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

LeituraIdempotenteDesde 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.

Escopo: seo_site_auditor:read
Permissão: Ver o módulo
Tool do MCP: seo_site_auditor_issues_exportNa superfície completa; na compacta, mb_execute_operation com id: "seo_site_auditor.issues.export".

Custo declarado: até 2 leituras e 0 escritas por chamada (contam na cota diária).

Parâmetros

run_idstringrotaobrigatório

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 · Padrão: "csv"

Resposta

formatenum

Valores: csv, json

file_namestring

content_typestring

issue_countnumber

contentstring

Erros

audit_run_not_found invalid_input unknown_field authentication_required scope_insufficient module_access_denied operation_not_found rate_limited quota_exceeded

Exemplo

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

Testar com a sua API key de teste

Com uma API key de teste o pedido vai sempre para a sua organização de prática: dados de exemplo que você pode 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

EscritaDesde 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.

Escopo: seo_site_auditor:write
Permissão: Editar no módulo
Tool do MCP: seo_site_auditor_issues_ignoreNa superfície completa; na compacta, mb_execute_operation com id: "seo_site_auditor.issues.ignore".

Custo declarado: até 1 leituras e 1 escritas por chamada (contam na cota diária).

Parâmetros

site_idstringrotaobrigatório

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

issue_idstringcorpoobrigatório

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

reasonstringcorpoobrigatório

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

url_patternstringcorpoopcional

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

Resposta

idstring

issue_idstring

url_patternstring | null

reasonstring

ignored_by_user_idstring | null

ignored_by_namestring | null

ignored_atnumber | null

Erros

invalid_input unknown_field authentication_required scope_insufficient crm_action_denied idempotency_key_reused rate_limited quota_exceeded

Exemplo

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"
}'

Testar com a sua API key de teste

Com uma API key de teste o pedido vai sempre para a sua organização de prática: dados de exemplo que você pode 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

EscritaDesde 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.

Escopo: seo_site_auditor:write
Permissão: Editar no módulo
Tool do MCP: seo_site_auditor_issues_unignoreNa superfície completa; na compacta, mb_execute_operation com id: "seo_site_auditor.issues.unignore".

Custo declarado: até 1 leituras e 1 escritas por chamada (contam na cota diária).

Parâmetros

site_idstringrotaobrigatório

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

rule_idstringrotaobrigatório

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

Resposta

oktrue

ruleobject

Erros

invalid_input unknown_field authentication_required scope_insufficient crm_action_denied idempotency_key_reused rate_limited quota_exceeded

Exemplo

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"

Testar com a sua API key de teste

Com uma API key de teste o pedido vai sempre para a sua organização de prática: dados de exemplo que você pode 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"