# TikTok Trends API

Даёт агенту доступ к истории и росту хэштегов TikTok, а также к живому списку трендов. Пригодится, когда нужно проверить спрос по теме до запуска контента.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 2
- Автор: trendsapi-ai
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/trendsapi-ai/tiktok-trends-api
- Обновлён: 2026-10-16
- HTML: https://affpapa.org/nevibecode/mcp/tiktok-trends-api

## Что делает

Сервер подключается к API trendsapi.ai и отдаёт три вещи: временной ряд по ключевому слову, процент роста за выбранные окна и текущий список популярных хэштегов. Ряд приходит как индекс от 0 до 100 по конкретному хэштегу, а не как число просмотров. Рост считается по пресетам вроде `3M`, `12M`, `YTD` или по своим датам. Несколько окон в одном запросе — это одна billed-операция.

Клиенты есть для Python и JavaScript. В Python это `pip install trendsapi-tiktok`, нужен Python 3.9+, ключ кладётся в переменную `TRENDSAPI_KEY`. Есть синхронный и асинхронный клиенты, данные раскладываются в pandas через `asdict`. В JS — `npm install trendsapi-tiktok`, работает на Node 18+, Deno, Bun и Workers. Ключ один и тот же для HTTP и SDK.

Регистр здесь важен: `source` пишется строчными (`tiktok`), а `type` — точно как в списке (`TikTok Trending Hashtags`). Перепутаете — получите 400. Без ключа `TRENDSAPI_KEY` запросы падают с 401, а на 404 по несуществующему ключевому слову клиент не делает повторов. Публикация видео сюда не входит, это только спрос.

## Требования
- Нужно: Python и uv (команды через uvx)
- Удалённый сервер: `https://tiktok.api.trendsapi.ai/mcp`

## Установка

### Claude Code (родная платформа)

**Командой платформы: удалённый сервер**
```bash
claude mcp add --transport http tiktok-trends-api https://tiktok.api.trendsapi.ai/mcp
```

### Codex

**Командой платформы: удалённый сервер**
```bash
codex mcp add tiktok-trends-api --url https://tiktok.api.trendsapi.ai/mcp
```

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "tiktok-trends-api": {
            "url": "https://tiktok.api.trendsapi.ai/mcp"
        }
    }
}
```

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "tiktok-trends-api": {
            "type": "http",
            "url": "https://tiktok.api.trendsapi.ai/mcp"
        }
    }
}
```

### Gemini CLI

**Командой платформы: удалённый сервер**
```bash
gemini mcp add -t http tiktok-trends-api https://tiktok.api.trendsapi.ai/mcp
```

## Когда брать
- посмотреть, как менялся интерес к хэштегу за год
- сравнить рост двух тем за разные окна
- выгрузить ряд в pandas и усреднить по месяцам
- получить список горячих хэштегов на сегодня
- проверить спрос по нише перед съёмкой

## Примеры запросов агенту
- Покажи динамику хэштега matcha за последние 12 месяцев
- Сравни рост matcha за 3M и 12M и скажи, куда идёт тренд
- Выведи топ-10 трендовых хэштегов TikTok

## Похожие
- [TikTok Trends MCP](https://affpapa.org/nevibecode/mcp/tiktok-trends-mcp.md) — MCP-сервер · ★ 1
- [Reddit Trends API](https://affpapa.org/nevibecode/mcp/reddit-trends-api.md) — MCP-сервер
- [App Store Trends API](https://affpapa.org/nevibecode/mcp/app-store-trends-api.md) — MCP-сервер
- [News Sentiment Trends MCP](https://affpapa.org/nevibecode/mcp/news-sentiment-trends-mcp.md) — MCP-сервер · ★ 1
- [discovering-viral-tiktok-content-trends](https://affpapa.org/nevibecode/skills/discovering-viral-tiktok-content-trends.md) — скилл · 777 установок
- [finding-tiktok-creators-using-trending-sounds](https://affpapa.org/nevibecode/skills/finding-tiktok-creators-using-trending-sounds.md) — скилл · 813 установок

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md