مستندات توسعه دهندگان

نتیجه های Agentic browsing

GET/sites/{siteId}/agentic
Scope
ai:read
ابزار 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.

توضیح ها از سند OpenAPI می آیند و انگلیسی اند.

پارامترها

ناممحلتوضیح
siteIdاجباریpathstringWebsite 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.

پاسخ

200 · application/json

فیلدتوضیح
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

خطاها

کدمعنی
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.

نمونه درخواست

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

نمونه پاسخ

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

سرور MCP همین کار را با ابزار agentic_results انجام می دهد.