mcpField
B
browse-x

browse-x

github.com/pc-style生产力16877 次安装今天更新
代码仓库

关于 browse-x

browse-x 是用于读取 X 公开内容的技能，适合无法使用浏览器或登录 X、但需要查看帖子、个人资料或搜索结果的场景。它通过命令行返回 Markdown 或结构化数据，不支持写入，并提示结果可能受限或延迟。

主要功能

  1. 01读取公开帖子和文章
  2. 02查看个人资料及原创帖子
  3. 03查询关注者与关注列表
  4. 04搜索公开 X 内容
  5. 05以 Markdown 或 JSON 输出

适用场景

  1. 01查看文档中的 X 链接内容
  2. 02获取公开账号简介和近期帖子
  3. 03将帖子内容保存到笔记
  4. 04以数据形式检索 X 搜索结果

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/pc-style/x-md --skill browse-x

安装后在 Claude Code 中输入/browse-x确认已加载。

附带文件scripts/browse-x.tstests/browse-x.test.ts

详细介绍

browse x

通过 mdfromx.com 获取公开内容。无需登录 X。请从此技能的目录运行辅助脚本：

适用场景

在需要立即读取一条公开 X 内容时使用：

  • 你需要获取一条公开 X 帖子、帖子串或 X Article 的文本，但无法运行浏览器或登录 X。
  • 你在文档、问题、变更日志或聊天记录中遇到 x.com、twitter.com 或 t.co 链接，需要直接查看其内容。
  • 你想查看某个公开个人资料的简介和最新原创帖子（已过滤回复和转发）。
  • 你想查看某个公开账号关注了谁，或谁关注了它。
  • 你想将 X 搜索结果作为数据获取，而不是查看渲染后的时间线。
  • 你想将帖子保存到笔记或知识库中——--format obsidian 会生成 YAML frontmatter。

不适用场景

  • 任何写入操作。它不会发帖、回复、关注、点赞、收藏或发送私信，也不需要 X 凭据。
  • 私密、受保护、已停用或已删除的账号和帖子。它们始终不可用，没有任何标志能解锁。
  • X Lists、私信、通知、个性化主页时间线、账号分析。均不支持。
  • 批量采集、回填或构建数据集。该工具有速率限制，且会针对单个问题缓存结果。
  • 任何需要保证完整性或 SLA 的场景。结果来自公开上游提供方，可能延迟或截断——请查看 warnings，不要想当然。
bun scripts/browse-x.ts "https://x.com/handle/status/123"
bun scripts/browse-x.ts profile handle
bun scripts/browse-x.ts search "from:handle release"
bun scripts/browse-x.ts followers handle
bun scripts/browse-x.ts following handle

选项

默认输出 Markdown。使用 --json 获取结构化输出，--full 获取元数据，--compact 获取精简输出。使用返回的游标搭配 --cursor 继续获取。运行 bun scripts/browse-x.ts --help 查看帖子串、信息流和其他选项。

可选：X_MD_API_KEY 用于发送 bearer 密钥；X_API_BASE 用于更改主机。切勿打印密钥。无效或已禁用的密钥会返回 401。

限制

公开请求和带密钥的请求有不同的配额。遇到 429（退出码 3）时，请等待输出的 Retry-After；不要循环重试。退出码 2 表示参数错误，退出码 1 表示其他错误。私密或已删除的内容可能不可用。请检查 warnings；不要杜撰缺失的回复、媒体或置顶帖子。

评论

支持 Markdown