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,尽量在页面业务脚本运行前启动
获取脚本
最新2026/10/27更新日志:
安装方法
- 在浏览器中安装 Tampermonkey、Violentmonkey 或 ScriptCat
- 打开 Greasy Fork 脚本页面,按照页面提示安装;也可以在用户脚本管理器中新建脚本并粘贴源码
- 保存并启用脚本,然后打开
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
- 作者:狼小雨
本脚本适合用于浏览器端功能体验与前端接口结构学习。使用前请查看脚本源码,并遵守相关网站的使用规则。