صفحه اصلی / توسعه‌دهندگان

API و سرور MCP

کل کاتالوگ، قابل خواندن از کد خودتان یا یک دستیار هوش مصنوعی: هر پنل با Trust Score، ستاره‌ها، قیمت‌های زنده، شمارنده سفارش و بازار آن؛ همان اعدادی که صفحه‌ها نشان می‌دهند و هرگز قدیمی‌تر از یک ساعت نیستند. کلید رایگان، فقط‌خواندنی، OpenAPI 3.1.

۱۱٬۷۷۴ پنل ۴٬۶۷۳ آنلاین امروز ۳٬۱۳۱٬۸۷۵ قیمت به‌روز 14 بازار

کلید در یک دقیقه

یک کلید برای هر حساب، رایگان و فقط‌خواندنی. این کلید به‌جای مرورگر، شما را شناسایی می‌کند؛ بنابراین سپر ضد اسکرپینگ برای آن کنار می‌رود.

1ورود یا ثبت‌نامیک حساب شخصی کافی است؛ نیازی به پنل نیست.
2حساب ← تنظیمات ← API و MCPروی ساخت کلید API بزنید. کلید فقط یک بار نمایش داده می‌شود: آن را کپی کنید. هر زمان می‌توانید کلید جدیدی بسازید.
3آن را به‌صورت توکن bearerAuthorization: Bearer sg_… در هر درخواست بفرستید. X-Api-Key و ?api_key= هم کار می‌کنند.

اندپوینت‌ها

نشانی پایه https://smm.guide/api/v1. ورودی JSON، خروجی JSON. پنل‌ها فقط به‌صورت آنلاین برگردانده می‌شوند، مگر اینکه درخواست کنید status=all؛ قیمت‌ها به دلار آمریکا برای هر ۱٬۰۰۰ است و با نرخ همان روز تبدیل می‌شود.

اندپوینتآنچه برمی‌گرداندپارامترها
GET /panelsصفحه‌ای از پنل‌ها با نمره، ستاره‌ها، قیمت شروع، شمارنده، سن، موتور و نشان مالک.q نام یا دامنه · market · platform · engine · status online | offline | all · verified · api · sort rank | trust | rating | orders | age | price · page, per_page ≤ 50
GET /panels/{panel}یک پنل با همه اعداد سنجیده‌شده: Trust Score و اجزای آن، پلتفرم‌های پشت ستاره‌ها، تاریخ‌های دامنه، لیست قیمت به تفکیک شبکه، شمارنده، وضعیت، لینک‌ها.slug (prm4u-com) یا دامنه (prm4u.com)
GET /panels/{panel}/servicesلیست قیمت عمومی، ارزان‌ترین شبکه اول.platform · kind followers | likes | views | … · q · page, per_page ≤ 100
GET /marketsبازارهای کشوری و زبانی و بازار API، همراه با تعداد و قاعده هر کدام.—
GET /platformsشبکه‌هایی که جایی در کاتالوگ لیست قیمت عمومی دارند، با کمترین نرخ.—
GET /statsآمار کلی کاتالوگ.—

درخواست

curl "https://smm.guide/api/v1/panels?market=india&sort=trust&per_page=3" \
  -H "Authorization: Bearer sg_…"

پاسخ، خلاصه‌شده

{
  "data": [
    {
      "slug": "app-smmowl-com",
      "name": "app.smmowl.com",
      "website": "app.smmowl.com",
      "url": "https://smm.guide/panels/app-smmowl-com/",
      "online": true,
      "trust_score": 69,
      "trust_band": "Solid",
      "rating": 4.3,
      "reviews": 411,
      "services": 1028,
      "price_from_usd_per_1k": 0.00107,
      "orders": 2281526,
      "since": "2022",
      "engine": "Perfect Panel",
      "owner_verified": false,
      "mark": null,
      "api": true,
      "updated_at": "2026-11-21"
    },
    …
  ],
  "page": 1,
  "per_page": 3,
  "total": 253,
  "pages": 85
}

خطاها به این شکل برمی‌گردند: {"error":{"code":"…","message":"…"}} همراه با وضعیت HTTP متناظر: 401 بدون کلید، 403 برای کلید باطل‌شده، 404 برای پنل ناشناخته، 422 برای پارامتر نادرست، 429 پس از عبور از سقف. قرارداد کامل در سند OpenAPI 3.1 آمده است؛ آن را در هر ابزار تولید کلاینت یا در یک GPT action بچسبانید.

سرور MCP برای دستیارها

Claude، ChatGPT، Cursor و هر کلاینت دیگری که از Model Context Protocol پشتیبانی می‌کند، می‌تواند کاتالوگ را مستقیم بخواند. کافی است این نشانی را اضافه کنید: https://smm.guide/mcp به‌عنوان سرور راه دور. Streamable HTTP، بدون نیاز به نگه‌داشتن نشست، 9 ابزار. در MCP Registry رسمی با نام guide.smm/catalog.

