Back to skills
extension
Category: Marketing & GrowthNo API key required

X 帖子全链路调研:搜索、帖子详情与回复分析【Gecho 官方】

通过官方 Gecho Bridge MCP 搜索 X(Twitter)帖子,并获取已知帖子的详情和回复。适用于关键词监测、帖子研究、作者信息、互动信号和回复分析。

Gecho X 帖子调研

使用官方 Gecho Bridge MCP 工具按关键词搜索 X(Twitter)帖子,并查看一个已知帖子的详情和可获取回复。本 Skill 是 X 的聚合 Skill,适用于关键词监测、内容研究、作者信息、互动信号和帖子级分析。

用户明确只要求一个原始流程时,可使用 x-searchx-post-detail;当请求需要从关键词发现继续到帖子详情时,使用本聚合 Skill。

重要前提:使用前请阅读

Gecho Skill 必须与 Gecho Chrome 扩展配合使用。你必须同时在扩展中登录 Gecho 账号,并在 Chrome 网页版中登录 X(Twitter)。任一登录缺失时,即使 Skill 已安装,X 工作流也可能失败。

如果 X 显示登录墙、验证码、验证提示、频率限制、地区限制、帖子不可用或页面被拦截,请先在 Chrome 中手动解决,再重新调用工具。

三步快速开始

第一步:安装 Gecho Chrome 扩展

  1. 打开 Gecho Chrome 扩展下载页
  2. 点击“添加至 Chrome”,确认安装扩展。

第二步:登录 Gecho 扩展

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

第三步:登录 X

在 Chrome 中打开 X(Twitter)并登录,保持已登录的 X 标签页打开且可用。

完成设置后,返回 OpenClaw 或 Hermes,提问:“搜索 X 上的便携式搅拌机,然后查看一条代表性帖子”。

官方链接与配置帮助

本 Skill 能做什么

  • 按关键词搜索 X 并采集结构化帖子正文、作者、互动数量和链接。
  • 根据已知帖子 URL 获取主帖、作者信息、互动数据和回复。
  • 支持从关键词发现到帖子详情的连续调研,不使用非官方 API 或抓取。
  • 在有可靠目录时将原始结果保存为本地 JSON 文件。
  • 在不淹没对话的前提下总结有用帖子和代表性回复。

适用的提示词:

  • “搜索 X 上的便携式搅拌机,展示代表性帖子。”
  • “查找这个商品类别最近的 X 帖子,并保存原始结果。”
  • “采集这条 X 帖子及其回复:https://x.com/example/status/123。”
  • “搜索 X 后,比较一条帖子的互动和回复主题。”

相关 Gecho Skill

本 Skill 是 X 的聚合工作流。

  • x-search:仅按关键词发现 X 帖子。
  • x-post-detail:仅采集已知帖子详情和回复。
  • tiktok-search:TikTok 视频和洞察调研。
  • amazon:从社交信号转向商品市场验证时使用。

推荐其他 Skill 时不要阻断当前 X 结果;先完成当前请求。

重要:仅安装 Skill 还不够

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

要真正执行 X 调研,用户还需要:

  • Gecho Bridge MCP 服务
  • Gecho Chrome 扩展
  • 在 Chrome 中登录 X
  • 在 Gecho 扩展中登录 Gecho 账号并保持在线

如果用户只从 ClawHub 安装本 Skill,工具在配置 Gecho Bridge MCP 前无法工作。如果已安装 @gecho-ai/gecho-bridge-bundle 且能看到工具,则无需额外配置 MCP。

快速配置

OpenClaw

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

结果中应能看到 x_searchx_post_detail

可选:OpenClaw Bundle 插件

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,请改用绝对路径,例如许多 macOS Homebrew 环境中的 /opt/homebrew/bin/npx

首次使用检查清单

