Documentación para desarrolladores

Resultados de Agentic browsing

GET/sites/{siteId}/agentic
Permiso
ai:read
Herramienta MCP
agentic_results

Agentic browsing checks per tested page and device Lighthouse's Agentic browsing category (can an AI agent use the page) from the latest stored PageSpeed run per tested URL and device, newest first. passed of applicable counts pass and fail only. summary: per device, a check passes when it passes on every tested page where it applies.

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

Parámetros

NombreDóndeDetalles
siteIdObligatoriorutastringWebsite id, from GET /sites.
strategyquerymobiledesktopOnly this device; default both.
pagequeryintegerdefault 1, min 1, max 10000Page number, from 1.
perqueryintegerdefault 50, min 1, max 200Results per page, 1 to 200.

Respuesta

200 · application/json

CampoDetalles
totalinteger · required; Tested URL and device pairs
pageinteger · required; This page
perinteger · required; Results per page
hasMoretrue or false · required; More after this page
resultslist of values · required
results[].urlstring
results[].templatestring
results[].strategystring
results[].testedAtstring
results[].lighthouseVersionstring
results[].passednumber
results[].applicablenumber
results[].checkslist of objects
results[].checks[].idstring
results[].checks[].titlestring
results[].checks[].statestring
results[].checks[].value
summaryobject · required; Per device (mobile, desktop); null when that device has no result
summary.mobileobject
summary.mobile.pagesnumber
summary.mobile.passednumber
summary.mobile.applicablenumber
summary.mobile.checkslist of objects
summary.mobile.checks[].idstring
summary.mobile.checks[].titlestring
summary.mobile.checks[].statestring
summary.mobile.checks[].passnumber
summary.mobile.checks[].failnumber
summary.desktop
runninglist of object · required; Re-runs still waiting
budgetobject · required; The website's daily PageSpeed budget, shared with speed tests
budget.perDayinteger · required; PageSpeed runs per website per day (plan)
budget.usedTodayinteger · required; Runs in the last 24 hours
budget.leftinteger · required; Runs left now
budget.nextFreeAtstring or null · required; When the next run frees up, when none is left
notestring · required; How to read the fields
linkaddress (URL) · required; The Performance screen in the app

Errores

EstadoSignificado
400Bad request. Codes: bad_strategy, bad_page, bad_per.
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/agentic"

Respuesta de ejemplo

{
  "total": 1,
  "page": 1,
  "per": 50,
  "hasMore": false,
  "results": [
    {
      "url": "https://acmebikes.com/",
      "template": "home",
      "strategy": "mobile",
      "testedAt": "2026-10-04T02:41:10.000Z",
      "lighthouseVersion": "13.5.0",
      "passed": 1,
      "applicable": 2,
      "checks": [
        {
          "id": "accessibility-tree",
          "title": "Page has a well-formed accessibility tree",
          "state": "pass",
          "value": null
        },
        {
          "id": "llms-txt",
          "title": "Site has a valid llms.txt",
          "state": "fail",
          "value": null,
          "detail": "No llms.txt file was found at the site root.",
          "items": [
            {
              "url": "https://acmebikes.com/llms.txt",
              "message": "Request returned 404"
            }
          ]
        },
        {
          "id": "webmcp-tools",
          "title": "Page exposes WebMCP tools",
          "state": "na",
          "value": null
        }
      ]
    }
  ],
  "summary": {
    "mobile": {
      "pages": 1,
      "passed": 1,
      "applicable": 2,
      "checks": [
        {
          "id": "accessibility-tree",
          "title": "Page has a well-formed accessibility tree",
          "state": "pass",
          "pass": 1,
          "fail": 0
        },
        {
          "id": "llms-txt",
          "title": "Site has a valid llms.txt",
          "state": "fail",
          "pass": 0,
          "fail": 1,
          "detail": "No llms.txt file was found at the site root.",
          "items": [
            {
              "url": "https://acmebikes.com/llms.txt",
              "message": "Request returned 404"
            }
          ]
        }
      ]
    },
    "desktop": null
  },
  "running": [],
  "budget": {
    "perDay": 5,
    "usedToday": 2,
    "left": 3,
    "nextFreeAt": null
  },
  "note": "Lighthouse's Agentic browsing checks, from the latest stored PageSpeed run per URL and device.",
  "link": "https://app.monoranks.com/sites/3f6c2a1e-8b4d-4c7a-9e21-5d0b7a6f4c13/performance#agentic"
}

El servidor MCP hace lo mismo con la herramienta agentic_results.