lamatok-mcp

MCP-сервер для LamaTok — API данных TikTok. Доступен в npm: lamatok-mcp.

Автоматически генерирует инструменты MCP из спецификации OpenAPI LamaTok при запуске, поэтому каждый не устаревший GET эндпоинт доступен без написания оберток вручную. Инструменты соответствуют REST-эндпоинтам 1:1 (GET /v1/user/by/username → get_v1_user_by_username).

Получите 100 бесплатных запросов к API

Зарегистрируйтесь по этой ссылке и получите 100 бесплатных запросов LamaTok — кредитная карта не требуется. Этого достаточно, чтобы подключить MCP-сервер, попробовать несколько промптов в Claude/Cursor/Codex и оценить качество данных перед покупкой.

Получите свои 100 бесплатных запросов здесь

Быстрый старт

1. Получите API-ключ на lamatok.com.

2. Добавьте сервер в своего ИИ-ассистента.

3. Спросите ассистента о чем-то вроде:

   • "Получи профиль TikTok для @nasa."

   • "Выведи последние 10 видео пользователя с user_id 6707206320333226502."

   • "Найди недавние видео в TikTok по хэштегу photography."

Claude Code

claude mcp add lamatok -e LAMATOK_KEY=your-api-key -- npx -y lamatok-mcp

Claude Desktop

Добавьте в claude_desktop_config.json:

{
  "mcpServers": {
    "lamatok": {
      "command": "npx",
      "args": ["-y", "lamatok-mcp"],
      "env": {
        "LAMATOK_KEY": "your-api-key"
      }
    }
  }
}

Cursor / Windsurf

Аналогично Claude Desktop — поместите блок в раздел mcpServers в файле конфигурации MCP приложения.

Zed

Добавьте в ~/.config/zed/settings.json:

{
  "context_servers": {
    "lamatok": {
      "command": "npx",
      "args": ["-y", "lamatok-mcp"],
      "env": {
        "LAMATOK_KEY": "your-api-key"
      }
    }
  }
}

OpenAI Codex

Добавьте в ~/.codex/config.toml:

[mcp_servers.lamatok]
command = "npx"
args = ["-y", "lamatok-mcp"]

[mcp_servers.lamatok.env]
LAMATOK_KEY = "your-api-key"

Инструменты

Инструменты генерируются при запуске из актуальной спецификации OpenAPI LamaTok, поэтому список всегда соответствует текущему API. Около 19 инструментов в следующих группах (количество на момент написания):

Каждое имя инструмента отражает его эндпоинт (GET /v1/user/by/username → get_v1_user_by_username). Ваш ассистент может вызвать tools/list через MCP, чтобы получить полный актуальный список со схемами параметров. Группы тегов /sys, Legacy и System исключены по умолчанию.

Конфигурация

Теги Legacy, System и /sys исключены по умолчанию. Устаревшие операции также пропускаются.

Если LAMATOK_URL указывает на хост, отличный от api.lamatok.com, сервер выведет предупреждение при запуске — ваш ключ будет отправлен туда, поэтому используйте это только для самохостинга или проксирования LamaTok.

Как это работает

AI Assistant ←stdio→ lamatok-mcp ──https──> api.lamatok.com
                          │
                          └─ fetches /openapi.json once on startup,
                             builds one MCP tool per GET endpoint

Аргументы инструментов соответствуют параметрам query и path эндпоинта. Тело ответа возвращается как есть (текст JSON). Ответы, отличные от 2xx, отображаются как ошибки инструмента с HTTP-статусом и телом ответа.

Разработка

git clone https://github.com/subzeroid/lamatok-mcp.git
cd lamatok-mcp
npm install
npm run build
LAMATOK_KEY=your-key node dist/index.js

Запуск в режиме отслеживания изменений:

LAMATOK_KEY=your-key npm run dev

Запуск тестов (модульные тесты + smoke-тесты stdio против локального mock-сервера, сеть/API-ключ не требуются):

npm test

Лицензия

MIT