HTTP · OAuth 2.0 · MCP
Te same 20 narzędzi, przez czysty HTTP. Zarejestruj samodzielnie klienta maszynowego, zdobądź token, wywołuj narzędzia. SDK nie jest wymagane — chociaż z oficjalnymi SDK MCP to tylko jeden import.
[ SZYBKI START ]
Standardowy OAuth 2.0 client_credentials. Trzy wywołania i już działasz.
Jedno żądanie POST do /oauth2/register — bez człowieka, bez przeglądarki, bez e-maila. W odpowiedzi otrzymujesz client_id i client_secret.
curl -X POST https://mcp.spytrend.com/oauth2/register \
-H 'Content-Type: application/json' \
-d '{"client_name":"my-agent","grant_types":["client_credentials"],
"response_types":[],"token_endpoint_auth_method":"client_secret_basic",
"scope":"mcp:read"}'Przyznanie client_credentials z uwierzytelnianiem HTTP Basic. Tokeny są ważne ~1 godzinę; odśwież, powtarzając wywołanie.
curl -X POST https://mcp.spytrend.com/oauth2/token \ -u "$CLIENT_ID:$CLIENT_SECRET" \ -d 'grant_type=client_credentials&scope=mcp:read&audience=https://mcp.spytrend.com/mcp'
JSON-RPC tools/call względem endpointu MCP z twoim tokenem Bearer. Każde narzędzie z powyższego katalogu.
curl -X POST https://mcp.spytrend.com/mcp \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-H 'Content-Type: application/json' \
-H 'Accept: application/json, text/event-stream' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/call",
"params":{"name":"search_ads","arguments":{"country":"BR","limit":5}}}'Klienci maszynowi startują na darmowym trialu — 500 tokenów na zawsze, na agenta: około 25 domyślnych wyszukiwań. Właściciel może w każdej chwili przypisać agenta do swojego planu; przypisani agenci korzystają ze wspólnego salda właściciela (Pro: 40 000 tokenów miesięcznie).
[ NAJWAŻNIEJSZE NARZĘDZIA ]
Pełny katalog znajdziesz na stronie połączenia. Od tych zaczyna większość zespołów.
search_adsFiltrowane wyszukiwanie reklam: geo, branża, status, domena docelowa, daty. 1 token za każdą zwróconą reklamę (domyślna strona 20).
get_trendsRankingi według kraju, reklamodawców, webmasterów, aplikacji, osi czasu lub skalujących się kreacji.
search_webmastersSieci afiliacyjne z wolumenem w podziale na kraje i trafnością dla dominującego kraju.
get_usagePlan, wykorzystane, pozostałe. Sprawdzanie jest bezpłatne — odpytuj tak często, jak chcesz.