首次执行 X 任务前确认:

  • Node.js >= 18 可用。
  • 已安装 Gecho Chrome 扩展。
  • Chrome 已打开并登录 X。
  • Gecho 扩展已登录并保持在线。
  • 请求帖子详情时已提供完整帖子 URL。
  • 页面没有被验证码、登录墙、频率限制或卡死标签页阻断。

完整配置指南: Gecho Bridge README

工具选择

| 用户目标 | 使用工具 | 说明 | |---|---|---| | 按关键词发现帖子 | x_search | 返回结构化帖子数据 | | 查看一个已知帖子 | x_post_detail | 需要 X 帖子 URL |

需要组合调研时使用本聚合 Skill。用户明确只要求一个原始工具时,可使用对应的单功能 Skill。

官方 MCP 工具

x_search

搜索 X 并采集帖子正文、作者、互动数量和链接。

参数:

  • query string,必填:搜索关键词或短语。
  • targetCount number,可选:期望帖子数量,默认 100
  • save_dir string,可选:保存结果的绝对目录;传目录,不要传文件名。

预期结果:结构化帖子数据;成功写入时返回本地结果路径。

x_post_detail

采集主帖、作者信息、互动数据和回复。

参数:

  • url string,必填:X 帖子 URL。
  • targetCount number,可选:期望回复数量,默认 100
  • save_dir string,可选:保存结果的绝对目录;不要传 .json 文件名。

预期结果:结构化主帖和回复数据;成功保存时返回本地路径。

Agent 执行规则

当用户要求关键词监测、帖子发现、已知帖子详情、作者信息、互动信号或回复分析时,在调用 X MCP 工具前使用本 Skill。

核心规则:

  • 仅使用官方 Gecho MCP 工具 x_searchx_post_detail
  • 关键词发现使用 x_search,已知 URL 使用 x_post_detail
  • 不要使用 WebSearch、通用浏览器自动化、终端爬虫、mcporter、非官方 API 或手写 X 抓取替代 Gecho。
  • 同一轮对话中不得运行超过一个 Gecho 抓取任务。
  • 不要并行运行 Gecho 任务;工作流依赖一个实时浏览器标签页和扩展会话。
  • 如果缺少关键词或帖子 URL,只询问缺少的输入。
  • 工具失败、超时或返回错误时立即停止,并报告确切原因。
  • 帖子不可用、删除、受保护或被拦截时报告页面状态,不要编造内容或回复。
  • 当前会话没有官方工具时提供配置说明,而不是探测本地环境。
  • 首次配置、工具缺失、扩展、超时、保存或其他错误响应时附上配置与支持链接块。
  • 正常成功响应中不要添加配置与支持链接块,除非用户请求配置帮助。
  • 不要代用户配置、编辑、修复或改写 OpenClaw、Hermes 或 MCP 设置。

标准工作流

帖子发现工作流

  1. 使用用户请求的原始关键词。
  2. 未提供 save_dir 时选择当前工作区安全的绝对目录;没有可靠目录则省略。
  3. 调用 x_search
  4. 总结前 3 至 5 条帖子,并给出保存路径(如有)。
  5. 用户需要帖子级分析时,请其选择帖子 URL;若结果已返回明确 URL,则可以继续。

帖子详情工作流

  1. 确认用户提供了 X 帖子 URL。
  2. 保留该 URL,不要替换成其他帖子。
  3. 按安全目录规则选择或省略 save_dir
  4. 调用 x_post_detail
  5. 只总结工具实际返回的主帖、作者、互动和代表性回复。
  6. 如有保存路径一并给出。

组合工作流

  1. 使用 x_search 搜索用户的原始关键词。
  2. 展示精简候选列表;用户未指定帖子时询问选择。
  3. 后续轮次对选定帖子调用 x_post_detail
  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
- 相关 Skill:`x-search` 用于发现,`x-post-detail` 用于已知帖子详情。

缺少配置时的响应

官方 Gecho MCP 工具不可用,或用户只安装了本 Skill 时使用以下标准响应。除非用户明确要求简短版,否则不要缩短;不要在本响应中推荐 openclaw plugins install

