LamaTok

lamatok-mcp

Lamatok 的 MCP 服务——TikTok 数据 API。可在 npm 上获取：lamatok-mcp。

启动时根据 LamaTok OpenAPI 规范生成 MCP 工具。工具与 REST 端点一一对应（GET /v1/user/by/username → get_v1_user_by_username）。默认提供 约 23 个核心工具，每项任务对应一个工具，且每个工具都附有说明，告知助手何时使用；设置 LAMATOK_TOOLS=all 可启用所有未弃用的端点。

获取 100 次免费 API 请求

通过此链接注册，即可获得 100 次免费的 LamaTok 请求——无需信用卡。足以配置 MCP 服务、在 Claude/Cursor/Codex 中尝试几个提示词，并在决定使用前评估数据质量。

在此获取免费的 100 次请求

快速开始

1. 在 lamatok.com 获取 API 密钥。
2. 将服务添加到 AI 助手。
3. 向助手提出类似这样的请求：
   • “获取 @nasa 的 TikTok 个人资料。”
   • “列出用户 ID 6707206320333226502 发布的最近 10 个视频。”
   • “查找带有话题标签 photography 的近期 TikTok 视频。”

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 相同——将代码块放在应用 MCP 配置文件的 mcpServers 下。

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"

工具

工具在启动时根据实时的 LamaTok OpenAPI 规范生成。默认的核心工具集为每项任务保留一个端点，并去除重复版本：

分组	工具数	示例
个人资料和受众	12	get_v1_user_by_username, get_v2_user_medias_by_secUid, get_v1_user_followers_by_username
视频和评论	4	get_v1_media_by_url, get_v1_media_by_id, get_v1_media_comments_by_id
下载链接	4	get_v1_media_video_download_by_url, get_v1_media_music_download_by_id
话题标签和搜索	3	get_v1_hashtag_info, get_v1_hashtag_medias, get_v2_search

核心工具附带手写说明（介绍工具用途、何时优先使用同类工具、分页和计费信息），且所有工具都标注为只读。工具列表位于 src/curated.ts。

设置 LAMATOK_TOOLS=all 可改为启用所有未弃用的端点——工具名称与之前相同，因此现有提示词仍可正常使用。工具名称对应其端点（GET /v1/user/by/username → get_v1_user_by_username）；通过 MCP 调用 tools/list 可获取当前工具列表及其参数架构。两种模式均不包含 /sys、Legacy 和 System 标签组。

配置

变量	描述	必需
LAMATOK_KEY	LamaTok 访问密钥（作为 x-access-key 标头发送）	是
LAMATOK_URL	基础 URL。默认值：https://api.lamatok.com	否
LAMATOK_SPEC_URL	OpenAPI 规范 URL。默认值：${LAMATOK_URL}/openapi.json	否
LAMATOK_TOOLS	core（默认）：精选工具集，每项任务一个工具。all：所有未弃用的端点	否
LAMATOK_TAGS	白名单：仅包含带有这些标签的操作（以逗号分隔）	否
LAMATOK_EXCLUDE_TAGS	黑名单：要额外排除的标签（在 Legacy、System、/sys 之外）	否
LAMATOK_TIMEOUT_MS	API 调用的单次请求超时时间。默认值：30000	否
LAMATOK_SPEC_TIMEOUT_MS	启动时获取规范的超时时间。默认值：60000	否
LAMATOK_SPEC_RETRY_DELAY_MS	启动时获取规范的 3 次尝试之间的基础延迟。默认值：2000	否
LAMATOK_MAX_RESPONSE_BYTES	从每个 API 响应中读取的最大字节数。默认值：10485760（10 MB）	否
LAMATOK_MAX_SPEC_BYTES	从 OpenAPI 规范中读取的最大字节数。默认值：8388608（8 MB）	否

默认情况下会排除 Legacy、System 和 /sys 标签。弃用的操作也会跳过。

如果 LAMATOK_URL 指向的主机不是 api.lamatok.com，服务会在启动时发出警告——你的密钥将发送到该主机，因此只能将其用于可自托管或代理的 LamaTok。

请求会携带 User-Agent: lamatok-mcp/<version>。

工作原理

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

工具参数会映射到端点的 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

运行测试（单元测试 + 针对本地模拟服务的 stdio 冒烟测试，无需网络或 API 密钥）：

npm test

许可证

MIT