TikTok Search

通过Gecho Bridge MCP搜索TikTok视频并获取内容、竞品与产品洞察。

已扫描

项目

内容

适合谁

电商从业者、内容创作者

不适合谁

无Chrome环境用户、无法配置MCP的初学者

国内可用性

需网络配置。可能需要网络配置或第三方服务可访问。

安装难度

中等（★★☆）。基于终端操作、依赖、API Key 和本地环境要求的初步判断。

安装与下载

复制命令安装

openclaw skills install @gecho-ai/tiktok-search

官方 ZIP下载官方 ZIP

Skill 说明

命令、参数、文件名以原文为准

Gecho TikTok 搜索与洞察

通过你的 AI 聊天直接搜索 TikTok，提取结构化视频数据，并运行更深入的洞察任务，用于产品调研、竞品分析和趋势发现。

为什么人们会安装这个技能

在几分钟内找到任意关键词下的热门 TikTok 视频。
通过获取标题、点赞数、作者和视频链接，研究竞争对手。
在创作内容或决定销售商品前，探索产品需求和趋势信号。
将大量原始结果保存到磁盘，而不是手动从浏览器复制数据。

最适合的使用场景

竞品调研：“给我看看关于便携式搅拌机的最高点赞视频。”
趋势探查：“对办公桌布置进行洞察分析，告诉我哪些风格表现良好。”
内容调研：“找出猫玩具视频中成功的开场句和标题。”

从这里开始

此技能仅提供指令层。要实际运行，你还需要：

gecho-bridge MCP 服务器
Gecho Chrome 浏览器扩展
在 Chrome 中已登录的 TikTok 账号

需要完整的分步设置指南？请阅读：

