مستندات توسعه دهندگان
کلیدهای API و scopeها
هر کلید همان دسترسی یک شخص است که به چند سایت و چند scope محدود شده. دسترسی کلید را فقط به اندازه ای بدهید که کارش لازم دارد.
دو نوع کلید
| کلید | کجا ساخته می شود | دسترسی به | پیشوند |
|---|---|---|---|
| کلید فضای کاری | Settings → Developer access → New key | همه سایت ها، یا سایت هایی که تیک می زنید | mr_ws_… |
| کلید سایت | وقتی افزونه WordPress وصل می شود، خودکار ساخته می شود | یک سایت | mr_site_… |
Settings برای سایت های خودتان است. برای فضای کاری ای که کسی با شما به اشتراک گذاشته، تنظیماتش را از ⋯ کنار گروهش در لیست سایت ها باز کنید (فقط اگر اجازه تغییرش را دارید). برای اسکریپت ها و دستیارهای خودتان کلید فضای کاری بسازید و فقط سایت هایی را تیک بزنید که لازم دارد. هر دو نوع کلید در Settings → Developer access با زمان آخرین استفاده لیست می شوند، تا کلیدهای بلااستفاده را راحت پیدا کنید. هر کلید فقط یک بار نمایش داده می شود و سقفش 1,200 درخواست در ساعت است.
Scopeها
وقتی کلیدی می سازید یا ویرایش می کنید، اپ scopeها را زیر What it may do با همان برچسب ساده ای که اینجا می بینید لیست می کند.
| Scope | برچسب در اپ | چه اجازه ای می دهد |
|---|---|---|
sites:read |
Read website details and scores | خلاصه سایت، امتیازها و تاریخچه، نتیجه تست های سرعت، portfolio همه سایت های کلید، بررسی ها |
pages:read |
Read pages and findings | صفحه های کراول شده، یافته های هر صفحه و تاریخچه صفحه |
issues:read |
Read issues and actions | مشکل ها با شواهد، توضیح های هوش مصنوعی، مقدارهای پیشنهادی، اکشن ها به ترتیب اولویت |
search:read |
Read search performance | خلاصه و ردیف های Search Console، موضوع ها، کلمات کلیدی، رقبا و شکاف کلمات کلیدی، بک لینک ها و موردهای جذب لینک |
analytics:read |
Read Google Analytics conversions and revenue | تبدیل ها و درآمد هر صفحه ورود از Google Analytics (GA4) سایت |
ai:read |
Read AI visibility and AI readiness | دیده شدن در هوش مصنوعی، سؤال هایی که سایت شما در جوابشان نیست، دسترسی خزنده های هوش مصنوعی، llms.txt و نتیجه های Agentic browsing |
content:write |
Send content and change alerts | افزونه WordPress با آن محتوا را می فرستد؛ برای اسکریپت های خودتان نیست |
issues:recheck |
Start rechecks | گذاشتن بررسی دوباره در صف، یا اجرای دوباره تست Agentic browsing برای یک صفحه |
audits:run |
Start audits | شروع بررسی کامل (برای خواندن بررسی ها sites:read لازم است) |
actions:apply |
Apply approved fixes to the website | تأیید تغییر عنوان سئو، توضیحات متا، canonical یا noindex، و همچنین llms.txt و قوانین خزنده های هوش مصنوعی؛ این تغییرها از طریق اتصال WordPress نوشته می شوند؛ تعیین وضعیت و یادداشت یک مورد جذب لینک؛ انتخاب، کنار گذاشتن یا اضافه کردن رقبا |
کلیدی که افزونه WordPress استفاده می کند، علاوه بر content:write، sites:read و pages:read را هم دارد تا بتواند امتیازهای همان سایت را برای صفحه های خودش بخواند.
تغییر کلید
با Edit روی کلید، اسم و scopeهایش را تغییر می دهید؛ در کلید فضای کاری، سایت هایش را هم. خود کلید عوض نمی شود، پس لازم نیست جایی کلید جدید بگذارید. کلید سایت همیشه به همان سایت وصل می ماند. کلیدی که افزونه WordPress استفاده می کند، اسمش و scopeهایی را که لازم دارد حفظ می کند. کلیدهایی که قبل از اضافه شدن یک scope ساخته شده اند (مثلاً ai:read، audits:run یا analytics:read) آن scope را ندارند؛ با Edit اضافه اش کنید.
Tokenهای OAuth
وقتی یک MCP client به جای گرفتن کلید، خودش شما را وارد می کند (مثلاً ChatGPT)، دسترسی اش را یک بار تأیید می کنید. فقط می تواند این scopeها را بخواهد: sites:read، pages:read، issues:read، search:read، analytics:read، ai:read و issues:recheck. یعنی می تواند داده ها را بخواند و بررسی دوباره را در صف بگذارد، اما هیچ وقت نمی تواند بررسی کامل شروع کند، تغییری در سایت شما بنویسد، موردهای جذب لینک را به روز کند یا رقبا را تغییر دهد (audits:run، actions:apply و content:write هیچ وقت از این راه داده نمی شوند).
پشت این توکن یک کلید فضای کاری است که اسمش از روی کلاینت گذاشته می شود، مثلاً «ChatGPT (OAuth)». این کلید در همان لیست Settings → Developer access دیده می شود و به همان روش باطل می شود. هر access token یک ساعت اعتبار دارد و کلاینت خودش آن را تمدید می کند؛ اگر 30 روز از کلاینت استفاده نکنید، دوباره از شما می خواهد وارد شوید. اتصالی که قبل از اضافه شدن analytics:read ساخته شده آن را ندارد؛ برای اضافه کردنش، کلاینت را دوباره وصل کنید.
باطل کردن کلید
روی کلید، Settings → Developer access → Revoke را بزنید. از همان لحظه، درخواست هایی که با این کلید فرستاده شوند با 401 رد می شوند. کلید افزونه WordPress را هم می توانید همین جا باطل کنید؛ بعد از آن، افزونه وضعیت «disconnected» را نشان می دهد و دیگر چیزی نمی فرستد.
سؤال های رایج
کلیدم را گم کرده ام. می توانم دوباره ببینمش؟
نه. MonoRanks فقط یک fingerprint از کلید نگه می دارد. کلید قبلی را باطل کنید و یک کلید جدید بسازید.
می شود به کلیدی که دارم دسترسی بیشتری بدهم؟
بله. با Edit روی کلید، اسم، scopeها و سایت هایش را تغییر می دهید. خود کلید عوض نمی شود، پس جاهایی که از آن استفاده می کنند به کلید جدید نیاز ندارند.
چه کسی می تواند کلید بسازد؟
همه، برای سایت های خودشان. در فضای کاری اشتراکی فقط مالک و اعضایی که همه سایت ها را می بینند. هیچ کلیدی از آنچه سازنده اش می بیند فراتر نمی رود، و اگر سازنده بیننده مشتری شود یا از فضای کاری خارج شود، کلید دیگر کار نمی کند.