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

دیدن یک اجرای دوباره

GET/sites/{siteId}/agentic/runs/{jobId}
Scope
ai:read
ابزار MCP
agentic_results

One Agentic browsing re-run: status and result Poll every 15 seconds or so until status is done (with result) or failed (with error). The MCP tool agentic_results does the same with job_id.

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

پارامترها

ناممحلتوضیح
siteIdاجباریpathstringWebsite id, from GET /sites.
jobIdاجباریpathstringRun id, from POST /agentic/run.

پاسخ

200 · application/json

فیلدتوضیح
jobIdstring · required; Run id
urlstring · required; Page
strategymobile | desktop · required; Device PageSpeed emulated
queuedAtstring or null · required
startedAtstring or null · required
finishedAtstring or null · required
statusqueued | running | done | failed · required; Run state
resultobject · required; The result once done
result.urlstring
result.templatestring
result.strategystring
result.testedAtstring
result.lighthouseVersionstring
result.passednumber
result.applicablenumber
result.checkslist of objects
result.checks[].idstring
result.checks[].titlestring
result.checks[].statestring
result.checks[].value
errorstring or null · required; Why it failed, in plain words (also set when done without Agentic checks)
linkaddress (URL) · The Performance screen in the app

خطاها

کدمعنی
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/runs/JOB_ID"

نمونه پاسخ

{
  "jobId": "a1c3e5f7-9b1d-4f3b-8d5f-7b9d1f3b5d7e",
  "url": "https://acmebikes.com/",
  "strategy": "mobile",
  "queuedAt": "2026-10-06T09:31:00.000Z",
  "startedAt": "2026-10-06T09:31:02.000Z",
  "finishedAt": "2026-10-06T09:31:41.000Z",
  "status": "done",
  "result": {
    "url": "https://acmebikes.com/",
    "template": "home",
    "strategy": "mobile",
    "testedAt": "2026-10-06T09:31:40.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
      }
    ]
  },
  "error": null,
  "link": "https://app.monoranks.com/sites/3f6c2a1e-8b4d-4c7a-9e21-5d0b7a6f4c13/performance#agentic"
}

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