ابزارها

  • search_panelsپنل‌های SMM را در کاتالوگ smm.guide بر اساس نام یا دامنه، بازار (کشور/زبان یا "api")، شبکه دارای لیست قیمت عمومی، موتور و مالک تأییدشده پیدا کنید.
  • get_panelهمه ارقام اندازه‌گیری‌شده برای یک پنل: Trust Score با اجزای آن، ستاره‌ها و پلتفرم‌های پشت آن‌ها، تاریخ‌های دامنه، خلاصه لیست قیمت برای هر شبکه، شمارنده سفارش‌ها، وضعیت آنلاین، لینک کارت و نشان.
  • list_servicesلیست قیمت عمومی یک پنل به دلار آمریکا برای هر ۱٬۰۰۰، ارزان‌ترین شبکه اول.
  • search_servicesWhere a service is cheapest across all panels in the catalog: offers of one network and, optionally, one kind (followers, likes, views, comments, subscribers, members, shares, live …), cheapest first, one offer per panel, in US dollars per 1,000, with the panel, its Trust Score and links.
  • compare_panelsدو تا پنج پنل کنار هم: Trust Score، ستاره‌ها و تعداد نظرات، قیمت شروع، سرویس‌ها، شمارنده سفارش‌ها، سن، مالک تأییدشده، وضعیت آنلاین — و صفحه‌ای در smm.guide که آن‌ها را مقایسه می‌کند.
  • search_toolsابزارهای راه‌اندازی و اداره کسب‌وکار پنل SMM: اسکریپت‌های پنل (نرم‌افزار)، درگاه‌های پرداخت، هاست، ثبت‌کننده‌های دامنه، تأیید پیامکی، پروکسی، VPN و پلتفرم‌های تعامل — هر کدام با Trust Score، نظرات و لینک.
  • list_guidesمقاله‌های smm.guide: نحوه انتخاب و مقایسه پنل‌های SMM، محبوب‌ترین پنل‌ها، راه‌اندازی پنل، راهنماهای پرداخت و کسب درآمد.
  • list_marketsبازارهای کشوری و زبانی (هند، ترکیه، برزیل، روسیه و کشورهای مستقل مشترک‌المنافع، کره، تایلند، اندونزی، نیجریه، ویتنام، چینی، عربی، اسپانیایی)، "international" برای پنل‌هایی بدون نشانه محلی و بازار "api" — هر کدام با تعداد پنل‌های آنلاین و قاعده‌ای که پنل را در آن قرار می‌دهد.
  • catalog_statsچند پنل پایش می‌شوند و چند پنل آنلاین‌اند، مالکان تأییدشده، پنل‌های دارای API، ابزارها، قیمت‌های زنده، نظرات خوانده‌شده و پلتفرم‌های نظردهی.

Claude Code

claude mcp add --transport http smm-guide https://smm.guide/mcp \
  --header "Authorization: Bearer sg_…"

Cursor، VS Code، Windsurf — mcp.json

{
  "mcpServers": {
    "smm-guide": {
      "url": "https://smm.guide/mcp",
      "headers": { "Authorization": "Bearer sg_…" }
    }
  }
}

Claude.ai و Claude Desktop

Settings → Connectors → Add custom connector ← بچسبانید https://smm.guide/mcp. بدون کلید هم سرور پاسخ می‌دهد، با 30 فراخوانی در دقیقه برای هر آدرس.

محدودیت‌ها و شرایط

  • 60 درخواست در دقیقه، ۵٬۰۰۰ درخواست در روز برای هر کلید. سرآیندهای X-RateLimit-Limit و X-RateLimit-Remaining وضعیت شما را نشان می‌دهند؛ پاسخ 429 همراه است با Retry-After.
  • فقط‌خواندنی، با همان اعداد صفحه‌ها. هیچ چیزی در API منتشرنشده نیست و هیچ چیزی در صفحه‌ها از API پنهان نیست. هر دو با یک برنامه به‌روز می‌شوند: شمارنده‌ها هر ساعت و لیست‌های قیمت به‌صورت بخش‌بخش در تمام شبانه‌روز.
  • با لینک نقل کنید. وقتی عددی در محصول، گزارش یا پاسخ شما قرار می‌گیرد، به صفحه پنل در smm.guide لینک دهید؛ جایی که تاریخ و منابع کنار آن آمده است.
  • بدون کپی از شاخص قیمت. از داده‌ها درون محصول خود استفاده کنید؛ کاتالوگ یا لیست‌های قیمت را به‌عنوان مجموعه داده دوباره منتشر نکنید. کلیدها شخصی‌اند و قابل ابطال.
  • حضور در کاتالوگ به معنای توصیه نیست. کاتالوگ می‌سنجد؛ ضمانت نمی‌کند. ببینید نمره چگونه ساخته می‌شود و هر عدد از کجا می‌آید.

روی این داده‌ها چیزی می‌سازید؟

به ما بگویید چه می‌سازید. یک فیلد یا فیلتر جاافتاده برای ما تغییر کوچکی است.