Agentic-Browsing-Ergebnisse auflisten
GET
/sites/{siteId}/agentic- Berechtigung
ai:read- MCP-Tool
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.
Die Beschreibungen kommen aus dem OpenAPI-Dokument und sind auf Englisch.
Parameter
| Name | Ort | Details |
|---|---|---|
siteIdPflicht | Pfad | stringWebsite id, from GET /sites. |
strategy | Query | mobiledesktopOnly this device; default both. |
page | Query | integerdefault 1, min 1, max 10000Page number, from 1. |
per | Query | integerdefault 50, min 1, max 200Results per page, 1 to 200. |
Antwort
200 · application/json
| Feld | Details |
|---|---|
total | integer · required; Tested URL and device pairs |
page | integer · required; This page |
per | integer · required; Results per page |
hasMore | true or false · required; More after this page |
results | list of values · required |
results[].url | string |
results[].template | string |
results[].strategy | string |
results[].testedAt | string |
results[].lighthouseVersion | string |
results[].passed | number |
results[].applicable | number |
results[].checks | list of objects |
results[].checks[].id | string |
results[].checks[].title | string |
results[].checks[].state | string |
results[].checks[].value | |
summary | object · required; Per device (mobile, desktop); null when that device has no result |
summary.mobile | object |
summary.mobile.pages | number |
summary.mobile.passed | number |
summary.mobile.applicable | number |
summary.mobile.checks | list of objects |
summary.mobile.checks[].id | string |
summary.mobile.checks[].title | string |
summary.mobile.checks[].state | string |
summary.mobile.checks[].pass | number |
summary.mobile.checks[].fail | number |
summary.desktop | |
running | list of object · required; Re-runs still waiting |
budget | object · required; The website's daily PageSpeed budget, shared with speed tests |
budget.perDay | integer · required; PageSpeed runs per website per day (plan) |
budget.usedToday | integer · required; Runs in the last 24 hours |
budget.left | integer · required; Runs left now |
budget.nextFreeAt | string or null · required; When the next run frees up, when none is left |
note | string · required; How to read the fields |
link | address (URL) · required; The Performance screen in the app |
Fehler
| Status | Bedeutung |
|---|---|
400 | Bad request. Codes: bad_strategy, bad_page, bad_per. |
401 | Missing, unknown or revoked key. Codes: missing_key, invalid_key. |
403 | The key lacks the scope, covers another website, or its owner lost access. Codes: missing_scope, other_site, owner_left, no_owner, forbidden. |
404 | Not found. Codes: not_found. |
429 | Too many requests this hour for this key. Codes: rate_limited. |
Beispielanfrage
curl \
-H "Authorization: Bearer mr_ws_…" \
"https://app.monoranks.com/api/v1/sites/SITE_ID/agentic"const res = await fetch("https://app.monoranks.com/api/v1/sites/SITE_ID/agentic", {
headers: { Authorization: "Bearer mr_ws_…" },
});
if (!res.ok) throw new Error((await res.json()).error.message);
const data = await res.json();import requests
res = requests.get(
"https://app.monoranks.com/api/v1/sites/SITE_ID/agentic",
headers={"Authorization": "Bearer mr_ws_…"},
)
res.raise_for_status()
data = res.json()<?php
$ch = curl_init("https://app.monoranks.com/api/v1/sites/SITE_ID/agentic");
curl_setopt_array($ch, [
CURLOPT_HTTPHEADER => ["Authorization: Bearer mr_ws_…"],
CURLOPT_RETURNTRANSFER => true,
]);
$data = json_decode(curl_exec($ch), true);import axios from "axios";
const { data } = await axios.get("https://app.monoranks.com/api/v1/sites/SITE_ID/agentic", { headers: { Authorization: "Bearer mr_ws_…" } });Beispielantwort
{
"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"
}{
"error": {
"code": "bad_strategy",
"message": "strategy must be mobile or desktop."
}
}{
"error": {
"code": "missing_key",
"message": "Send the key as Authorization: Bearer mr_site_…"
}
}{
"error": {
"code": "missing_scope",
"message": "This key does not have the scope this call needs."
}
}{
"error": {
"code": "not_found",
"message": "Website not found."
}
}{
"error": {
"code": "rate_limited",
"message": "More than 1200 requests this hour for this key."
}
}Der MCP-Server macht dasselbe mit dem Tool agentic_results.