TikTok 搜索与洞察（由 Gecho 提供）

通过 AI 对话搜索 TikTok 内容，提取结构化视频元数据，并通过官方 Gecho Bridge MCP 流程启动异步的产品或趋势洞察任务。

这是 Gecho 的默认 TikTok 综合技能。涵盖 TikTok 视频搜索、创作者内容收集和 TikTok 洞察分析。虽然可能存在仅用于分发或搜索流量的单工具 TikTok 技能，但对于希望获得完整 TikTok 研究流程的用户，本技能是推荐首选。

关键前提：使用前请务必阅读

Gecho 技能必须配合 Gecho Chrome 扩展使用。您需在扩展中登录 Gecho 账号，并在 Chrome 浏览器中登录 TikTok 网页应用。若任一登录状态缺失，即使技能已安装，所有 TikTok 搜索与洞察功能也可能无法正常工作。

三步快速上手

步骤 1：安装 Gecho Chrome 扩展

1. 打开 [Gecho Chrome 扩展下载页面](https://chromewebstore.google.com/detail/pjkaeenpekolahdbccjfenjcmanemlbj?utm_source=item-share-cb)。
2. 点击 添加至 Chrome，然后确认 添加扩展程序。

步骤 2：登录 Gecho 扩展

在 Chrome 中打开 Gecho 扩展并登录您的 Gecho 账号。请保持扩展在线。

步骤 3：登录 TikTok 网页版

在 Chrome 中打开 TikTok 并登录网页应用。请保持已登录的 TikTok 标签页开启。

设置完成后，返回 OpenClaw 仪表板或 Hermes，输入：“在 TikTok 上搜索 xxx”。例如：“在 TikTok 上搜索汉堡”。

官方链接与设置帮助

• 官网：[gecho.ai](https://gecho.ai/)
• GitHub：[gecho-ai/gecho-bridge](https://github.com/gecho-ai/gecho-bridge)
• YouTube 频道：[@Gecho-AI](https://www.youtube.com/@Gecho-AI)
• Chrome 扩展：[Gecho Extension](https://chromewebstore.google.com/detail/pjkaeenpekolahdbccjfenjcmanemlbj?utm_source=item-share-cb)
• OpenClaw 设置视频：[OpenClaw + TikTok：通过 Gecho Bridge 实现 AI 直接浏览器控制](https://www.youtube.com/watch?v=ggwY9hISHcQ)
• Hermes 设置视频：[Hermes + TikTok：通过 Gecho Bridge 实现 AI 直接浏览器控制](https://www.youtube.com/watch?v=zHKnuWnxt_c)
• Discord 社区：[https://discord.gg/RFDVZMR6Tn](https://discord.gg/RFDVZMR6Tn)
• 企业微信群二维码：[qywx.jpg](https://github.com/gecho-ai/gecho-bridge/blob/main/qywx.jpg)
• 一对一支持二维码：[wx.jpg](https://github.com/gecho-ai/gecho-bridge/blob/main/wx.jpg)

本技能的功能

• 为关键词查找高表现力的 TikTok 视频。
• 收集标题、作者、互动数据和视频链接。
• 将完整的原始结果保存到本地 JSON 文件。
• 启动异步洞察任务，用于产品研究、竞品分析和趋势发现。

适合的提示语示例：

• “在 TikTok 上搜索便携式搅拌机，展示点赞最高的视频。”
• “找出猫咪玩具视频中的爆款开头。”
• “为户外野餐垫进行产品机会洞察。”
• “检查我之前的 TikTok 洞察任务状态。”

重要提醒：仅安装技能不足以运行

本技能仅作为指令层，告诉 AI 在何时以及如何使用 Gecho。

要真正执行 TikTok 搜索，还需满足以下条件：

• Gecho Bridge MCP 服务器
• Gecho Chrome 扩展
• Chrome 浏览器中已登录 TikTok
• Gecho 扩展已登录 Gecho 账号且处于在线状态

如果用户仅从 ClawHub 安装了此技能，而未配置 Gecho Bridge MCP 服务器，则搜索将无法运行。此时请使用下方的 MCP 设置路径。

若您已安装 Gecho Bridge？若 @gecho-ai/gecho-bridge-bundle 已安装且 Gecho MCP 工具可见，则无需额外配置即可使用本技能。

快速开始

OpenClaw 技能安装：配置 MCP

若本技能已在 OpenClaw 中安装，请一次性配置 Gecho Bridge MCP 服务器：

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

随后验证：

openclaw mcp list

可选：OpenClaw Bundle 插件

若尚未安装本技能且偏好插件管理，可通过 bundle 插件一键安装并配置 MCP 入口：

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

后续升级：

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

Hermes 设置

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

若 Hermes 无法找到 npx（尽管已安装 Node.js），请使用绝对路径。在多数 macOS Homebrew 安装中，路径为：

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

首次运行检查清单

首次搜索前，请确保：

• Node.js 版本 >= 18 可用。
• 已安装 [Gecho Chrome 扩展](https://chromewebstore.google.com/detail/pjkaeenpekolahdbccjfenjcmanemlbj?utm_source=item-share-cb)。
• Chrome 已打开，且 TikTok 已登录。
• Gecho 扩展已登录 Gecho 账号并保持在线。
• TikTok 标签页未被验证码、登录墙或卡死页面阻塞。

完整设置指南：

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

视频教程与支持链接请参见上方官方链接部分。

工具选择建议

对于广泛的 TikTok 研究请求，建议使用本综合技能。若用户明确要求仅使用某一特定工具（如“运行 tiktok_search”），当可用时可调用对应的单工具分发技能。

官方 MCP 工具说明

tiktok_search

通过 Gecho 浏览器扩展滚动页面，搜索指定关键词，返回结构化视频元数据，并保存完整结果集。

参数：

• query string，必填：搜索关键词或短语。
• targetCount number，可选：期望获取的结果数量；默认值为 100。
• save_dir string，可选：用于保存结果的绝对目录路径。不要包含 .json 文件名。若无法确定可靠路径，可省略该参数，让 Gecho 使用默认数据目录。

预期返回：

• 包含视频元数据的 JSON 数组，以及成功写入后保存的本地文件路径。

tiktok_influencer

收集指定 TikTok 创作者发布的视频内容。

参数：

• uniqueId string，必填：创作者的 TikTok uniqueId（例如 zachking）。
• targetCount number，可选：期望获取的视频数量；默认值为 100。建议请求量不超过 500。

tiktok_insight

启动一个异步的 TikTok 洞察任务，用于产品、趋势或竞品研究。

参数：

• query string，必填：搜索关键词或产品/品类名称。
• save_dir string，可选：用于保存结果的绝对目录路径。不要包含 .json 文件名。若无法确定可靠路径，可省略该参数，让 Gecho 使用默认数据目录。

预期返回：

• 一个 jobId。最终结果需通过 check_insight_status 后续查询。

check_insight_status

检查已有洞察任务的状态或最终结果。

参数：

• jobId string，必填：由 tiktok_insight 返回的任务 ID。

预期返回：

• running（运行中）、error（错误）或已完成的洞察数据。

代理执行规则

当用户提出搜索 TikTok、查找热门视频、分析竞品、收集 TikTok 元数据、发现爆款产品或研究关键词趋势等请求时，应优先使用本技能调用任何 Gecho TikTok MCP 工具。

核心规则：

• 仅使用官方 Gecho MCP 工具：tiktok_search、tiktok_influencer、tiktok_insight 和 check_insight_status。
• 不得用 WebSearch、浏览器自动化、终端爬虫、mcporter、非官方 API 或手动编写 TikTok 抓取脚本替代 Gecho。
• 同一对话回合内不得启动多个 Gecho 抓取或洞察任务。
• 不得并行运行 Gecho 抓取任务，因流程依赖单一浏览器标签页和扩展会话。
• 若工具失败、超时或返回错误，应立即停止并报告具体失败原因。
• 若 tiktok_search 返回空结果，不得自动重写、翻译、扩展或重试关键词。
• 若 tiktok_insight 成功启动，应报告 jobId，并说明用户需稍后通过 check_insight_status 查询状态。
• 若 check_insight_status 显示任务仍在运行，应告知用户等待约 60 秒后再检查。
• 若当前会话中官方 Gecho MCP 工具不可用，应提供设置指引而非探测环境。
• 首次运行设置引导、MCP 工具缺失、扩展/会话问题、超时、保存失败或其他工具错误时，应在回答末尾包含下方的设置与支持链接块。
• 除非用户主动要求，否则正常成功的搜索或洞察响应中不应包含设置与支持链接块。
• 不得擅自配置、编辑、修复或重写 OpenClaw/Hermes/MCP 设置。应提供设置命令，并请用户在工具流程外自行执行或确认。
• 本技能不得用于 TikTok Shop、X/Twitter、Amazon 等其他平台流程；这些应有各自的 Gecho 综合技能。

允许的状态行为：

• 用户可明确要求检查某个已有 jobId；此时调用一次 check_insight_status 即可。
• 在检查状态后，除非用户在后续对话中再次提出，否则不应在同一回合内启动新的 tiktok_search 或 tiktok_insight 任务。

标准工作流

搜索工作流

1. 使用用户提供的精确关键词。
2. 若用户未提供 save_dir，在当前工作区选择一个安全的绝对路径。若无法确定可靠路径，可省略 save_dir，让 Gecho 使用默认数据目录。
3. 调用 tiktok_search。
4. 若结果为空，说明该关键词无匹配内容，直接停止。
5. 若有结果，仅总结前 3 至 5 条，并提供保存的文件路径。

洞察工作流

1. 使用用户请求的确切产品、领域或关键词。
2. 若用户未提供 save_dir，在当前工作区选择一个安全的绝对路径。若无法确定可靠路径，可省略 save_dir，让 Gecho 使用默认数据目录。
3. 调用 tiktok_insight。
4. 报告返回的 jobId。
5. 告知用户任务可能需要数分钟，需稍后通过 check_insight_status 查询。

状态检查工作流

1. 使用提供的 jobId 调用 check_insight_status。
2. 若仍在运行，报告当前状态并建议等待约 60 秒。
3. 若已完成，总结关键发现并提供保存文件路径。
4. 若失败，报告具体错误并停止。

设置与支持链接块

在首次运行引导及所有设置或失败响应中使用此紧凑块。请将其置于回答末尾，紧随具体解决方案之后。

有用 Gecho 链接：

- 官网：https://gecho.ai/
- YouTube 频道：https://www.youtube.com/@Gecho-AI
- OpenClaw 设置视频：https://www.youtube.com/watch?v=ggwY9hISHcQ
- Hermes 设置视频：https://www.youtube.com/watch?v=zHKnuWnxt_c
- GitHub 和 README：https://github.com/gecho-ai/gecho-bridge
- 支持：Discord https://discord.gg/RFDVZMR6Tn，企业微信群二维码 https://github.com/gecho-ai/gecho-bridge/blob/main/qywx.jpg，一对一支持二维码 https://github.com/gecho-ai/gecho-bridge/blob/main/wx.jpg

缺失设置响应

当官方 Gecho MCP 工具不可用，或用户仅安装了技能但无法运行搜索时使用。

请使用以下模板作为标准缺失设置响应。代理可将文字段落翻译为用户语言，但不得将其压缩为更短的清单，除非用户明确要求简版。

必须包含的内容：

• 说明 Gecho Bridge MCP 未配置，仅安装技能无法运行 TikTok。
• 包含三项必要条件：MCP 已配置、Gecho Chrome 扩展已安装并登录、TikTok 网页已登录且标签页保持开启。
• 包含 OpenClaw MCP 设置命令和 openclaw mcp list 验证命令。
• 包含 Chrome 扩展链接。
• 包含设置完成后提示：请返回 OpenClaw 仪表板或 Hermes 重新发起请求。
• 包含全部相关链接：官网、OpenClaw 设置视频、Hermes 设置视频、YouTube 频道、GitHub/README、Discord、企业微信群二维码、一对一支持二维码。
• 包含模板中列出的相关 Gecho 技能。
• 本响应中不得推荐 openclaw plugins install。

Gecho Bridge 尚未准备就绪。

此技能已安装，但当前会话中尚未配置官方 Gecho Bridge MCP 工具。仅安装技能无法启动 TikTok 搜索服务。

Gecho 运行前需满足以下三项条件：

1. Gecho Bridge MCP 已配置。
2. Gecho Chrome 扩展已安装并登录 Gecho 账号。
3. TikTok 网页已在 Chrome 中登录，且登录标签页保持开启。

请按以下步骤完成首次设置：

**1. 安装 Gecho Chrome 扩展**

Chrome Web Store：
https://chromewebstore.google.com/detail/pjkaeenpekolahdbccjfenjcmanemlbj?utm_source=item-share-cb

安装后，打开扩展并登录您的 Gecho 账号。

**2. 配置 Gecho Bridge MCP**

OpenClaw MCP 设置：

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

openclaw gateway restart

随后验证：

openclaw mcp list

对于 Hermes：

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

hermes restart

**3. 登录 TikTok 网页**

在 Chrome 中打开 TikTok，登录账号，并保持已登录的标签页开启。

设置完成后，请返回 OpenClaw 仪表板或 Hermes，重新发起请求，例如：
“在 TikTok 上搜索电脑”

**相关链接**

- 官网：https://gecho.ai/
- OpenClaw 设置视频：https://www.youtube.com/watch?v=ggwY9hISHcQ
- Hermes 设置视频：https://www.youtube.com/watch?v=zHKnuWnxt_c
- YouTube 频道：https://www.youtube.com/@Gecho-AI
- GitHub 和 README：https://github.com/gecho-ai/gecho-bridge
- Discord 支持：https://discord.gg/RFDVZMR6Tn
- 企业微信群二维码：https://github.com/gecho-ai/gecho-bridge/blob/main/qywx.jpg
- 一对一支持二维码：https://github.com/gecho-ai/gecho-bridge/blob/main/wx.jpg

**相关 Gecho 技能**

- `tiktok-video-search`: TikTok 视频搜索与元数据收集。
- `tiktok-insight`: TikTok 产品、趋势、竞品及内容洞察任务。
- `tiktok-search`: 完整的 TikTok 搜索与洞察工作流。

故障排查