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

خلاصه یک سایت

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

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

پارامترها

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

پاسخ

200 · application/json

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

خطاها

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

نمونه پاسخ

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

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