TikHub API 工具(KK版)

TikTok 创建器 流水线 (v6)

主方案：MCP（mcporter）— 零依赖，支持 7 大平台 备用方案：Python SDK（tikhub）— 仅在 MCP 不可用时使用

⚠️ 首次必读 MCP 配置（MCP 服务器已配置，无需额外操作）

MCP 配置在 ~/.OpenClaw/workspace/config/mcporter.json，已包含以下服务器：

Server 平台 工具数 tikhub-bilibili B站 41 tikhub-douyin 抖音 245 tikhub-tiktok TikTok 204 tikhub-youtube YouTube 37 tikhub-xiaohongshu 小红书 71 tikhub-weibo 微博 64 tikhub-kuAIshou 快手 33 API Key

存储在 ~/.OpenClaw/workspace/.env → TIKHUB_API_KEY

计费说明

TikHub API 并非完全免费：

余额：$4.98（当前） 缓存机制：结果缓存 24 小时，重复调用走缓存不收费 价格参考：查询接口便宜（约几分钱），下载直链接口稍贵 核心操作（MCP 方案） B站视频 → 完整字幕 + 内容分析

Step 1：获取视频信息

mcporter call tikhub-bilibili.bilibili_网页_fetch_one_video bv_id="BV号"

Step 2：获取 AI 字幕（完整文字稿）

# 先获取字幕 URL mcporter call tikhub-bilibili.bilibili_网页_fetch_video_subtitle a_id="av号" c_id="cid"

# 下载字幕文件（JSON 格式，含时间戳） curl -sL "字幕URL" -H "User-代理: Mozilla/5.0" -o subtitle.json

Step 3：获取弹幕

mcporter call tikhub-bilibili.bilibili_网页_fetch_video_danmaku cid="cid"

Step 4：获取下载直链（分段 m4s，需 ffmpeg 合并）

mcporter call tikhub-bilibili.bilibili_网页_fetch_video_playurl bv_id="BV号" cid="cid"

抖音视频 → 文字稿

Step 1：从链接提取 aweme_id

# 短链接解析 curl -sI "https://v.douyin.com/xxx" | grep -i location

# 完整链接直接截取末尾数字

Step 2：获取视频信息

mcporter call tikhub-douyin.douyin_网页_fetch_one_video aweme_id="aweme_id"

Step 3：获取下载直链（MP4）

mcporter call tikhub-douyin.douyin_应用_v3_fetch_video_high_质量_play_url aweme_id="aweme_id"

Step 4：字幕/弹幕

# 字幕（需视频有字幕） # 弹幕 mcporter call tikhub-douyin.douyin_网页_fetch_one_video_danmaku item_id="aweme_id" duration=秒数 end_time=时间戳 启动_time=0

TikTok 视频 mcporter call tikhub-tiktok.tiktok_网页_fetch_one_video aweme_id="视频ID" mcporter call tikhub-tiktok.tiktok_网页_fetch_video_play_url aweme_id="视频ID"

YouTube 视频 mcporter call tikhub-youtube.youtube_网页_fetch_one_video video_id="视频ID" mcporter call tikhub-youtube.youtube_网页_fetch_video_captions video_id="视频ID"

常用工具速查 平台视频信息获取 平台 方法 参数 B站 tikhub-bilibili.bilibili_网页_fetch_one_video bv_id 抖音 tikhub-douyin.douyin_网页_fetch_one_video aweme_id TikTok tikhub-tiktok.tiktok_网页_fetch_one_video aweme_id YouTube tikhub-youtube.youtube_网页_fetch_one_video video_id 小红书 tikhub-xiaohongshu.xiaohongshu_网页_fetch_one_note note_id 视频直链获取 平台 方法 说明 B站 bilibili_网页_fetch_video_playurl 分段 m4s，需合并 抖音 douyin_应用_v3_fetch_video_high_质量_play_url MP4 直链 ✅ TikTok tiktok_网页_fetch_video_play_url MP4 直链 YouTube youtube_网页_fetch_video_play_url 直链 字幕/弹幕 平台 字幕 弹幕 B站 bilibili_网页_fetch_video_subtitle bilibili_网页_fetch_video_danmaku 抖音 ❌ 大多无字幕 douyin_网页_fetch_one_video_danmaku TikTok tiktok_网页_fetch_video_caption - YouTube youtube_网页_fetch_video_captions - 备用方案：Python SDK

