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