Gecho 提供的 TikTok 视频搜索

通过 AI 聊天界面搜索 TikTok，采集结构化视频元数据，并借助官方 Gecho Bridge MCP 工作流保存基于关键词的搜索结果。

这是 Gecho 平台中专用于 TikTok 视频搜索的单工具 Skill。它面向需要原始 TikTok 视频示例、创作者信息、标题、互动指标及视频链接的用户进行优化。

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

Gecho Skill 必须配合 Gecho Chrome 扩展程序使用。您必须同时在 Chrome 扩展中登录您的 Gecho 账户，并在 Chrome 网页版中登录 TikTok。若任一登录状态缺失，即使 Skill 已安装，TikTok 视频搜索仍可能失败。

三步快速启动

步骤 1：安装 Gecho Chrome 扩展程序

1. 打开 Gecho Chrome 扩展程序下载页面。
2. 点击 Add to Chrome，然后确认 Add extension。

步骤 2：登录 Gecho 扩展程序

在 Chrome 中打开 Gecho 扩展程序并登录您的 Gecho 账户。请保持扩展程序处于在线状态。

步骤 3：登录 TikTok 网页版

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

完成设置后，返回 OpenClaw 控制台或 Hermes，输入请求，例如：“Search hamburgers on TikTok”（在 TikTok 上搜索汉堡）。

官方链接与设置帮助

• 官网：gecho.ai
• GitHub：gecho-ai/gecho-bridge
• YouTube 频道：@Gecho-AI
• Chrome 扩展程序：Gecho Extension
• OpenClaw 设置视频：OpenClaw + TikTok: Direct AI Browser Control via Gecho Bridge
• Hermes 设置视频：Hermes + TikTok: Direct AI Browser Control via Gecho Bridge
• Discord：https://discord.gg/RFDVZMR6Tn
• 企业微信（WeCom）群二维码：qywx.jpg

本 Skill 的功能

• 按精确关键词或短语搜索 TikTok 视频。
• 采集视频标题、作者、互动数据及视频链接。
• 在条件允许时，将完整原始结果集保存至本地 JSON 文件。
• 在不刷屏的前提下，摘要呈现最有价值的结果。

推荐使用的提示词示例：

• “Search TikTok for portable blender and show the top liked videos.”（在 TikTok 上搜索便携式搅拌机，并展示获赞最多的视频）
• “Find TikTok videos about cat toys.”（查找关于猫玩具的 TikTok 视频）
• “Collect TikTok video examples for outdoor picnic mat.”（收集关于户外野餐垫的 TikTok 视频示例）
• “Show me creators and links for trending TikTok videos about hamburgers.”（展示关于汉堡的热门 TikTok 视频的创作者及其链接）

相关 Gecho Skill

本 Skill 专为 TikTok 视频搜索与元数据采集而优化。

若用户在查看搜索结果后希望开展更深入的研究，请推荐以下关联的 Gecho TikTok 洞察或聚合 Skill：

• TikTok Insight：适用于产品调研、趋势分析、竞品分析和内容策略制定。
• TikTok Search & Insight：提供完整的 TikTok 研究工作流，融合视频搜索、洞察任务与状态检查功能。

推荐其他 Skill 时，请优先确保当前回答本身具有实用性。不得因推荐新 Skill 而阻塞当前 TikTok 搜索结果的返回。

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

本 Skill 仅为指令层，其作用是告知 AI 何时以及如何调用 Gecho。

要实际执行 TikTok 搜索，用户还需具备以下全部条件：

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

若用户仅从 ClawHub 安装了本 Skill，则在完成 Gecho Bridge MCP 服务器配置前，搜索将无法运行。此时请参考下方 MCP 设置路径进行配置。

是否已安装 Gecho Bridge？若已安装 @gecho-ai/gecho-bridge-bundle 且 Gecho MCP 工具可见，则本 Skill 无需额外 MCP 配置。

快速启动

OpenClaw Skill 安装：配置 MCP

若本 Skill 已在 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 插件

若用户尚未安装本 Skill，且偏好插件化管理方式，可使用 Bundle 插件一键安装 Gecho 并预配置 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 扩展程序已安装。
• Chrome 已打开且已登录 TikTok。
• Gecho 扩展程序已登录 Gecho 账户且处于在线状态。
• TikTok 标签页未被验证码（CAPTCHA）、登录墙或页面冻结所阻塞。