[README.md](https://github.com/gecho-ai/gecho-bridge/blob/main/README.md)

如果你是通过 ClawHub 安装此技能

仅安装技能页面是不够的。你仍需配置一次 MCP。

对于 OpenClaw：

openclaw mcp set gecho-bridge '{"command":"npx","args":["-y","@gecho-ai/gecho-bridge@latest"]}'
openclaw gateway restart

然后验证：

openclaw mcp list

OpenClaw 的可选替代方案（如果你更倾向于插件管理）：

openclaw plugins install clawhub:@gecho-ai/gecho-bridge-bundle
openclaw gateway restart

对于 Hermes Agent：

hermes mcp add gecho-bridge --command npx --args="-y" --args="@gecho-ai/gecho-bridge@latest"
hermes restart

使用插件/MCP 方式时，Gecho Bridge 可能会自动启动本地服务进程以与 Chrome 扩展通信。如果扩展重新打开或 Chrome 重启，请在重试前运行 openclaw gateway restart 或 hermes restart。

30 秒检查清单

安装 [Gecho 浏览器扩展](https://chromewebstore.google.com/detail/pjkaeenpekolahdbccjfenjcmanemlbj?utm_source=item-share-cb)。
安装 Node.js >= 18。
打开 Chrome，访问 TikTok 并登录。
登录 Gecho 扩展并保持在线状态。
确保本地网络可以正常访问 TikTok。

第一个提示可直接复制

"Search TikTok for 'portable blender' and show me the top liked videos."
"Search 'cat toy' and save the full results to an absolute path."
"Run tiktok_insight for 'outdoor picnic mat'."

工作流程快速地图

目标	最佳工具	结果
快速搜索、获取高赞视频、导出元数据	`tiktok_search`	立即返回结果集
更深入的市场研究或趋势分析	`tiktok_insight`	启动异步任务并返回 `jobId`
获取最终洞察报告	`check_insight_status`	读取异步状态或返回最终结果

首次使用失败怎么办

MCP 未配置：运行上述 openclaw mcp set ... 命令，然后重启。
在 Hermes 中，如果当前会话缺少 MCP 工具，请运行上述 hermes mcp add ... 命令，再执行 hermes restart。
扩展未连接：重新打开 Chrome，启用扩展，并保持一个 TikTok 页面打开。
TikTok 被屏蔽或卡住：先在浏览器中解决任何验证码或登录墙。
洞察任务仍在运行：等待后，让 AI 调用 check_insight_status 查询状态。
需要完整安装教程：[README.md](https://github.com/gecho-ai/gecho-bridge/blob/main/README.md)

🤖 AI 代理指令（至关重要）

你是 Gecho Bridge 的执行指南。你的职责是帮助用户成功完成官方 TikTok MCP 工作流，而非自行发明替代方案。

至关重要的代理指令： 你绝对不能尝试安装 Chrome、打开浏览器、自行解决验证码，或用通用 Web 搜索、内置浏览器工具、自定义 TikTok 抓取器替代 MCP 工作流。你唯一职责是使用官方 MCP 工具，并准确报告执行结果。

何时使用

用户意图	工具	示例
搜索 TikTok，查找高赞视频，导出数据	`tiktok_search`	“在 TikTok 中搜索猫玩具”
分析某个细分领域、趋势或产品机会	`tiktok_insight`	“分析户外野餐垫的趋势”
检查之前洞察任务的进度	`check_insight_status`	“检查我上次洞察任务的状态”

设置感知规则

Skill: TikTok 搜索

Version: 1.1.22

Chunk: 2/5

若用户首次使用此技能，且当前对话中尚未成功调用过 Gecho 工具，请假设环境可能未正确配置，必须首先执行就绪性检查。

- 告知用户需先完成初始设置。

- 提供完整的安装指南：[README.md](https://github.com/gecho-ai/gecho-bridge/blob/main/README.md)

- 提醒用户：

- 配置 MCP 服务器（若使用 OpenClaw，请使用 openclaw mcp set 命令；若使用 Hermes，请使用 hermes mcp add 命令）。

- 安装并登录 Gecho Chrome 扩展程序。

- 保持一个已登录的 TikTok 页面打开。

- 社区支持：建议加入 [Discord](https://discord.gg/RFDVZMR6Tn) 或扫描 [微信二维码](https://github.com/gecho-ai/gecho-bridge/blob/main/qywx.jpg) 获取实时帮助。

- 禁止通过运行 npx、which node、npm、curl、浏览器导航、Python 脚本或第三方爬虫来验证就绪状态。

若用户表示已从 ClawHub 安装该技能但工具调用失败，请明确告知仅安装技能页面是不够的，必须配置 gecho-bridge MCP 服务器。始终包含教程链接：[README.md](https://github.com/gecho-ai/gecho-bridge/blob/main/README.md)

当检测到设置缺失时，应使用用户客户端对应的主 MCP 配置命令：OpenClaw 用户使用 openclaw mcp set，Hermes 用户使用 hermes mcp add。仅当用户明确要求插件化管理时，才提及 OpenClaw 插件路径作为可选替代方案。

当设置过程令人困惑或用户请求完整安装步骤时，请发送官方指南：

[README.md](https://github.com/gecho-ai/gecho-bridge/blob/main/README.md)

反馈循环：始终鼓励用户在 [Discord](https://discord.gg/RFDVZMR6Tn) 或 [微信群](https://github.com/gecho-ai/gecho-bridge/blob/main/qywx.jpg) 中报告问题或分享反馈。

工具

`tiktok_search`

执行关键词搜索，自动滚动加载结果，并返回元数据。

参数：

query (string, 必填)：搜索关键词或短语（例如：“烹饪技巧”、“旅行vlog”）。
save_dir (string, 可选)：保存结果 JSON 的绝对路径。*最佳实践：始终主动在当前工作区生成一个安全的、带时间戳的绝对路径（如 /absolute/path/to/workspace/tiktok_travel_vlogs_1690000000.json），以防止用户丢失原始数据。*

返回：

一个包含视频 ID、标题、点赞数、播放链接和作者信息的 JSON 数组。

`tiktok_insight`

基于 TikTok 搜索结果启动异步商业洞察与趋势分析任务。

参数：

query (string, 必填)：搜索关键词或短语（例如：“户外野餐垫”）。
save_dir (string, 可选)：保存结果 JSON 的绝对路径。

返回：

一个用于长时间运行异步任务的 jobId。最终报告需后续通过 check_insight_status 获取。

`check_insight_status`

检查之前启动的异步洞察任务的状态。

参数：

jobId (string, 必填)：由 tiktok_insight 返回的 jobId。

返回：

任务的运行状态或最终的洞察结果数据包。

执行规则与约束（关键）

name: TikTok Search

version: 1.1.22

description: 通过官方 Gecho 工具执行 TikTok 搜索与洞察分析，确保操作安全、准确且符合规范。

summary: 使用官方工具进行 TikTok 内容搜索与数据洞察，严格遵守调用规则与错误处理流程。

使用规范

每轮仅允许一次工具调用：在单次对话中，您必须确保只执行 tiktok_search、tiktok_insight 和 check_insight_status 中的一项工具调用。
严格绑定官方工具：仅使用本文件列出的官方 Gecho 工具进行 TikTok 相关操作。禁止使用 WebSearch、浏览器自动化或自定义爬虫作为替代。
禁止自动切换搜索与洞察：若 tiktok_insight 调用失败，不得自动转为 tiktok_search；若 tiktok_search 失败，也不得自动切换至 tiktok_insight。
快速失败机制：一旦任一工具调用失败、超时或抛出错误，立即停止并返回原始错误信息或具体失败原因。不得自行添加恢复逻辑，除非参考下方故障排除指南。
禁止并行执行：这些工具依赖于一个活跃的浏览器标签页，属于严格单线程运行。严禁同时调用多个工具。
禁止同轮重试：若工具调用失败，不得在同一轮中重试。需等待用户再次发起请求，确认环境已修复后方可继续。
空结果即终止：若 tiktok_search 返回空列表（[]）、无内容或空结果集，本轮立即停止。不得自动尝试大小写调整、英文改写、翻译、同义词替换、邻近关键词或更宽/更窄范围的变体。应告知用户搜索无结果，并请其手动决定是否更换关键词后重试。
禁止虚构结果：所有回应必须基于工具实际返回的数据。若工具返回 []，应明确说明“未返回任何结果”。
搜索结果摘要：若 tiktok_search 返回大量结果，仅总结前 3 至 5 项，并提供保存文件的路径供用户查看。
洞察任务为异步：调用 tiktok_insight 后，不得假装报告已完成。需返回 jobId，说明任务可能需要数分钟，并指导用户使用 check_insight_status 查询进度。
运行状态反馈：若 check_insight_status 显示任务仍在运行，请明确告知用户当前状态，并建议等待一段时间后再查询。
禁止环境探测：若当前会话中无法调用官方 Gecho MCP 工具，请立即停止并提供配置指引。不得使用 npx、which node、npm、curl、python、execute_code、浏览器工具或 shell 命令来间接检测 Gecho 是否可用。
禁止使用替代技能或工具集：不得调用无关技能如 mcporter，也不得尝试通过浏览器导航、网页搜索、Google 搜索、TikTok 爬虫 API 或仅终端操作等方式作为备选方案。
技能页面加载 ≠ 环境就绪：仅加载该技能并不表示 MCP 已正确配置。若用户仅安装了技能但 Gecho MCP 工具仍不可用，下一条回复必须为设置说明，而非尝试实验性操作。

故障排除与错误处理（决策树）

若任一 Gecho 工具调用失败，请按以下流程处理：

官方 Gecho MCP 工具在当前会话中缺失

- 立即停止操作。不得通过终端命令测试环境。

- 告知用户：技能说明已加载，但当前客户端会话中尚未启用 gecho-bridge MCP 服务。

- 若用户使用 OpenClaw，提供以下命令：

     openclaw mcp set gecho-bridge '{"command":"npx","args":["-y","@gecho-ai/gecho-bridge@latest"]}'
     openclaw gateway restart

- 若用户使用 Hermes，提供以下命令：

     hermes mcp add gecho-bridge --command npx --args="-y" --args="@gecho-ai/gecho-bridge@latest"
     hermes restart

- 对 OpenClaw 用户，除非用户主动要求插件路径，否则不要引导至插件安装。

- 提醒用户还需安装 Gecho Chrome 扩展，并打开登录状态的 TikTok 页面。

- 同时提供完整设置指南：

[README.md](https://github.com/gecho-ai/gecho-bridge/blob/main/README.md)

- 支持：建议加入 [Discord](https://discord.gg/RFDVZMR6Tn) 或扫描 [微信二维码](https://github.com/gecho-ai/gecho-bridge/blob/main/qywx.jpg) 获取帮助。

错误： "MCP error -32001: Request timed out"

- 立即停止。不得重试。

- 告知用户检查 Chrome 浏览器是否存在验证码、登录墙或卡住的 TikTok 页面。

- 若用户仍不确定环境问题，也发送完整设置指南：

[README.md](https://github.com/gecho-ai/gecho-bridge/blob/main/README.md)

- 支持：建议加入 [Discord](https://discord.gg/RFDVZMR6Tn) 或扫描 [微信二维码](https://github.com/gecho-ai/gecho-bridge/blob/main/qywx.jpg) 寻求协助。

错误： "Chrome extension not found/connected"

- 告知用户需安装或启用 Gecho 扩展，打开 TikTok 页面并完成登录。

- 提供扩展链接：[Gecho Extension](https://chromewebstore.google.com/detail/pjkaeenpekolahdbccjfenjcmanemlbj?utm_source=item-share-cb)

- 同时提供完整设置指南：

[README.md](https://github.com/gecho-ai/gecho-bridge/blob/main/README.md)

- 支持：建议加入 [Discord](https://discord.gg/RFDVZMR6Tn) 或加入 [微信社群](https://github.com/gecho-ai/gecho-bridge/blob/main/qywx.jpg)。

错误： tool not found / MCP server missing

- 告知用户 gecho-bridge MCP 服务器未正确配置。

- 对 OpenClaw 用户，提供以下命令：

     openclaw mcp set gecho-bridge '{"command":"npx","args":["-y","@gecho-ai/gecho-bridge@latest"]}'
     openclaw gateway restart

- 对 Hermes 用户，提供以下命令：

     hermes mcp add gecho-bridge --command npx --args="-y" --args="@gecho-ai/gecho-bridge@latest"
     hermes restart

也请包含完整的设置指南：

[README.md](https://github.com/gecho-ai/gecho-bridge/blob/main/README.md)

- 支持：建议加入 [Discord](https://discord.gg/RFDVZMR6Tn) 或 [微信群组](https://github.com/gecho-ai/gecho-bridge/blob/main/qywx.jpg) 获取配置帮助。

错误：服务超时

- 告知用户，请求可能因页面卡死、网络问题或查询范围过广而停滞。

- 建议在浏览器端问题解决后，使用更具体的关键词重新尝试。

- 支持：若问题持续存在，请在 [Discord](https://discord.gg/RFDVZMR6Tn) 或 [微信群组](https://github.com/gecho-ai/gecho-bridge/blob/main/qywx.jpg) 中报告。

**check_insight_status 返回 running**

- 告知用户洞察任务仍在处理中。

- 建议等待约 60 秒后再检查一次。

**tiktok_search 返回 [] 或无结果**

- 立即停止，不在同一轮中重试。

- 告知用户，针对其输入的精确关键词，搜索未返回任何结果。

- 不得自动更改大小写、语言、拼写或关键词范围。

- 询问用户是否希望手动尝试其他关键词。

标准操作流程

SOP: `tiktok_search`

若用户未提供 save_dir，则生成一个有效的绝对路径。
调用 tiktok_search。
若结果为空，立即停止，并告知用户该关键词未返回任何结果。如需重试，请用户手动选择下一个关键词。
若结果非空，仅总结前几条热门结果。
告知用户完整数据已保存的位置。

SOP: `tiktok_insight`

若用户未提供 save_dir，则生成一个有效的绝对路径。
调用 tiktok_insight。
报告返回的 jobId。
告知用户，洞察任务为异步执行，通常需要几分钟时间。
告知用户稍后使用 check_insight_status 并传入该 jobId 进行查询。

SOP: `check_insight_status`

使用提供的 jobId 调用 check_insight_status。
若状态为 running，报告任务仍在处理中。
若状态为 completed，总结关键发现及数据保存路径。

标准输出格式

当设置缺失或工具调用成功时，使用以下任一格式。

需要设置

⚠️ Gecho Bridge 尚未就绪

我已加载 `tiktok-search` 技能，但官方的 `gecho-bridge` MCP 工具在此会话中尚未可用。

若您仅安装了技能，这是正常现象。请先配置 MCP：

如果您使用 OpenClaw：

openclaw mcp set gecho-bridge '{"command":"npx","args":["-y","@gecho-ai/gecho-bridge@latest"]}'

openclaw gateway restart

如果您使用 Hermes：

hermes mcp add gecho-bridge --command npx --args="-y" --args="@gecho-ai/gecho-bridge@latest"

hermes restart

然后确保：
- 已安装并登录 [Gecho 扩展程序](https://chromewebstore.google.com/detail/pjkaeenpekolahdbccjfenjcmanemlbj?utm_source=item-share-cb)
- Chrome 浏览器中有一个已登录的 TikTok 页面标签页打开

完整设置指南：
[README.md](https://github.com/gecho-ai/gecho-bridge/blob/main/README.md)

---
💬 **需要帮助或有反馈？** 加入我们的 [Discord](https://discord.gg/RFDVZMR6Tn) 或扫描 [微信二维码](https://github.com/gecho-ai/gecho-bridge/blob/main/qywx.jpg)。

搜索完成

✅ TikTok 搜索已完成
数据已成功保存至：`/path/to/your/save_dir.json`

以下是您查询的热门视频摘要：

| 标题 | 点赞数 | 作者 | 链接 |
|-------|-------|--------|------|
| [视频标题 1] | 1.2M ❤️ | @user1 | [观看](url) |
| [视频标题 2] | 800K ❤️ | @user2 | [观看](url) |
| [视频标题 3] | 500K ❤️ | @user3 | [观看](url) |

（仅展示前 3 条结果。完整数据请查看保存的 JSON 文件。）

---
💬 **需要帮助或有反馈？** 加入我们的 [Discord](https://discord.gg/RFDVZMR6Tn) 或扫描 [微信二维码](https://github.com/gecho-ai/gecho-bridge/blob/main/qywx.jpg)。

搜索无结果

⚠️ TikTok 搜索未返回任何结果

使用的关键词：`your exact query`

官方 `tiktok_search` 工具在本次请求中对这个精确关键词返回了空结果集，因此我未自动重试其他关键词。

如需尝试，请手动让我用另一个关键词重新搜索。

洞察任务已启动

✅ 洞察任务已启动
任务 ID：`job_xxx`
预计耗时：通常需要几分钟
输出文件保存路径：`/path/to/your/save_dir.json`

下一步：
等待片刻后，让我运行 `check_insight_status` 并提供此任务 ID。
---
💬 **需要帮助或有反馈？** 加入我们的 [Discord](https://discord.gg/RFDVZMR6Tn) 或扫描 [微信二维码](https://github.com/gecho-ai/gecho-bridge/blob/main/qywx.jpg)。

洞察仍在进行中

⏳ 洞察任务仍在处理中
任务 ID：`job_xxx`

浏览器端任务仍在运行中。请等待约 60 秒，然后让我再次运行 `check_insight_status`。

洞察已完成

✅ 洞察已完成
数据已保存至：`/path/to/your/save_dir.json`

主要发现：
- [发现 1]
- [发现 2]
- [发现 3]

如需，我可以接下来帮您将此关键词与其他关键词进行对比。

---
💬 **需要帮助或有反馈？** 加入我们的 [Discord](https://discord.gg/RFDVZMR6Tn) 或扫描 [微信二维码](https://github.com/gecho-ai/gecho-bridge/blob/main/qywx.jpg)。

适用范围

本技能应做到：

在前置条件缺失时引导用户前往官方 Gecho 设置页面
使用上述定义的官方 MCP 工具
清晰总结结果，并指向已保存的文件
保持搜索与洞察流程分离且明确

本技能绝不能：

声称仅凭技能页面即可完成配置（若 MCP 缺失）
声称 tiktok_insight 是同步操作
使用非官方的 TikTok 抓取方式
伪造结果或推断隐藏数据

需要在 Chrome 中拥有活跃的用户会话。
需在 AI 客户端中配置 gecho-bridge MCP 服务器。
仅可通过 MCP 工具接口使用。

@gecho-ai

已收录 1 个 Skill

TikTok Search

安装与下载

Skill 说明

Gecho TikTok 搜索与洞察

为什么人们会安装这个技能

最适合的使用场景

从这里开始

如果你是通过 ClawHub 安装此技能

30 秒检查清单

第一个提示可直接复制

工作流程快速地图

首次使用失败怎么办

🤖 AI 代理指令（至关重要）

何时使用

设置感知规则

工具

`tiktok_search`

`tiktok_insight`

`check_insight_status`

执行规则与约束（关键）

使用规范

故障排除与错误处理（决策树）

标准操作流程

SOP: `tiktok_search`

SOP: `tiktok_insight`

SOP: `check_insight_status`

标准输出格式

需要设置

搜索完成

搜索无结果

洞察任务已启动

洞察仍在进行中

洞察已完成

适用范围

相关推荐

OpenViking

知乎抓取.SKILL

awesome-design-skill

TikTok Search

安装与下载

Skill 说明

Gecho TikTok 搜索与洞察

为什么人们会安装这个技能

最适合的使用场景

从这里开始

如果你是通过 ClawHub 安装此技能

30 秒检查清单

第一个提示可直接复制

工作流程快速地图

首次使用失败怎么办

🤖 AI 代理指令（至关重要）

何时使用

设置感知规则

工具

tiktok_search

tiktok_insight

check_insight_status

执行规则与约束（关键）

使用规范

故障排除与错误处理（决策树）

标准操作流程

SOP: tiktok_search

SOP: tiktok_insight

SOP: check_insight_status

标准输出格式

需要设置

搜索完成

搜索无结果

洞察任务已启动

洞察仍在进行中

洞察已完成

适用范围

相关推荐

OpenViking

知乎抓取.SKILL

awesome-design-skill

`tiktok_search`

`tiktok_insight`

`check_insight_status`

SOP: `tiktok_search`

SOP: `tiktok_insight`

SOP: `check_insight_status`