Gecho X 帖子调研
使用官方 Gecho Bridge MCP 工具按关键词搜索 X(Twitter)帖子,并查看一个已知帖子的详情和可获取回复。本 Skill 是 X 的聚合 Skill,适用于关键词监测、内容研究、作者信息、互动信号和帖子级分析。
用户明确只要求一个原始流程时,可使用 x-search 或 x-post-detail;当请求需要从关键词发现继续到帖子详情时,使用本聚合 Skill。
重要前提:使用前请阅读
Gecho Skill 必须与 Gecho Chrome 扩展配合使用。你必须同时在扩展中登录 Gecho 账号,并在 Chrome 网页版中登录 X(Twitter)。任一登录缺失时,即使 Skill 已安装,X 工作流也可能失败。
如果 X 显示登录墙、验证码、验证提示、频率限制、地区限制、帖子不可用或页面被拦截,请先在 Chrome 中手动解决,再重新调用工具。
三步快速开始
第一步:安装 Gecho Chrome 扩展
- 打开 Gecho Chrome 扩展下载页。
- 点击“添加至 Chrome”,确认安装扩展。
第二步:登录 Gecho 扩展
在 Chrome 中打开 Gecho 扩展并登录 Gecho 账号,保持扩展在线。
第三步:登录 X
在 Chrome 中打开 X(Twitter)并登录,保持已登录的 X 标签页打开且可用。
完成设置后,返回 OpenClaw 或 Hermes,提问:“搜索 X 上的便携式搅拌机,然后查看一条代表性帖子”。
官方链接与配置帮助
- 官网:gecho.ai
- GitHub:gecho-ai/gecho-bridge
- YouTube 频道:@Gecho-AI
- Chrome 扩展:Gecho 扩展
- OpenClaw 配置视频:OpenClaw + TikTok
- Hermes 配置视频:Hermes + TikTok
- Discord:https://discord.gg/RFDVZMR6Tn
- 企业微信社群二维码:qywx.jpg
- 一对一支持二维码:wx.jpg
本 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_search 和 x_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 并采集帖子正文、作者、互动数量和链接。
参数:
querystring,必填:搜索关键词或短语。targetCountnumber,可选:期望帖子数量,默认100。save_dirstring,可选:保存结果的绝对目录;传目录,不要传文件名。
预期结果:结构化帖子数据;成功写入时返回本地结果路径。
x_post_detail
采集主帖、作者信息、互动数据和回复。
参数:
urlstring,必填:X 帖子 URL。targetCountnumber,可选:期望回复数量,默认100。save_dirstring,可选:保存结果的绝对目录;不要传.json文件名。
预期结果:结构化主帖和回复数据;成功保存时返回本地路径。
Agent 执行规则
当用户要求关键词监测、帖子发现、已知帖子详情、作者信息、互动信号或回复分析时,在调用 X MCP 工具前使用本 Skill。
核心规则:
- 仅使用官方 Gecho MCP 工具
x_search和x_post_detail。 - 关键词发现使用
x_search,已知 URL 使用x_post_detail。 - 不要使用 WebSearch、通用浏览器自动化、终端爬虫、mcporter、非官方 API 或手写 X 抓取替代 Gecho。
- 同一轮对话中不得运行超过一个 Gecho 抓取任务。
- 不要并行运行 Gecho 任务;工作流依赖一个实时浏览器标签页和扩展会话。
- 如果缺少关键词或帖子 URL,只询问缺少的输入。
- 工具失败、超时或返回错误时立即停止,并报告确切原因。
- 帖子不可用、删除、受保护或被拦截时报告页面状态,不要编造内容或回复。
- 当前会话没有官方工具时提供配置说明,而不是探测本地环境。
- 首次配置、工具缺失、扩展、超时、保存或其他错误响应时附上配置与支持链接块。
- 正常成功响应中不要添加配置与支持链接块,除非用户请求配置帮助。
- 不要代用户配置、编辑、修复或改写 OpenClaw、Hermes 或 MCP 设置。
标准工作流
帖子发现工作流
- 使用用户请求的原始关键词。
- 未提供
save_dir时选择当前工作区安全的绝对目录;没有可靠目录则省略。 - 调用
x_search。 - 总结前 3 至 5 条帖子,并给出保存路径(如有)。
- 用户需要帖子级分析时,请其选择帖子 URL;若结果已返回明确 URL,则可以继续。
帖子详情工作流
- 确认用户提供了 X 帖子 URL。
- 保留该 URL,不要替换成其他帖子。
- 按安全目录规则选择或省略
save_dir。 - 调用
x_post_detail。 - 只总结工具实际返回的主帖、作者、互动和代表性回复。
- 如有保存路径一并给出。
组合工作流
- 使用
x_search搜索用户的原始关键词。 - 展示精简候选列表;用户未指定帖子时询问选择。
- 后续轮次对选定帖子调用
x_post_detail。 - 不要并行启动搜索和详情任务。
配置与支持链接块
首次配置以及所有配置或失败响应使用以下链接块:
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 内容。
Scan to join WeChat group