twiyou

Twitter friend monitoring tool

twiyou（推油）是一款推特好友/推特数据监测工具。

搭建自己的部署

运行起来需要部署3个组件：数据库，数据抓取工具，监控面板，目前这3个组件都有免费的白嫖资源，此外需要有推特开发者账号。

数据库我用的是TiDB Cloud DevTier (https://tidbcloud.com/ )的免费资源，理论上兼容MySQL协议的应该都行，不过我没试。
数据抓取工具可以从 Release 下载，找台机器配置好环境变量定时运行程序就行（推荐5分钟运行一次）。也可以白嫖 GitHub Actions。
监控面板用的是Grafana，Grafana Cloud (https://grafana.com/ )也是可以创建免费的账号，添加数据库数据源之后，把监控模板导入就行。

搭建自己的部署（详细攻略）

1. 注册 twitter 开发者账号

注册地址：https://developer.twitter.com/en

申请成功后创建一个项目，然后把如图所示的Bearer Token记录下来备用。

2. 注册 TiDB Cloud DevTier

注册地址：https://tidbcloud.com/

完成后创建一个免费的DevTier集群，然后在集群页面可以看到连接参数。

3. 部署数据抓取工具

下载地址：https://github.com/disksing/twiyou/releases

然后配置好crontab和环境变量每5分钟运行一次就行，抓下来的数据都会写到数据库里面，本地不存数据。

环境变量设置如下图。

注意DB_NAME需要提前自己连接数据库后创建，懒得手动创建的话直接填test数据库也行。

TWITTER_USER_NAME填自己的twitter id，当然你如果想监控别人的好友，填别人的id也可以。

如果自己没有服务器的话，可以使用免费的 GitHub Action 来跑：

fork 这个项目
在 Repo Settings - Secrets 里配置好环境变量
在 https://github.com/settings/tokens 里生成一个新的 Personal access token
配置一个触发器定时发送类似下面的 HTTP 请求来触发 Github Action：

curl \
-X POST \
-H "Accept: application/vnd.github+json" \
-H "Authorization: Bearer <YOUR-GITHUB-TOKEN>" \
https://api.github.com/repos/<OWNER>/twiyou/actions/workflows/scrape.yml/dispatches \
-d '{"ref": "master"}'

这类第三方服务比较多，比如 Cloudflare worker，https://cron-job.org 都行。以 cron-job.org 为例：

4. 配置 Grafana

注册地址：https://grafana.com

完成后在自己的Grafana实例添加MySQL数据源，参考截图，这里Timezone不要填。

然后导入预定义模板，选择之前创建的数据源。在第一轮数据抓完之前，可能不会立即看到数据。

一些问题和后续计划（请求出谋划策）

twitter开发者账号申请比较麻烦，而且API的rate limit等限制颇多，可以考虑换成绕过开发者API的方案。例如twint，不过我还没仔细研究。不好搞的话，或许可以考虑配置多个API key，轮换着用。
想把自己的历史推文抓下来分析下，比如统计历史推文的传播表现，或者把发推历史跟follower数量变化做点关联分析之类，但是目前twitter API限制只能抓近一周的历史推文，所以这个功能可能依赖于上一个问题的解决。

kba977 / twiyou