Documentación para desarrolladores

Resumen de un sitio web

GET/sites/{siteId}
Permiso
sites:read
Herramienta MCP
site_summary

Website summary Scores (with the inputs that stopped updating), the last audit, open issues, waiting actions, WordPress access, and how fresh each connected data source is.

Las descripciones vienen del documento OpenAPI y están en inglés.

Parámetros

NombreDóndeDetalles
siteIdObligatoriorutastringWebsite id, from GET /sites.

Respuesta

200 · application/json

CampoDetalles
idstring · required; Website id
namestring · required; Website name
urladdress (URL) · required; Home page address
platformwordpress | astro | shopify | webflow | other | unknown · required; What the website runs on
scoreobject or null · required; Latest score; null before the first audit
score.siteinteger or null · required; Site score, 0 to 100; null until enough is measured
score.healthinteger or null · required; Health score, 0 to 100; null until enough is measured
score.aeointeger or null · required; AEO readiness, 0 to 100; null until enough is measured
score.coveragenumber · required; Share of the website that could be measured, 0 to 1
score.confidencehigh | medium | low · required; How sure the score is
score.staleInputslist of object · required; Connected sources whose data stopped updating
score.versionstring · required; Score formula version
score.computedAtstring · required; When it was computed
score.categoriesobject · required
score.categories.Technicalobject
score.categories.Technical.scorenumber
score.categories.Technical.coveragenumber
score.categories.Technical.insufficienttrue or false
score.categories.On-pageobject
score.categories.On-page.scorenumber
score.categories.On-page.coveragenumber
score.categories.On-page.insufficienttrue or false
score.categories.Internal linkingobject
score.categories.Internal linking.scorenumber
score.categories.Internal linking.coveragenumber
score.categories.Internal linking.insufficienttrue or false
score.categories.Performanceobject
score.categories.Performance.scorenumber
score.categories.Performance.coveragenumber
score.categories.Performance.insufficienttrue or false
lastAuditobject or null · required; Last finished audit
lastAudit.idstring · required; Audit id
lastAudit.finishedAtstring or null · required
lastAudit.pagesCrawledinteger · required; Pages read
lastAudit.partialstring or null · required; Why it stopped early; null when complete
openIssuesinteger · required; Open issues and actions
criticalIssuesinteger · required; Of those, critical
waitingActionsinteger · required; Actions open 14 days or more
connectionslist of object · required; Each connected data source
connections[].sourcegsc | ga4 | ads | wordpress · required; gsc = Search Console, ga4 = Google Analytics, ads = Google Ads
connections[].cadencedaily | weekly · required; How often it imports
connections[].lastImportAtstring or null · required; When an import last wrote data
connections[].rowsLastImportinteger or null · required; Rows the latest import wrote (0: it ran and wrote nothing); null before the first
connections[].staleDaysinteger · required; Whole days since data last moved
connections[].staletrue or false · required; True after 3 days without data (daily sources)
wordpressobject or null · required; WordPress connector; null when none
wordpress.statuspending | connected | failed | revoked | disconnected · required; Connector state
wordpress.canWritetrue or false · required; MonoRanks can write fixes through it
linkaddress (URL) · required; The website in the app

Errores

EstadoSignificado
401Missing, unknown or revoked key. Codes: missing_key, invalid_key.
403The key lacks the scope, covers another website, or its owner lost access. Codes: missing_scope, other_site, owner_left, no_owner, forbidden.
404Not found. Codes: not_found.
429Too many requests this hour for this key. Codes: rate_limited.

Petición de ejemplo

curl \
  -H "Authorization: Bearer mr_ws_…" \
  "https://app.monoranks.com/api/v1/sites/SITE_ID"

Respuesta de ejemplo

{
  "id": "3f6c2a1e-8b4d-4c7a-9e21-5d0b7a6f4c13",
  "name": "Acme Bikes",
  "url": "https://acmebikes.com/",
  "platform": "wordpress",
  "score": {
    "site": 78,
    "health": 81,
    "aeo": 69,
    "coverage": 0.92,
    "confidence": "high",
    "staleInputs": [],
    "version": "1.1.0",
    "computedAt": "2026-10-04T02:41:12.000Z",
    "categories": {
      "Technical": {
        "score": 84,
        "coverage": 1,
        "insufficient": false
      },
      "On-page": {
        "score": 76,
        "coverage": 1,
        "insufficient": false
      },
      "Internal linking": {
        "score": 88,
        "coverage": 1,
        "insufficient": false
      },
      "Performance": {
        "score": 71,
        "coverage": 0.6,
        "insufficient": false
      }
    }
  },
  "lastAudit": {
    "id": "d4f6a8c0-2e4a-4c6e-8a0c-4e6a8c0e2a4b",
    "finishedAt": "2026-10-04T02:40:55.000Z",
    "pagesCrawled": 186,
    "partial": null
  },
  "openIssues": 17,
  "criticalIssues": 1,
  "waitingActions": 5,
  "connections": [
    {
      "source": "gsc",
      "cadence": "daily",
      "lastImportAt": "2026-10-06T04:12:09.000Z",
      "rowsLastImport": 5120,
      "staleDays": 0,
      "stale": false
    },
    {
      "source": "wordpress",
      "cadence": "daily",
      "lastImportAt": "2026-10-06T01:00:31.000Z",
      "rowsLastImport": 214,
      "staleDays": 0,
      "stale": false
    }
  ],
  "wordpress": {
    "status": "connected",
    "canWrite": true
  },
  "link": "https://app.monoranks.com/sites/3f6c2a1e-8b4d-4c7a-9e21-5d0b7a6f4c13/overview"
}

El servidor MCP hace lo mismo con la herramienta site_summary.