HTTP · OAuth 2.0 · MCP

Spytrend API —
живой.

Тот же каталог на 22 инструмента — по чистому HTTP. Зарегистрируй машинного клиента, получи токен, вызывай инструменты. SDK не обязателен — хотя с официальными MCP SDK это один импорт.

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

[ БЫСТРЫЙ СТАРТ ]

От нуля до первого 200.

Стандартный OAuth 2.0 client_credentials. Три вызова — и ты внутри.

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

Один 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"}'

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

Грант 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'

Вызывай инструменты

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 токенов на исходную сеть (/24): 1 токен за выданную строку; медиа объявления — 1, медиа креатива — 10, мультиязычное объявление — 50, строка TikTok — 10. Цена умножается на число фильтров в запросе (минимум 1). Перед платным вызовом бесплатный инструмент estimate_cost сообщает агенту, сколько токенов он спишет.

[ ГЛАВНЫЕ ИНСТРУМЕНТЫ ]

Начни с этих.

Полный каталог — на странице подключения. С этих чаще всего начинают.

01toolsearch_ads

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

02toolget_trends

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

03toolsearch_webmasters

Арбитражные сети с объёмом по гео и ранжированием по доминирующему гео.

04toolget_usage

План, потрачено, остаток. Проверка бесплатна — дёргай сколько хочешь.

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