X / Twitter 油猴脚本:显示推文来源与去除页面广告

X / Twitter 油猴脚本:显示推文来源并过滤部分页面广告

这是一款适用于 X(Twitter)的浏览器用户脚本,可在帖子详情页展示推文的客户端来源,并去除部分时间线和推文详情中的推广内容。本文介绍脚本功能、安装方式、权限用途、工作原理及使用限制。

脚本功能简介

脚本主要提供两项功能:

  • 显示推文来源:在帖子详情页为主推文添加来源标签,例如“Twitter for iPhone”“Twitter Web App”或“Twitter for Android”。
  • 过滤部分推广内容:在页面运行时处理 X 的部分 GraphQL 响应,尝试过滤 HomeTimeline 和 TweetDetail 中的推广内容。

广告过滤属于浏览器页面层的尝试,具体效果可能会因 X 的接口与页面结构变化而有所不同。

适用环境

  • 支持的站点:https://x.com/*、https://twitter.com/*
  • 用户脚本管理器:Tampermonkey、Violentmonkey 或 ScriptCat
  • 运行时机:document-start,尽量在页面业务脚本运行前启动

获取脚本

在 Greasy Fork 查看脚本

从 GitHub 获取脚本文件

最新2026/10/27更新日志:

  • 适配新版timeline/conversation接口
  • 修复推文来源无法显示的问题
  • 已知问题:显示推文来源标签功能再次失效
  • 同样问题在IOS NeoFreeBird插件中存在: https://github.com/NeoFreeBird/app/issues/180
  • 安装方法

    1. 在浏览器中安装 Tampermonkey、Violentmonkey 或 ScriptCat
    2. 打开 Greasy Fork 脚本页面,按照页面提示安装;也可以在用户脚本管理器中新建脚本并粘贴源码
    3. 保存并启用脚本,然后打开 x.com 或 twitter.com 测试

    如果使用本地脚本文件,可在用户脚本管理器中导入文件,或打开文件并复制源码到新建脚本中。

    如何查看推文来源

    打开帖子详情页,例如 https://x.com/<用户名>/status/<tweetID>脚本会识别当前推文 ID、请求会话数据并尝试读取来源信息,然后在主推文附近显示类似下面的标签:

    📱 来源:Twitter for iPhone

    来源信息是否能正常显示,取决于接口响应、页面结构以及脚本当前版本的兼容情况。

    广告过滤如何工作

    当页面请求命中相关 GraphQL 接口时,脚本会尝试处理响应数据。当前介绍中涉及的接口包括:

    • /i/api/graphql/.../HomeTimeline
    • /i/api/graphql/.../TweetDetail

    脚本通过注入页面上下文,在浏览器页面运行时包装网络请求与相关处理逻辑,尝试让前端使用经过过滤的数据。它属于页面层的运行时处理,并不是系统网络代理,也不是对网络流量进行代理级拦截。

    脚本权限说明

    • GM_xmlhttpRequest:用于向 api.twitter.com 发起跨域请求,以尝试获取推文来源信息。
    • @connect api.twitter.com:声明脚本需要连接的接口域名。
    • @run-at document-start:尽量提前运行脚本,减少页面首批请求先于拦截逻辑完成的情况。

    主要特性

    • 来源缓存:使用内存缓存减少同一推文 ID 的重复请求。
    • 失败重试:来源请求遇到特定失败情况时尝试重新请求一次。
    • 单页应用路由支持:监听页面路径变化,在切换到新的帖子详情页后重新处理。
    • 页面变化观察:使用 MutationObserver 观察详情页更新,并在来源标签被页面重渲染移除时尝试重新添加。

    常见问题

    为什么没有显示推文来源?

    可能是来源接口请求失败、页面 DOM 结构变化、页面重新渲染,或脚本未能定位到主推文。脚本会尝试通过缓存、重试和页面变化观察来减轻这些情况,但无法保证每条推文都能显示来源。

    为什么广告过滤效果不稳定?

    过滤逻辑依赖 X 当前的 GraphQL 数据结构和前端处理方式。接口字段、页面代码或请求流程发生变化时,脚本可能无法识别推广内容,也可能需要更新适配逻辑。

    为什么需要在 document-start 运行?

    脚本需要尽可能早地建立页面层处理逻辑。如果页面的首批 GraphQL 请求已经完成,脚本可能会错过这些响应,因此使用 document-start 尽早运行。

    已知限制

    • 目前主要面向 x.com 和 twitter.com
    • 推文来源标签主要针对帖子详情页
    • 广告过滤依赖 X 的接口响应结构,不能保证始终有效或过滤所有推广内容
    • 如果 X 调整页面结构或接口逻辑,脚本可能需要更新

    开源信息

    • 许可证:MIT
    • 作者:狼小雨

    本脚本适合用于浏览器端功能体验与前端接口结构学习。使用前请查看脚本源码,并遵守相关网站的使用规则。

    這個網誌中的熱門文章

    【秘密基地】讨厌被注视与打扰的家里蹲,找到了一整箱没有刺眼广告的净土……!(之后挖到新东西还会继续补)

    关于小狼阿雪|Android 与 iOS 学习记录、安卓逆向研究与工具分享