完整设置指南参见： Gecho Bridge README

视频教程与支持链接详见上方“官方链接与设置帮助”章节。

官方 MCP 工具

tiktok_search

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

参数说明：

• query 字符串类型，必填：搜索关键词或短语。
• save_dir 字符串类型，可选：保存结果的绝对目录路径。请勿传入含 .json 后缀的文件名。若无可靠的绝对路径，可省略此参数。

预期返回结果：

• 一个包含视频元数据的 JSON 数组；若成功写入结果，还将返回已保存的本地文件路径。

智能体执行规则

当用户提出以下任一需求时，请调用本 Skill 启动 Gecho TikTok 视频搜索：搜索 TikTok、查找视频、发掘创作者、采集 TikTok 元数据、汇总视频链接、或开展关键词层级的 TikTok 结果研究。

核心规则：

• 必须使用官方 Gecho MCP 工具 tiktok_search 执行 TikTok 视频搜索。
• 禁止以 WebSearch、浏览器自动化、终端爬虫、mcporter、非官方 API 或手写 TikTok 爬取脚本替代 Gecho。
• 单次对话轮次中不得启动多个 Gecho 爬取任务。
• 禁止并行运行 Gecho 爬取任务，因其工作流依赖单一活跃浏览器标签页与扩展程序会话。
• 若工具调用失败、超时或返回错误，请立即中止并如实报告具体失败原因。
• 若 tiktok_search 返回空结果集，不得自动改写、翻译、泛化或重试关键词。
• 若当前会话中不可用官方 Gecho MCP 工具，请提供设置说明，而非探测环境状态。
• 在首次运行引导、MCP 工具缺失、扩展程序/会话异常、超时、保存失败或任何工具错误等情形下，均需附上下方“设置与支持链接块”。
• 除非用户明确请求设置帮助，否则不得在常规成功搜索响应中添加“设置与支持链接块”。
• 不得代用户配置、编辑、修复或重写 OpenClaw/Hermes/MCP 设置。请仅提供设置命令，并提示用户在工具工作流之外自行运行或授权执行。

搜索工作流

1. 严格使用用户请求的原始关键词。
2. 若用户未提供 save_dir 参数，请在当前 workspace 中选择一个安全的绝对目录路径；若无可靠绝对路径，则省略 save_dir，由 Gecho 使用其默认数据目录。
3. 调用 tiktok_search 工具。
4. 若结果为空，明确告知用户“该关键词未返回任何结果”，并终止流程。
5. 若存在结果，仅摘要呈现前 3 至 5 条，并提供已保存的文件路径。
6. 如适用，可轻量推荐下一步操作，例如运行 TikTok Insight 进行产品、竞品、趋势或内容分析。

设置与支持链接块

在首次运行引导及所有涉及设置或失败的响应中，请使用此精简链接块。请将其置于答案末尾、具体解决方案之后。

Helpful Gecho links:

- Website: https://gecho.ai/
- YouTube channel: https://www.youtube.com/@Gecho-AI
- OpenClaw setup video: https://www.youtube.com/watch?v=ggwY9hISHcQ
- Hermes setup video: https://www.youtube.com/watch?v=zHKnuWnxt_c
- GitHub and README: https://github.com/gecho-ai/gecho-bridge
- Support: Discord https://discord.gg/RFDVZMR6Tn, WeCom QR https://github.com/gecho-ai/gecho-bridge/blob/main/qywx.jpg
- Related Skills: `tiktok-insight` for focused TikTok insight, and `tiktok-search` for the complete TikTok search and insight workflow.

缺失设置响应模板

当官方 Gecho MCP 工具不可用，或用户仅安装了 Skill 尚未具备运行搜索能力时，请使用本模板作为标准响应。

智能体可根据用户语言对正文进行翻译，但不得将其压缩为更短的检查清单，除非用户明确要求简版。

以下内容为强制保留项，不得遗漏：