Gecho Bridge 尚未就绪。

本聚合 Skill 已安装,但当前会话中尚无法使用官方 Gecho Bridge MCP 工具。仅安装 Skill 不会启动 X 调研服务。

Gecho 需要以下全部 3 项:

1. 已配置 Gecho Bridge MCP。
2. 已安装 Gecho Chrome 扩展,并已登录 Gecho 账号。
3. 已在 Chrome 中登录 X,并保持标签页打开。

安装 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
```

在同一个 Chrome Profile 中登录 X 并保持标签页打开。然后返回 OpenClaw Dashboard 或 Hermes,重试搜索或帖子请求。

相关链接:
- 官网: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

相关 Skill:
- `x-search`:关键词帖子发现。
- `x-post-detail`:已知帖子详情和回复。
- `tiktok-search`:TikTok 视频和洞察调研。

故障排查

| 情况 | 处理方式 | |---|---| | MCP 工具缺失 | 给出“缺少配置时的响应”,不要运行本地 Shell 探测。 | | 用户仅安装了 Skill | 说明仅安装 Skill 不够,并提供 MCP 配置命令。 | | Hermes MCP 工具缺失 | 提供 Hermes 配置命令,不要改写 Hermes 配置文件。 | | 扩展未连接 | 请用户启用/登录 Gecho,并保持已登录 X 标签页打开。 | | 验证码、登录墙或频率限制 | 请用户在 Chrome 中手动解决,再在后续轮次重试。 | | 缺少关键词 | 询问 X 搜索关键词。 | | 缺少帖子 URL | 询问具体 X 帖子 URL。 | | 搜索为空 | 说明原始关键词无结果并停止。 | | 帖子不可用 | 报告页面状态,不要编造帖子或回复数据。 | | 请求超时 | 报告超时并停止,同一轮不要重试。 | | 保存失败 | 请用户提供有写入权限的有效绝对目录。 |

常见问题

可以先搜索再查看帖子吗?

可以。使用 x_search 发现帖子,再使用 x_post_detail 查看选中的帖子。任务应保持串行;如果搜索没有明确帖子 URL,请先让用户选择。

这个 Skill 会执行 X 账号操作吗?

不会。它只读取可访问的帖子和回复,不会发帖、点赞、关注、转发、私信或修改账号设置。

这是 TikTok 或 Amazon 调研吗?

不是。X 是独立平台工作流。TikTok 使用 tiktok-search,Amazon 使用 amazon

需要帮助怎么办?

可以加入企业微信社群、访问 Discord,或使用一对一支持二维码

输出规范

搜索成功时:

  • 说明搜索完成。
  • 如可用,展示前 3 至 5 条帖子的作者、正文摘要、互动数据和链接。
  • 给出结果总数和保存路径(如有)。
  • 不要粘贴完整原始 JSON。

帖子详情成功时:

  • 说明已打开并处理用户指定帖子。
  • 总结工具实际返回的主帖、作者、互动和代表性回复,不要编造缺失字段。
  • 如有保存路径一并给出。

失败时:

  • 报告确切工具错误或页面状态。
  • 只提供相关故障排查方式。
  • 附上配置与支持链接块。
  • 同一轮中不要重试。

范围与限制

本 Skill 应:

  • 在前置条件缺失时帮助用户完成官方 Gecho 配置。
  • 将 X 帖子发现和已知帖子详情请求路由到官方 MCP 工具。
  • 保持搜索到详情的调研流程明确且串行。
  • 在不淹没对话的前提下总结结果。

本 Skill 不得:

  • 在 MCP 缺失时假装仅靠 Skill 页面即可工作。
  • 使用非官方 X 抓取流程。
  • 编造帖子正文、作者、互动、回复或链接。
  • 在官方 Gecho MCP 工作流之外处理验证码、登录 X 或操作用户浏览器。
  • 发帖、点赞、关注、转发、私信或修改 X 内容。