آخرین به‌روزرسانی:
با API سئو جت سئو و یک کلید شخصی، رتبه کلمات کلیدی، خطاهای سایت و گزارشهای ذخیره‌شده‌تان را از برنامه خودتان، n8n یا دستیاری مثل Claude بخوانید. اگر اجازه بدهید، همان ابزارهای پنل هم از همین راه اجرا می‌شوند و گزارششان در حساب شما می‌ماند.
curl -H "Authorization: Bearer jsk_YOUR_KEY" \
https://coreapi.jetseo.ir/v1/sites
curl -H "Authorization: Bearer jsk_YOUR_KEY" \
https://coreapi.jetseo.ir/v1/ranks/today
curl -X POST \
-H "Authorization: Bearer jsk_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"siteId":123,"keyword":"کفش رانینگ"}' \
"https://coreapi.jetseo.ir/v1/tools/content_structure?wait=25"API سئو جت سئو راهی است که برنامه‌ها با یک کلید شخصی دادههای حساب شما را بخوانند: رتبه کلمات، خطاهای سایت و گزارش‌ها. MCP سئو همان دادهها و ابزارها را به دستیارهای هوش مصنوعی مثل Claude میدهد تا با یک سؤال فارسی، خودشان ابزار درست را صدا بزنند.
API برای برنامه‌نویس‌ها، اسکریپت‌ها و اتوماسیون است و با درخواست HTTP کار میکند. MCP برای کسی است که ترجیح میدهد از دستیارش بپرسد.
هر دو با همان کلیدها، همان اعتبار و همان محدودیت‌ها کار می‌کنند. خواندن داده رایگان است و فقط وقتی اعتبار کم میشود که با کلید یک ابزار اجرا شود و گزارش تازه ساخته شود.
رتبه هر کلمه با تاریخچه روزانه تا ۹۰ روز، به‌علاوه تغییرات امروز و بزرگ‌ترین جابه‌جایی‌ها، برای داشبورد یا گزارش هفتگی خودتان.
خطاهای فنی و محتوایی هر سایت با تعداد صفحهها و فهرست صفحه‌های هر خطا، تا در ابزار مدیریت پروژه تیم تسک بسازید.
هشدارهای باز سایتها و گزارش هر آدرس از آخرین بررسی، مناسب برای پیام خودکار در کانال تیم.
حجم جستجو، سختی و نیت جستجوی یک کلمه، وقتی می‌خواهید در صفحه‌گسترده یا اسکریپت خودتان کلمه‌ها را دسته کنید.
هر گزارشی که در پنل یا با کلید ساخته‌اید، با شناسه‌اش دوباره خوانده میشود و هزینه‌ای ندارد.
صفحات برتر، کلمات کلیدی رقبا، شکاف کلمات، خوشه‌بندی، ساختار محتوا، رپورتاژیاب، تولید و بازنویسی محتوا و چند ابزار دیگر، فقط روی سایت‌های خود شما.
وقتی جت سئو را به دستیارتان وصل کنید، لازم نیست آدرس و پارامتر بدانید. به فارسی میپرسید و دستیار خودش ابزار درست را صدا می‌زند.
آدرس MCP جت سئو روی سروری بیرون از ایران است تا دستیارهای ابری مثل claude.ai هم به آن برسند. اگر درباره دیده شدن سایت در پاسخ همین دستیارها کنجکاوید، مقاله GEO چیست را هم بخوانید.
| شما میپرسید | ابزار MCP |
|---|---|
| سایت‌هایم در جت سئو را با وضعیت سلامت نشان بده | list_sites |
| کدام کلمات کلیدی امروز افت کرده‌اند؟ | get_rank_changes_today |
| خطاهای فنی shop-sample.ir را به ترتیب اهمیت بگو | get_site_issues |
| برای «کفش رانینگ» ساختار محتوا بساز | run_content_structure |
اول ببینید چه چیزی در دسترس است: صفحه «API و MCP» با فهرست ابزارها و اعتبار هر کدام، بعد از ثبت‌نام در پنل باز است.
دیدن صفحه APIنکته: در claude.ai اگر پیام «Couldn't check the server» آمد، «Continue anyway» را بزنید و در بخش Authentication گزینه No sign-in را انتخاب کنید. بعد در یک گفتگوی تازه، از دکمه «+» بخش Connectors کانکتور جت سئو را روشن کنید.
رتبه و خطاهای سایت را با یک درخواست HTTP به داشبورد، CMS یا ابزار گزارش‌گیری داخلی می‌آورید، بدون اینکه کسی هر روز از پنل خروجی بگیرد.
برای هر مشتری گزارش رتبه و خطا را خودکار می‌سازید و هر اتصال را با کلید جدا و سقف ماهانه جدا کنترل میکنید.
به فارسی میپرسید کدام کلمه افت کرده یا کدام خطا اولویت دارد و جواب را از داده حساب خودتان می‌گیرید.
هشدارهای باز و تغییرات رتبه را به پیام کانال تیم یا تسک تبدیل میکنید؛ نود MCP Client Tool یا HTTP Request کافی است.
API یک سرویس REST ساده است. کلید را در هدر Authorization با Bearer یا در هدر X-API-Key می‌فرستید و پاسخ را JSON می‌گیرید. فهرست کامل آدرس‌ها و ورودی هر ابزار در صفحه Swagger آمده است. این آدرس‌ها رایگان خوانده می‌شوند:
| آدرس | چه میدهد |
|---|---|
| GET /v1/sites | سایت‌های حساب با شناسه هر کدام |
| GET /v1/sites/{siteId}/issues | خطاهای فنی و محتوایی با تعداد صفحهها |
| GET /v1/sites/{siteId}/ranks | رتبه کلمات با تاریخچه روزانه تا ۹۰ روز |
| GET /v1/ranks/today | تغییرات رتبه امروز |
| GET /v1/alerts | هشدارهای باز سایتها |
| GET /v1/reports | گزارشهای ذخیرهشده |
اجرای ابزارها ناهمگام است. درخواست اجرا را می‌فرستید و می‌گویید تا چند ثانیه منتظر بماند. اگر گزارش آماده شد همان‌جا برمی‌گردد؛ اگر نه، یک شناسه کار می‌گیرید و هر چند ثانیه وضعیتش را میپرسید.
| کد پاسخ | یعنی چه |
|---|---|
| 401 | کلید نادرست است یا باطل شده |
| 402 | سقف ماهانه همین کلید پر شده |
| 403 | بسته، کلید فقط‌خواندنی یا سایت اشتراکی اجازه این کار را نمی‌دهد |
| 409 | اجرای دیگری در همین حساب در جریان است |
| 429 | درخواست‌ها از حد مجاز گذشته؛ کمی صبر کنید |
هر پاسخ خطا یک فیلد error و یک پیام فارسی دارد، پس می‌توانید همان پیام را به کاربر خودتان نشان دهید.
آژانسی برای فروشگاه shop-sample.ir می‌خواهد هر صبح بداند کدام کلمه‌ها افت کرده‌اند، بی‌آنکه کسی پنل را باز کند. دامنه و عددهای این بخش نمونه‌اند.
برای کارهایی که اعتبار مصرف می‌کنند، مثل ساختار محتوا برای یک کلمه تازه، آژانس کلید دومی با اجازه اجرا و سقف ماهانه می‌سازد. اگر آن گردش کار اشتباهی تکرار شود، بیشتر از سقف همان کلید مصرف نمیکند.
| موضوع | قاعده |
|---|---|
| کلید فعال | حداکثر ۵ کلید همزمان |
| سرعت درخواست | ۶۰ درخواست در دقیقه برای هر کلید و ۵٬۰۰۰ در روز برای هر حساب |
| اجرای ابزار | در هر حساب یک اجرا در هر لحظه؛ با همان اعتبار پنل |
| خواندن داده و ساخت کلید | رایگان |
| سایت‌های اشتراکی | فقط خواندنی؛ ابزارها فقط روی سایت‌های خود شما اجرا می‌شوند |
| دوره ۷ روز رایگان | صفحه را میبینید، ولی ساخت کلید باز نیست |
کلید فقط یک بار، درست بعد از ساختن، نمایش داده میشود و خودش در جت سئو نگه داشته نمی‌شود. آن را فقط روی سرور خودتان بگذارید، نه در کد صفحه وب یا اپ موبایل. اگر کلیدی لو رفت، باطلش کنید و کلید تازه بسازید.
با حالت پروژه، کلید در فایل تنظیم همان پروژه ذخیره میشود و ممکن است همراه کد منتشر شود. حالت کاربر جت سئو را در همه پوشه‌ها در دسترس می‌گذارد و کلید را بیرون از پروژه نگه می‌دارد.
جدول کلیدها مصرف این ماه، تعداد درخواست ۳۰ روز اخیر و آخرین استفاده هر کلید را نشان میدهد. اگر یک اتصال رفتار عجیبی داشت، زود پیدایش میکنید. اگر فقط می‌خواهید از افت رتبه و خطای تازه باخبر شوید، هشدارهای سئو بدون کدنویسی همین کار را میکند.
ابزارهای خارجی هم API دارند، ولی برای تیمی که سایت فارسی و بازار ایران را دنبال میکند، چند فرق مهم است:
| جت سئو | ابزارهای خارجی | |
|---|---|---|
| داده | رتبه در گوگل ایران و سایت‌هایی که در پنل دنبال میکنید | داده بازار ایران معمولاً محدودتر |
| پیام‌های خطا و راهنما | فارسی | انگلیسی |
| هزینه | خواندن رایگان؛ اجرا با همان اعتبار پنل | معمولاً اشتراک جدا و دلاری |
| دستیار هوش مصنوعی | سرور MCP آماده با راهنمای فارسی | بسته به ابزار |
مقایسه کامل‌تر در صفحه جت سئو یا Ahrefs و Semrush آمده است. ابزارهایی را که از راه API اجرا می‌شوند، در صفحه ابزارهای سئو و صفحه‌هایی مثل ساختار محتوا و رپورتاژیاب ببینید.
سایتها و سلامتشان، خطاهای فنی و محتوایی با فهرست صفحهها، رتبه کلمات کلیدی با تاریخچه روزانه تا ۹۰ روز، تغییرات رتبه امروز، هشدارها، گزارش هر صفحه، حجم و سختی کلمات و گزارشهای ذخیرهشده. خواندن همه اینها رایگان است.
MCP راهی است که دستیار هوش مصنوعی ابزارهای یک سرویس را بشناسد و خودش صدا بزند. با MCP جت سئو کافی است به فارسی از دستیارتان بپرسید کدام کلمات امروز افت کرده‌اند؛ دستیار داده را از حساب شما می‌خواند و جواب میدهد.
در صفحه «API و MCP» کلید بسازید و آدرس آماده کادر Claude را در claude.ai، بخش Connectors، به‌عنوان کانکتور سفارشی اضافه کنید. همین کانکتور در برنامه دسکتاپ و موبایل Claude هم کار میکند.
سرور MCP جت سئو برای هر دستیاری است که از MCP روی HTTP پشتیبانی کند. راهنمای قدم‌به‌قدم پنل فعلاً برای Claude، Claude Code، Cursor، VS Code و n8n نوشته شده است.
نه. برای Claude یک آدرس آماده را در بخش Connectors اضافه میکنید و بعد به فارسی سؤال میپرسید. برای Claude Code، Cursor و VS Code هم دستور یا تنظیم آماده در همان صفحه هست.
تا ۵ کلید فعال همزمان. هر کلید تا ۶۰ درخواست در دقیقه و هر حساب تا ۵٬۰۰۰ درخواست در روز. در هر حساب هم در هر لحظه یک ابزار اجرا میشود.
همان مقداری که اجرای همان ابزار در پنل مصرف میکند، و فقط وقتی گزارش ساخته شود. خواندن دادهها و ساختن کلید چیزی کم نمیکند. جدول ابزارها و اعتبار هر کدام در صفحه «API و MCP» آمده است.
کلید فقط یک بار، درست بعد از ساختن، نمایش داده میشود و جت سئو خود کلید را نگه نمیدارد. MCP به فایلهای کامپیوتر شما کاری ندارد و فقط به حساب جت سئوی شما وصل میشود. هر کلید را هر وقت بخواهید باطل میکنید.
در دوره رایگان صفحه «API و MCP» و امکاناتش را میبینید، ولی ساخت کلید فقط در بستههایی باز است که این امکان را دارند. فهرست امکانات هر بسته در صفحه تعرفهها آمده است.