فهرست اکشن ها
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اجباری | path | stringWebsite id, from GET /sites. |
limit | query | integerdefault 25, min 1, max 100Actions to return, at most 100. |
پاسخ
200 · application/json
| فیلد | توضیح |
|---|---|
waiting | integer · required; Actions open 14 days or more, over all of them |
actions | list of object · required |
actions[].rank | integer · required; Place in the list, from 1 |
actions[].issueId | string · required; Issue id |
actions[].title | string · required; Issue title |
actions[].severity | critical | serious | warning | low · required |
actions[].effort | low | medium | high · required; Work it takes |
actions[].priority | number · required; Severity × page importance × confidence ÷ effort, one decimal |
actions[].estimatedScoreGain | number or null · required; Site score points fixing it is expected to add |
actions[].importance | string · required; How much the affected pages matter, in words |
actions[].status | open | in_progress | recheck_queued | resolved | ignored | reopened · required |
actions[].firstSeen | string · required; First found |
actions[].ageDays | integer · required; Days since first found |
actions[].waitingWeeks | integer · required; Weeks open, once open 14 days or more; else 0 |
actions[].writableField | seo_title | seo_description | canonical | noindex | alt | redirect | · required; The field MonoRanks can write for it; null when none |
actions[].link | string · required; The action in the app |
خطاها
| کد | معنی |
|---|---|
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. |
نمونه درخواست
curl \
-H "Authorization: Bearer mr_ws_…" \
"https://app.monoranks.com/api/v1/sites/SITE_ID/actions"const res = await fetch("https://app.monoranks.com/api/v1/sites/SITE_ID/actions", {
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/actions",
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/actions");
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/actions", { headers: { Authorization: "Bearer mr_ws_…" } });نمونه پاسخ
{
"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"
}
]
}{
"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."
}
}سرور MCP همین کار را با ابزار list_actions انجام می دهد.