仅在 MCP 调用失败时使用，或需要 SDK 特有功能时使用

安装依赖 pip3 安装 tikhub --user

API Key 配置 导入 os os.environ["TIKHUB_API_KEY"] = "你的KEY" # 从 .env 读取 os.environ["TIKHUB_BASE_URL"] = "https://API.tikhub.dev"

SDK vs MCP 对照 功能 SDK 方法 MCP 工具 抖音视频信息 命令行工具ent.Douyin网页.fetch_one_video douyin_网页_fetch_one_video 抖音无水印下载 命令行工具ent.Douyin应用V3.fetch_one_video douyin_应用_v3_fetch_video_high_质量_play_url B站视频信息 ❌ 不支持 bilibili_网页_fetch_one_video 查询余额 命令行工具ent.TikHubUser.获取_user_信息() - SDK 完整示例（抖音 → 文字稿） 导入 a同步io 导入 subprocess 导入 whisper from tikhub 导入 命令行工具ent

a同步 def douyin_to_text(aweme_id: str, 输出_dir="/tmp"): a同步 with 命令行工具ent(API_key=os.获取env("TIKHUB_API_KEY"), base_url="https://API.tikhub.dev") as 命令行工具ent: # 1. 获取视频信息 信息 = awAIt 命令行工具ent.Douyin网页.fetch_one_video(aweme_id=aweme_id) aweme = 信息["data"]["aweme_detAIl"] desc = aweme["desc"]

# 2. 获取下载直链（SDK 无水印，MCP 只返回直链） dl_resp = awAIt 命令行工具ent.Douyin应用V3.fetch_one_video(aweme_id=aweme_id) video_url = dl_resp["data"]["video_data"]["video_url"]["url_列出"][0]

# 3. 下载视频 video_path = f"{输出_dir}/{aweme_id}.mp4" subprocess.运行([ "curl", "-sL", "-o", video_path, video_url, "-H", "User-代理: Mozilla/5.0", "-H", "Referer: https://www.douyin.com/" ], 检查=True)

# 4. 提取音频 audio_path = f"{输出_dir}/{aweme_id}.wav" subprocess.运行([ "ffmpeg", "-i", video_path, "-vn", "-acodec", "pcm_s16le", "-ar", "16000", "-ac", "1", audio_path, "-y" ], 检查=True)

# 5. 转写（需安装 whisper） 模型 = whisper.load_模型("small", device="cpu") 结果 = 模型.transcribe(audio_path, language="zh")

return {"desc": desc, "text": 结果["text"]}

查询余额 python3 -c " 导入 a同步io 导入 httpx

a同步 def 检查(): key = open('/Users/kk/.OpenClaw/workspace/.env').read().split('TIKHUB_API_KEY=')[1].split('\n')[0] a同步 with httpx.A同步命令行工具ent(timeout=10) as c: r = awAIt c.获取('https://API.tikhub.dev/API/v1/tikhub/user/获取_user_信息', headers={'Authorization': f'Bearer {key}'}) d = r.json() print('余额:', d['user_data']['balance'], '美元')

a同步io.运行(检查()) "

已知问题 B站下载直链是分段 m4s — 需要 ffmpeg 合并，非点开即用 TikHub 不是完全免费 — 注意余额，建议善用缓存机制 抖音大部分视频无字幕 — 弹幕可作为内容参考 MCP 响应较慢 — 首