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

فهرست اکشن ها

GET/sites/{siteId}/actions
Scope
issues:read
ابزار MCP
list_actions

List actions by priority Open issues ordered by severity × page importance × confidence ÷ effort, with the estimated score gain.

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

پارامترها

ناممحلتوضیح
siteIdاجباریpathstringWebsite id, from GET /sites.
limitqueryintegerdefault 25, min 1, max 100Actions to return, at most 100.

پاسخ

200 · application/json

فیلدتوضیح
waitinginteger · required; Actions open 14 days or more, over all of them
actionslist of object · required
actions[].rankinteger · required; Place in the list, from 1
actions[].issueIdstring · required; Issue id
actions[].titlestring · required; Issue title
actions[].severitycritical | serious | warning | low · required
actions[].effortlow | medium | high · required; Work it takes
actions[].prioritynumber · required; Severity × page importance × confidence ÷ effort, one decimal
actions[].estimatedScoreGainnumber or null · required; Site score points fixing it is expected to add
actions[].importancestring · required; How much the affected pages matter, in words
actions[].statusopen | in_progress | recheck_queued | resolved | ignored | reopened · required
actions[].firstSeenstring · required; First found
actions[].ageDaysinteger · required; Days since first found
actions[].waitingWeeksinteger · required; Weeks open, once open 14 days or more; else 0
actions[].writableFieldseo_title | seo_description | canonical | noindex | alt | redirect | · required; The field MonoRanks can write for it; null when none
actions[].linkstring · required; The action 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/actions"

نمونه پاسخ

{
  "waiting": 2,
  "actions": [
    {
      "rank": 1,
      "issueId": "b2e4c6a8-1d3f-4a5b-9c7d-0e2f4a6b8c1d",
      "title": "Meta description missing on 3 pages (/products/*)",
      "severity": "warning",
      "effort": "low",
      "priority": 7.4,
      "estimatedScoreGain": 1.2,
      "importance": "High · 3 URLs · 18% of clicks",
      "status": "open",
      "firstSeen": "2026-09-20T02:40:03.000Z",
      "ageDays": 16,
      "waitingWeeks": 2,
      "writableField": "seo_description",
      "link": "https://app.monoranks.com/sites/3f6c2a1e-8b4d-4c7a-9e21-5d0b7a6f4c13/actions/b2e4c6a8-1d3f-4a5b-9c7d-0e2f4a6b8c1d"
    }
  ]
}

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