# TikTok Shop

MCP-сервер подключает Claude Code к TikTok Shop Partner API для чтения заказов, финансов, товаров и аналитики нескольких магазинов.

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

## Что делает

TikTok Shop даёт агенту доступ к данным магазинов через TikTok Shop Partner API. Сервер умеет получать заказы и возвраты, финансовые выписки, сведения о товарах, показатели магазина, видео, SKU и партнёрские продажи. Данные возвращаются в структурированном JSON.

Конфигурация хранится в `shops.json` за пределами проекта; путь можно задать через `TIKTOK_SHOP_CONFIG`. Для подключения нужны `app_key`, `app_secret`, токены, `shop_id` и `shop_cipher` из TikTok Shop Partner Center. Сервер доступен в режиме чтения: при обновлении токенов он записывает только собственный файл конфигурации. Для трёх инструментов с бестселлерами нужен scope Bestsellers, а магазин по умолчанию задаётся через `TIKTOK_SHOP_BESTSELLERS_SHOP`.

Сервер совместим с `mcp` 1.x и 2.x. В Claude Code его можно зарегистрировать командой через `uvx`, после чего агент сможет обращаться к данным выбранного магазина.

## Требования
- Нужно: Python и uv (команды через uvx)
- Переменные окружения: `TIKTOK_SHOP_CONFIG`, `TIKTOK_SHOP_BESTSELLERS_SHOP` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

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

**Командой платформы**
```bash
claude mcp add --env TIKTOK_SHOP_CONFIG=<TIKTOK_SHOP_CONFIG> --env TIKTOK_SHOP_BESTSELLERS_SHOP=<TIKTOK_SHOP_BESTSELLERS_SHOP> --transport stdio tiktok-shop -- uvx tiktok-shop-mcp
```
Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from tiktok-shop-mcp <команда>

### Codex

**Командой платформы**
```bash
codex mcp add tiktok-shop --env TIKTOK_SHOP_CONFIG=<TIKTOK_SHOP_CONFIG> --env TIKTOK_SHOP_BESTSELLERS_SHOP=<TIKTOK_SHOP_BESTSELLERS_SHOP> -- uvx tiktok-shop-mcp
```
Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from tiktok-shop-mcp <команда>

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "tiktok-shop": {
            "command": "uvx",
            "args": [
                "tiktok-shop-mcp"
            ],
            "env": {
                "TIKTOK_SHOP_CONFIG": "<TIKTOK_SHOP_CONFIG>",
                "TIKTOK_SHOP_BESTSELLERS_SHOP": "<TIKTOK_SHOP_BESTSELLERS_SHOP>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from tiktok-shop-mcp <команда>

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "tiktok-shop": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "tiktok-shop-mcp"
            ],
            "env": {
                "TIKTOK_SHOP_CONFIG": "<TIKTOK_SHOP_CONFIG>",
                "TIKTOK_SHOP_BESTSELLERS_SHOP": "<TIKTOK_SHOP_BESTSELLERS_SHOP>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from tiktok-shop-mcp <команда>

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add -e TIKTOK_SHOP_CONFIG=<TIKTOK_SHOP_CONFIG> -e TIKTOK_SHOP_BESTSELLERS_SHOP=<TIKTOK_SHOP_BESTSELLERS_SHOP> tiktok-shop uvx tiktok-shop-mcp
```
Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from tiktok-shop-mcp <команда>

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

## Примеры запросов агенту
- Покажи магазины и сроки действия их токенов.
- Найди заказы магазина `MY SHOP US` за `2026-07-18` в часовом поясе Eastern.
- Сравни почасовой GMV за вчера и предыдущий день.

## Похожие
- [MCP Toolbox for Databases](https://affpapa.org/nevibecode/mcp/googleapis-mcp-toolbox-for-databases.md) — MCP-сервер · ★ 16730
- [PostHog MCP Server](https://affpapa.org/nevibecode/mcp/posthog-mcp-server.md) — MCP-сервер · ★ 40459
- [OpenWork MCP Gateway](https://affpapa.org/nevibecode/mcp/openwork-mcp-gateway.md) — MCP-сервер · ★ 24271
- [Keploy](https://affpapa.org/nevibecode/mcp/keploy.md) — MCP-сервер · ★ 18779
- [Nhost](https://affpapa.org/nevibecode/mcp/nhost.md) — MCP-сервер · ★ 9369
- [basebalance.cloud — x402 RPC & MCP gateway](https://affpapa.org/nevibecode/mcp/basebalancecloud-x402-rpc-mcp-gateway.md) — MCP-сервер · ★ 7548

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