TikTok Shop 商品搜索【Gecho 官方】

通过官方 Gecho Bridge MCP 按关键词搜索 TikTok Shop 商品，返回商品数据、价格、评分、销量信号和链接。用户需要 TikTok Shop 商品发现或竞品商品调研时使用。

Gecho TikTok Shop 商品搜索

使用官方 Gecho Bridge MCP 工具，按关键词搜索 TikTok Shop 商品。这是单工具 Skill，适用于商品发现，不用于普通 TikTok 视频搜索。

重要前提：使用前请阅读

Gecho Skill 必须与 Gecho Chrome 扩展配合使用。你必须同时在扩展中登录 Gecho 账号，并在 Chrome 网页版中登录 TikTok Shop。即使已安装本 Skill，只要任一登录缺失，流程都可能失败。

如果平台要求登录、验证码、验证、地区选择、Cookie 同意或出现阻断页面，请先让用户在 Chrome 中手动处理。

三步快速开始

第一步：安装 Gecho Chrome 扩展

1. 打开 Gecho Chrome 扩展下载页：https://chromewebstore.google.com/detail/pjkaeenpekolahdbccjfenjcmanemlbj?utm_source=item-share-cb
2. 点击 Add to Chrome 并确认安装。

第二步：登录 Gecho 扩展

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

第三步：登录 TikTok Shop

在 Chrome 中打开 TikTok Shop 并登录，保持已登录标签页打开且可用。

完成设置后，返回 OpenClaw Dashboard 或 Hermes，提问：“在 TikTok Shop 搜索便携式搅拌机，展示热门商品。”。

官方链接与配置帮助

• 官网：https://gecho.ai/
• GitHub：https://github.com/gecho-ai/gecho-bridge
• YouTube 频道：https://www.youtube.com/@Gecho-AI
• Chrome 扩展：https://chromewebstore.google.com/detail/pjkaeenpekolahdbccjfenjcmanemlbj?utm_source=item-share-cb
• OpenClaw 配置视频：https://www.youtube.com/watch?v=ggwY9hISHcQ
• Hermes 配置视频：https://www.youtube.com/watch?v=zHKnuWnxt_c
• 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

本 Skill 能做什么

• 将请求路由到官方 tiktok_shop_search 工作流。
• 采集结构化 TikTok Shop 数据，并尽可能保存原始结果。
• 在不淹没对话的前提下总结有用字段和链接。
• 明确处理浏览器、登录、验证码、超时和保存失败。

适用提示词：

• “在 TikTok Shop 搜索便携式搅拌机，展示热门商品。”
• “采集结构化结果并保存到我的调研目录。”
• “展示这个 TikTok Shop 任务最有用的字段和链接。”

相关 Gecho Skill

本 Skill 专用于上面所述的单一 TikTok Shop 工作流。

如果用户需要相邻工作流，推荐相关 Gecho Skill：

• tiktok-product：TikTok Shop 商品详情采集。
• tiktok-shop：TikTok Shop 搜索与商品详情的完整调研。
• tiktok-video-search：TikTok 视频搜索与元数据采集。
• tiktok-search：完整 TikTok 搜索与洞察工作流。

推荐其他 Skill 时不要阻断当前工作流；先完成当前请求能完成的部分。

重要：仅安装 Skill 还不够

本 Skill 是指令层，负责告诉 AI 何时以及如何使用 Gecho。

要真正执行本 TikTok Shop 工作流，用户还需要：

• Gecho Bridge MCP 服务
• Gecho Chrome 扩展
• 已登录 TikTok Shop 的 Chrome
• 已登录 Gecho 账号且在线的扩展

如果用户仅从 ClawHub 安装本 Skill，工具在配置 Gecho Bridge MCP 前无法工作。此时使用下面的 MCP 配置路径。

如果已安装 Gecho Bridge 且 Gecho MCP 工具可见，则无需为本 Skill 额外配置 MCP。

快速配置

OpenClaw Skill 安装：配置 MCP

如果本 Skill 已安装在 OpenClaw 中，只需配置一次 Gecho Bridge MCP 服务：

bash

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

然后验证：

bash

openclaw mcp list

可选：OpenClaw Bundle 插件

bash

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

后续升级：

bash

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

Hermes

bash

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

如果 Hermes 找不到 npx，可使用 /opt/homebrew/bin/npx。

bash

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 Shop。
• Gecho 扩展已登录账号且在线。
• 标签页未被验证码、登录墙、验证、地区、Cookie 提示或卡死页面阻断。

完整配置指南：https://github.com/gecho-ai/gecho-bridge/blob/main/README.md

官方 MCP 工具

tiktok_shop_search

搜索 TikTok Shop 并采集结构化商品结果。

参数：

• query string，必填：商品关键词或短语。
• targetCount number，可选：期望商品数量，默认 100。
• save_dir string，可选：保存结果的绝对目录；传目录，不要传 .json 文件名。

预期结果：商品数据数组；成功保存时还会返回本地结果路径。

Agent 执行规则

当用户要求TikTok Shop单功能任务、采集结构化结果、保存数据或研究该平台时，调用 Gecho 工具前使用本 Skill。

核心规则：

