运行时依赖
安装命令
点击复制技能文档
TikTok 搜索 🚀 一个用于搜索和提取 TikTok 视频元数据的专用工具。它通过 Chrome 浏览器扩展程序与本地浏览器连接，执行自动搜索、滚动和数据收集。
工具 tiktok_search 执行关键词搜索，自动滚动加载结果，并返回元数据。 参数： query (字符串，必需)：搜索关键词或短语（例如 "cooking tips"，"travel vlogs"）。 save_dir (字符串，选项)：保存结果 JSON 的绝对路径。 最佳实践：始终主动生成一个安全的、带时间戳的绝对路径，在当前工作空间中（例如 /absolute/path/to/workspace/tiktok_travel_vlogs_1690000000.json），以便用户不会丢失原始数据。 返回值：包含视频 ID、标题、点赞数、播放 URL 和作者信息的 JSON 数组。
tiktok_insight 根据 TikTok 搜索结果执行商业洞察和趋势分析。 参数： query (字符串，必需)：搜索关键词或短语（例如 "outdoor picnic mat"）。 save_dir (字符串，选项)：保存结果 JSON 的绝对路径。 返回值：根据搜索查询分析的洞察和趋势的 JSON 数组。
前置条件检查和环境设置 在调用之前，请确保满足以下前置条件： Node.js：安装在本地环境中。 Gecho TikTok 扩展程序和活动标签页：用户必须在本地打开 Chrome，启用扩展程序，并打开一个 TikTok 标签页。 ⚠️ 关键代理指令：您（代理）不得尝试安装 Chrome、打开浏览器或使用类似 browser_navigate 的工具来满足这些前置条件。不要检查 Chrome 本身。您的唯一责任是调用 MCP 工具。
执行规则和约束（关键） 您必须严格遵守以下规则来调用 MCP 工具： 单一工具调用限制：您不得在单个对话回合中执行多个工具调用（tiktok_search 或 tiktok_insight）。 您必须等待用户的反馈，然后再启动另一个搜索或洞察请求。 严格工具绑定（无回退）：您只能使用指定的工具（tiktok_search 或 tiktok_insight）进行 TikTok 搜索。 您严格禁止在这些工具之间回退。例如，如果用户请求洞察（tiktok_insight）并且它失败或超时，您不得尝试调用 tiktok_search 作为备份。立即停止并报告失败。 您还禁止使用内置浏览器工具、通用 WebSearch 或编写 Python 爬虫访问 TikTok.com。
快速失败和显式报告：如果 MCP 工具失败、超时或抛出错误（例如，params 未定义），您必须立即停止。不要提供替代的 Web 搜索解决方案。您必须将原始错误消息输出给用户。
无并行执行：由于该工具控制一个活动的 Chrome 标签页，因此它是严格的单线程的。您不得同时执行多个 tiktok_search 工具调用。您必须等待一个搜索完全完成，然后再启动另一个搜索。
反幻觉（无假数据）：您必须仅基于工具返回的确切数据来生成最终响应。如果工具返回空结果（[]），您不得幻觉或猜测。通知用户工具返回的确切内容。
反垃圾邮件（无无限循环）：永远不要重复调用工具使用相同的查询，如果它失败或返回空结果。
无重试（严格）：如果调用由于超时（MCP 错误 -32001）、网络错误或其他原因失败，您必须立即停止并将错误返回给用户。不要尝试在同一回合或后续回合中再次调用工具，除非用户明确请求。
超时意识：tiktok_insight 工具可能需要长达 5 分钟才能完成。如果您收到超时错误，请通知用户该操作太复杂，或者他们应该检查浏览器是否有 CAPTCHA。
输出摘要（避免聊天垃圾邮件）：如果工具返回大量结果（例如 200 个视频），请不要在聊天响应中打印整个原始 JSON 数组。您必须总结前 3-5 个结果，并使用 save_dir 参数将完整数据集保存到用户的磁盘中。
故障排除和错误处理（决策树） 如果 tiktok_search 工具执行失败，请按照以下决策树来帮助用户： 错误："MCP 错误 -32001：请求超时" → 立即停止。不要重试。 → 通知用户："分析/搜索需要的时间比预期长。请检查 Chrome 浏览器是否显示 CAPTCHA 或页面是否卡住。您可以在解决任何浏览器问题后再试一次。" 错误："Chrome 扩展程序未找到/连接" → 通知用户："请确保 Gecho TikTok Chrome 扩展程序已安装、启用，并且在 Chrome 中打开了一个活动的 TikTok 标签页。" 错误："超时"（服务级别）→ 通知用户："服务层超时。通常发生在搜索量非常高时。尝试使用更具体的查询。" 错误："工具未找到"