Domů / Pro vývojáře

API a MCP server

Celý katalog, čitelný z vašeho kódu nebo z AI asistenta: každý panel s Trust Score, hvězdičkami, aktuálními cenami, počítadlem objednávek a trhem – stejné údaje jako na stránkách, nikdy starší než hodinu. Klíč zdarma, jen pro čtení, OpenAPI 3.1.

11 774 panelů 4 673 online dnes 3 131 875 aktuálních cen 14 trhů

Klíč za minutu

Jeden klíč na účet, zdarma, jen pro čtení. Identifikuje vás místo prohlížeče, takže mu ochrana proti scrapingu uhne z cesty.

1Přihlaste se nebo se zaregistrujteStačí osobní účet; panel není potřeba.
2Účet → Nastavení → API a MCPKlikněte na Vytvořit klíč API. Klíč se zobrazí jednou: zkopírujte si ho. Nový můžete vytvořit kdykoli.
3Posílejte ho jako bearer tokenAuthorization: Bearer sg_… u každého požadavku. X-Api-Key a ?api_key= fungují také.

Endpointy

Základní URL https://smm.guide/api/v1. JSON dovnitř, JSON ven. Vracíme jen panely online, pokud si nevyžádáte status=all; ceny jsou v amerických dolarech za 1 000, přepočtené denním kurzem.

EndpointCo vracíParametry
GET /panelsStránka panelů se skóre, hvězdičkami, cenou od, počítadlem, stářím, enginem a značkou vlastníka.q název nebo doména · market · platform · engine · status online | offline | all · verified · api · sort rank | trust | rating | orders | age | price · page, per_page ≤ 50
GET /panels/{panel}Jeden panel se všemi změřenými údaji: Trust Score a jeho složky, platformy za hvězdičkami, data domény, ceník podle sítí, počítadlo, stav, odkazy.slug (prm4u-com) nebo doména (prm4u.com)
GET /panels/{panel}/servicesVeřejný ceník, nejlevnější síť první.platform · kind followers | likes | views | … · q · page, per_page ≤ 100
GET /marketsTrhy podle zemí a jazyků a trh API, s počty a pravidlem za každým z nich.—
GET /platformsSítě, které mají někde v katalogu veřejný ceník, s nejnižší sazbou.—
GET /statsSouhrny katalogu.—

Požadavek

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

Odpověď, zkráceně

{
  "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
}

Chyby přicházejí jako {"error":{"code":"…","message":"…"}} s odpovídajícím stavem HTTP: 401 bez klíče, 403 u zneplatněného klíče, 404 u neznámého panelu, 422 u chybného parametru, 429 po překročení limitu. Úplný kontrakt je v dokumentu OpenAPI 3.1 – vložte ho do libovolného generátoru klientů nebo do akce GPT.

MCP server pro asistenty

Claude, ChatGPT, Cursor a jakýkoli další klient, který umí Model Context Protocol, může katalog číst přímo: přidejte https://smm.guide/mcp jako vzdálený server. Streamable HTTP, bez nutnosti udržovat relaci, 9 nástrojů. V oficiálním MCP Registry jako guide.smm/catalog.

Nástroje

  • search_panelsVyhledává SMM panely v katalogu smm.guide podle názvu nebo domény, trhu (země/jazyk nebo „api“), sítě s veřejným ceníkem, platformy (engine) a ověřeného vlastníka.
  • get_panelVšechny naměřené údaje jednoho panelu: Trust Score s jeho složkami, hvězdičky a platformy, ze kterých pocházejí, data domény, souhrn ceníku podle sítí, počítadlo objednávek, stav online, odkazy na profil a odznak.
  • list_servicesVeřejný ceník panelu v amerických dolarech za 1 000, od nejlevnější sítě.
  • 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_panelsDva až pět panelů vedle sebe: Trust Score, hvězdičky a počet recenzí, cena od, služby, počítadlo objednávek, stáří, ověřený vlastník, stav online – a stránka smm.guide, která je porovnává.
  • search_toolsNástroje pro založení a provoz SMM panelu: skripty panelů (software), platební brány, hosting, registrátoři domén, SMS ověření, proxy, VPN a platformy pro engagement – každý s Trust Score, recenzemi a odkazem.
  • list_guidesČlánky smm.guide: jak vybírat a porovnávat SMM panely, nejoblíbenější panely, založení panelu, průvodci platbami a výdělkem.
  • list_marketsTrhy podle zemí a jazyků (Indie, Turecko, Brazílie, Rusko a SNS, Korea, Thajsko, Indonésie, Nigérie, Vietnam, čínština, arabština, španělština), „international“ pro panely bez místního signálu a trh „api“ – u každého počet panelů online a pravidlo, podle kterého se tam panel dostane.
  • catalog_statsKolik panelů sledujeme a kolik je online, ověření vlastníci, panely s API, nástroje, aktuální ceny, načtené recenze, platformy s recenzemi.

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 a Claude Desktop

Settings → Connectors → Add custom connector → vložte https://smm.guide/mcp. Bez klíče server stále odpovídá, s limitem 30 volání za minutu na adresu.

Limity a podmínky

  • 60 požadavků za minutu, 5 000 za den na klíč. Hlavičky X-RateLimit-Limit a X-RateLimit-Remaining vám řeknou, jak na tom jste; odpověď 429 obsahuje Retry-After.
  • Jen pro čtení a se stejnými údaji jako stránky. V API není nic nezveřejněného a nic na stránkách není před API skryto. Obojí se obnovuje podle stejného rozvrhu – počítadla každou hodinu, ceníky po částech nepřetržitě.
  • Citujte s odkazem. Když údaj skončí ve vašem produktu, reportu nebo odpovědi, odkažte na stránku panelu na smm.guide, kde je u něj datum a zdroje.
  • Žádná zrcadla cenového indexu. Data používejte ve svém produktu; katalog ani ceníky nezveřejňujte jako dataset. Klíče jsou osobní a lze je zneplatnit.
  • Karta v katalogu není doporučení. Katalog měří, za nic neručí. Přečtěte si, jak se skóre počítá a odkud pochází každý údaj.

Stavíte na tom něco?

Napište nám, co stavíte. Chybějící pole nebo filtr je na naší straně malá změna.