通过官方 Gecho Bridge MCP 按关键词搜索公开的 X(Twitter)帖子,返回帖子文本、作者、互动数据和链接。用户需要 X 关键词级调研或监测时使用。
集成
X 帖子全链路调研:搜索、帖子详情与回复分析【Gecho 官方】
试用通过官方 Gecho Bridge MCP 搜索 X(Twitter)帖子,并获取已知帖子的详情和回复。适用于关键词监测、帖子研究、作者信息、互动信号和回复分析。
它能做什么
通过官方 Gecho Bridge MCP 搜索 X(Twitter)帖子,并获取已知帖子的详情和回复。适用于关键词监测、帖子研究、作者信息、互动信号和回复分析。
技能文档
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 内容。
相关技能
通过官方 Gecho Bridge MCP 获取一条 X(Twitter)帖子及其回复。用户提供 X 帖子 URL,并需要正文、作者、互动数据或评论时使用。
Search X (Twitter) posts and retrieve known post details and replies through the official Gecho Bridge MCP tools. Use for keyword monitoring, post research, author context, engagement signals, and reply analysis.
Collect one X (Twitter) post and its replies with the official Gecho Bridge MCP tool. Use when the user provides an X post URL and wants the post content, author data, engagement, or comments.
通过 Gecho Bridge MCP 搜索 TikTok 视频、采集创作者视频、获取指定视频详情与评论,并开展商品、趋势、竞品与内容洞察。需要安装 Gecho Chrome 扩展、保持有效的 TikTok 登录会话,并配置 Gecho Bridge MCP 服务。
通过官方 Gecho Bridge MCP 搜索 TikTok Shop 商品并获取已知商品详情。适用于商品发现、商品库调研、竞品比较、价格与销量信号分析,以及指定商品详情采集。