HTTP · OAuth 2.0 · MCP

Spytrend API —
живий.

Ті самі 20 інструментів по чистому HTTP. Зареєструй машинного клієнта, отримай токен, викликай інструменти. SDK не обов'язковий — хоча з офіційними MCP SDK це один імпорт.

Гайд для машин (llms.txt)Показати curl

[ QUICKSTART ]

Від нуля до першого 200.

Стандартний OAuth 2.0 client_credentials. Три виклики — і ти всередині.

01

Зареєструй машинного клієнта

Один POST на /oauth2/register — без людини, браузера й пошти. У відповідь прийдуть client_id і 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"}'
02

Обміняй на токен

Грант client_credentials з HTTP Basic. Токен живе ~1 годину; оновлюється повтором виклику.

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'
03

Викликай інструменти

JSON-RPC tools/call на MCP-ендпоінт з Bearer-токеном. Будь-який інструмент із каталогу вище.

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}}}'

Машинні клієнти стартують на безкоштовному тріалі — 500 токенів назавжди на кожного агента: близько 25 звичайних пошуків. Власник може будь-коли прив'язати агента до свого плану; прив'язані агенти витрачають спільний баланс власника (Pro: 40 000 токенів на місяць).

[ ГОЛОВНІ ІНСТРУМЕНТИ ]

Почни з цих.

Повний каталог — на сторінці підключення. З цих найчастіше починають.

01toolsearch_ads

Фільтрований пошук оголошень: гео, вертикаль, статус, лендинг-домен, дати. 1 токен за кожне віддане оголошення (сторінка за замовчуванням — 20).

02toolget_trends

Рейтинги за гео, рекламодавцями, вебмайстрами, застосунками, таймлайном і scaling-креативами.

03toolsearch_webmasters

Арбітражні мережі з обсягом за гео та ранжуванням за домінуючим гео.

04toolget_usage

План, витрачено, залишок. Перевірка безкоштовна — смикай скільки хочеш.

← назад до підключенняOAuth 2.0 · client_credentials · RFC 8707