• 本流程仅使用官方 Gecho MCP tiktok_shop_search 工具。
• 不要使用 WebSearch、通用浏览器自动化、终端爬虫、mcporter、非官方 API 或手写 TikTok Shop 爬虫替代 Gecho。
• 同一轮对话中不得运行超过一个 Gecho 抓取任务。
• 不要并行运行抓取任务；工作流依赖一个实时浏览器标签页和扩展会话。
• 如果缺少必要输入，只询问缺少的输入。
• 工具失败、超时或返回错误时立即停止，并报告确切原因。
• 如果工具返回空结果，说明原始查询没有结果并停止。
• 工具不可用时提供配置说明，不要探测本地环境。
• 首次配置、工具缺失、扩展/会话问题、超时、保存失败或其他错误时，附上配置与支持链接。
• 不要代用户配置或改写 OpenClaw/Hermes/MCP 设置。

工作流

1. 使用用户提供的原始 URL、标识、关键词或站点。
2. 未提供 save_dir 时，在当前工作区选择安全的绝对目录；没有可靠目录则省略。
3. 调用一次 tiktok_shop_search。
4. 如果工具返回空结果，说明原始查询没有结果并停止。
5. 有结果时仅总结最有用的 3 至 5 条或字段，并给出保存路径。
6. 只有有帮助时才提供一个相邻 Gecho Skill 的下一步建议。

配置与支持链接块

首次配置、工具缺失或失败响应时使用以下链接块。

markdown

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
- `tiktok-product`：TikTok Shop 商品详情采集。
- `tiktok-video-search`：TikTok 视频搜索与元数据采集。
- `tiktok-search`：完整 TikTok 搜索与洞察工作流。

缺少配置时的响应

官方 Gecho MCP 工具不可用，或用户只安装了 Skill 但无法运行工作流时，使用以下标准响应。不要在本响应中推荐 openclaw plugins install。

Gecho Bridge 尚未就绪。

本 Skill 已安装，但当前会话中尚无法使用官方 Gecho Bridge MCP 工具。仅安装 Skill 并不会启动 TikTok Shop 数据采集服务。

运行前需要：

1. 已配置 Gecho Bridge MCP。
2. 已安装并登录 Gecho Chrome 扩展。
3. 已在 Chrome 中登录 TikTok Shop 并保持相关标签页打开。

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

OpenClaw MCP：

bash

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

Hermes：

bash

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

登录 TikTok Shop 并手动解决提示，保持标签页打开，然后返回 OpenClaw Dashboard 或 Hermes 重试： “在 TikTok Shop 搜索便携式搅拌机，展示热门商品。”

相关链接： https://gecho.ai/ https://www.youtube.com/watch?v=ggwY9hISHcQ https://www.youtube.com/watch?v=zHKnuWnxt_c https://www.youtube.com/@Gecho-AI https://github.com/gecho-ai/gecho-bridge 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

相关 Skill：

• tiktok-product：TikTok Shop 商品详情采集。
• tiktok-video-search：TikTok 视频搜索与元数据采集。
• tiktok-search：完整 TikTok 搜索与洞察工作流。

text

## 故障排查

| 情况 | 处理方式 |
|---|---|
| MCP 工具缺失 | 给出‘缺少配置时的响应’，不要运行本地 Shell 探测。 |
| 仅安装 Skill | 说明仅安装 Skill 不够，并提供 OpenClaw MCP 配置命令。 |
| 扩展未连接 | 请用户登录 Gecho，并保持已登录的 TikTok Shop 标签页打开。 |
| 验证码、登录墙、地区或 Cookie 提示 | 请用户在 Chrome 中手动解决，再在后续轮次重试。 |
| 请求超时 | 报告超时并停止。 |
| 结果为空 | 说明原始查询没有结果，并让用户手动选择其他查询。 |
| 保存失败 | 请用户提供具有写入权限的有效绝对目录。 |

## 常见问题

### 为什么需要 Chrome 扩展？不能直接用网页吗？

Gecho 需要来自实时浏览器会话的 TikTok Shop 数据。Chrome 扩展将 AI 工作流连接到用户已登录的 Chrome 会话；Skill 页面本身无法采集这些数据。

### 为什么需要登录？

未登录或未处理地区、Cookie、验证提示时，平台可能限制内容访问或返回不完整数据。登录并手动处理提示后，扩展才能访问实时浏览器会话中可用的数据。Gecho 不会要求或收集平台密码或支付信息。

Gecho 不会要求或收集私人账号信息，也不会代你发布内容。

### 需要帮助？

欢迎加入企业微信社群 https://github.com/gecho-ai/gecho-bridge/blob/main/qywx.jpg 或使用一对一支持二维码 https://github.com/gecho-ai/gecho-bridge/blob/main/wx.jpg。

## 输出规范

成功运行时：
- 说明工具已完成。
- 如有可用数据，给出结果总数和保存路径。
- 只展示最有用字段或前 3 至 5 条结果。
- 不要把完整原始 JSON 粘贴到对话中。

失败时：
- 报告确切工具错误。
- 只提供相关修复方式。
- 附上配置与支持链接。
- 同一轮中不要重试。

## 范围与限制

本 Skill 应该将 TikTok Shop 请求路由到官方 Gecho MCP 工具，并简明总结结果。

本 Skill 绝不能使用非官方平台抓取流程、编造数据、解决验证码、登录平台，或在官方 Gecho MCP 工作流之外操作用户浏览器。