tokdata

tokdata

tokdata 是一个小型本地桥接程序，用于连接托管的 HasData TikTok MCP 服务，该服务以 JSON 格式返回公开的 TikTok 数据。它可以根据用户名查询公开的个人资料，逐页遍历公开账号发布的视频，读取公开视频的评论（或某条评论的回复），还可以按关键词搜索 TikTok 视频或用户。

该桥接程序不保存任何 TikTok 数据。它会完全按照从实时端点捕获的内容，在本地响应工具列表，并将每次工具调用转发到上游，原样返回收到的内容。捕获到的接口包含 4 个只读的公开内容获取工具：所有工具都不会发布、发送或存储任何内容，也没有任何工具会提供个人的联系方式。

Tools

• hasdata_tiktok_profile_getTikTokProfile — 获取公开的个人资料。必填：handle（用户名，可带或不带 @）。返回昵称、简介、简介链接、头像 URL、已验证和私密标记、账号创建时间，以及粉丝数、关注数、获赞数、视频数和好友数。
• hasdata_tiktok_posts_getTikTokPosts — 获取账号的一页视频。必填：handle。可选：nextPageToken，用于继续向前遍历账号的历史视频。每个视频都会返回其描述、话题标签、提及、获赞数、评论数、分享数、播放数和收藏数、封面和可播放 URL、音乐、时长及时间戳。
• hasdata_tiktok_comments_getTikTokComments — 获取公开视频的评论。必填：videoId（视频 URL 中的数字 ID）。可选：commentId（改为返回该评论的回复，而非顶层评论）和用于分页的 nextPageToken。顶层评论的第一页还会附带视频本身的信息。
• hasdata_tiktok_search_getTikTokSearch — 按关键词搜索。必填：keyword。可选：type（video 或 user；默认为视频）和用于分页的 nextPageToken。视频结果包含常见计数、URL、音乐和作者；用户结果包含昵称、简介、头像、已验证标记和粉丝数。

Configuration

• HASDATA_TIKTOK_MCP_URL（可选）— 覆盖上游端点。默认值为 https://mcp.hasdata.com/api/mcp?apis=tiktok — 注意其中的 /api/ 段，它是固定 URL 的一部分。 （此覆盖钩子是本次重建中自行标注的重建内容。）
• HASDATA_API_KEY（可选）— 设置后，每个上游请求都会携带 x-api-key: <key> 标头，使用调用者自己的 HasData API 密钥。未设置时，不会发送密钥标头。（标头名称和环境变量名称由原始项目的注册记录固定；从此环境变量转发密钥是标注的重建内容 — 原始接口是在不带密钥的情况下捕获的。）

Forwarding mechanics

首次调用工具时，客户端会在上游打开一个可流式传输的 HTTP 会话：先发送 JSON-RPC initialize 请求（protocolVersion 2025-03-26，clientInfo 名称为 tokdata），然后发送 notifications/initialized 通知，接着发送携带调用者原样参数的 tools/call 请求。当上游响应 initialize 并带有 Mcp-Session-Id 标头时，该值会随该会话的后续每个请求一起发送；此会话会在进程运行期间重复使用。响应可能是普通 JSON，也可能是服务器发送的事件；两种格式都会读取。

上游成功结果会原样传递，包括上游设置的任何 isError 标记。 失败情况 — JSON-RPC 错误、非 2xx 状态、无法读取响应或无法完成的请求 — 会以 isError 结果返回，其文本以 tokdata error: 开头（此呈现方式是本次重建中自行标注的重建内容）。

CLI

每个工具也可作为子命令使用，并接受一个 JSON 参数字符串：

npx @reneturcios/tokdata hasdata_tiktok_profile_getTikTokProfile '{"handle":"tiktok"}'
npx @reneturcios/tokdata hasdata_tiktok_posts_getTikTokPosts '{"handle":"tiktok"}'
npx @reneturcios/tokdata hasdata_tiktok_comments_getTikTokComments '{"videoId":"0000000000000000000"}'
npx @reneturcios/tokdata hasdata_tiktok_search_getTikTokSearch '{"keyword":"dance","type":"video"}'
npx @reneturcios/tokdata --version

退出代码：成功时为 0，结果为 isError 时为 1，用法错误时为 2。

MCP server

npx -y @reneturcios/tokdata mcp

MCP 客户端配置：

{
  "mcpServers": {
    "tokdata": {
      "command": "npx",
      "args": ["-y", "@reneturcios/tokdata", "mcp"]
    }
  }
}

Docker

docker run -i ghcr.io/cloudcorprecords/tokdata
docker run --rm ghcr.io/cloudcorprecords/tokdata --version

容器的默认命令是 mcp，因此第一种形式是 stdio MCP 服务；其他参数则会正常传递给命令行工具。

开发

npm install
npm run build
npm test
npm run dev

测试套件完全通过模拟的 JSON-RPC 上游运行，不会发起实时网络调用。

许可证

MIT — 请参阅 LICENSE。