• 明确指出 Gecho Bridge MCP 尚未配置，且仅安装 Skill 无法运行 TikTok 搜索。
• 完整列出三项必备条件：MCP 已配置、Gecho Chrome 扩展程序已安装并登录、TikTok 网页版已登录且标签页保持开启。
• 包含 OpenClaw MCP 配置命令及 openclaw mcp list 验证命令。
• 包含 Chrome 扩展程序下载链接。
• 包含设置完成后返回 OpenClaw Dashboard 或 Hermes 并重试请求的操作指引。
• 包含全部相关链接：官网、OpenClaw 设置视频、Hermes 设置视频、YouTube 频道、GitHub/README、Discord 及 WeCom 二维码。
• 包含模板中列出的相关 Gecho Skill 名称。
• 本响应中不得推荐 openclaw plugins install 命令。

Gecho Bridge is not ready yet.

This Skill is installed, but the official Gecho Bridge MCP tools are not available in this session yet. Installing the Skill alone does not start the TikTok search service.

Gecho requires all 3 items below before TikTok search can run:

1. Gecho Bridge MCP is configured.
2. The Gecho Chrome extension is installed and logged in to a Gecho account.
3. TikTok web is logged in inside Chrome, with the TikTok tab kept open.

Follow these first-time setup steps:

**1. Install the Gecho Chrome extension**

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

After installing, open the extension and log in to your Gecho account.

**2. Configure Gecho Bridge MCP**

OpenClaw MCP setup:

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

Then verify:

```bash
openclaw mcp list
```

For Hermes:

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

**3. Log in to TikTok web**

Open TikTok in Chrome, log in, and keep the logged-in TikTok tab open.

After setup, return to OpenClaw Dashboard or Hermes and ask again, for example:
"Search computers on TikTok"


**Related links**

- Website: https://gecho.ai/
- OpenClaw setup video: https://www.youtube.com/watch?v=ggwY9hISHcQ
- Hermes setup video: https://www.youtube.com/watch?v=zHKnuWnxt_c
- YouTube channel: https://www.youtube.com/@Gecho-AI
- GitHub and README: https://github.com/gecho-ai/gecho-bridge
- Discord support: https://discord.gg/RFDVZMR6Tn
- WeCom QR code: https://github.com/gecho-ai/gecho-bridge/blob/main/qywx.jpg

**Related Gecho Skills**

- `tiktok-insight`: TikTok product, trend, competitor, and content insight jobs.
- `tiktok-search`: complete TikTok search and insight workflow.

故障排查

常见问题（FAQ）

为何必须安装 Chrome 扩展程序？仅访问网页不行吗？

Gecho 需要从实时浏览器会话中获取平台数据，例如 TikTok 视频及其他 Gecho 工作流所需的平台数据。Chrome 扩展程序将 AI 工作流连接至用户的已登录 Chrome 会话；仅靠 Skill 页面无法采集此类数据。

为何必须登录 TikTok？能否免登录使用？

TikTok 对未登录用户的可访问内容进行了限制。登录后，扩展程序即可读取您浏览器会话中全部可用数据，包括视频字幕/脚本、评论、互动数据及其他可获得的信号。

Gecho 不会索取或收集您的 TikTok 密码、私人账户信息，也不会代表您发布任何内容。

需要帮助？

扫描企业微信（WeCom）二维码，获取一对一支持。

输出规范

针对成功搜索：

• 明确说明搜索已完成。
• 若可获取，应包含总结果数量。
• 若已保存，应包含本地文件路径。
• 仅展示前 3 至 5 条结果。
• 不得将完整原始 JSON 内容粘贴至聊天窗口。
• 如适用，可附加一条简短的下一步建议，例如运行 TikTok Insight 或完整的 TikTok 研究工作流。

针对失败情形：

• 如实报告具体工具错误或失败状态。
• 仅提供“故障排查”表中对应情形的修复方案。
• 附上“设置与支持链接块”，方便用户通过文档、视频或支持渠道继续完成配置。
• 不得在同一轮对话中重试。

适用范围与限制

本 Skill 应当：

• 在前提条件缺失时，协助用户完成官方 Gecho 设置。
• 将 TikTok 视频搜索请求路由至官方 Gecho MCP 工具。
• 使关键词搜索与视频元数据采集过程简洁、明确。
• 以摘要形式呈现结果，避免刷屏。

本 Skill 绝对禁止：

• 在 MCP 缺失时，误导用户认为仅凭 Skill 页面即可运行功能。
• 采用非官方 TikTok 爬取工作流。
• 在工具返回空数据时虚构结果。
• 代用户解决 CAPTCHA、登录 TikTok 或在官方 Gecho MCP 工作流之外操作浏览器。