Tootbot

🐘 联邦宇宙一键发布助手

social-media榜 #31

通过 Node.js CLI 向 Mastodon 联邦宇宙发布图文动态,支持定时发布、隐私分级与引用权限控制。

收藏
10.6k
安装
2.7k
版本
0.4.0
CLS 安全性认证2026-06-23
点击查看完整报告 >

使用说明

核心用法

Mastodon Publisher 是一个命令行工具技能,允许用户直接向 Mastodon 实例发布状态更新。它封装了 toobot.js 脚本,通过 Node.js 执行环境调用 Mastodon API。

主要功能

  • 发布纯文本或带媒体附件的动态
  • 支持四种可见性级别:public(公开)、unlisted(不公开)、private(仅关注者)、direct(私信)
  • 定时发布功能,接受 RFC3339 格式的时间戳
  • 引用权限控制(quote approval policy),限制谁可以引用你的帖子
  • 多语言支持(ISO 639-1 语言代码)
  • 支持多图上传

配置要求

  • 环境变量:MASTODON_URL(实例地址)和 MASTODON_ACCESS_TOKEN(访问令牌)
  • 依赖:Node.js 必须已安装且在 PATH 中

显著优点

1. 联邦宇宙原生:直接对接 Mastodon 去中心化协议,非第三方代理
2. 隐私粒度精细: visibility 和 quote policy 双重控制

3. 自动化友好:CLI 设计易于集成到脚本和工作流

4. 定时发布:支持未来时间安排,适合内容运营

潜在缺点与局限性

  • 令牌安全风险:Access Token 以环境变量形式暴露,若日志泄露可能被盗用
  • 无交互确认:直接执行发布,缺乏二次确认机制
  • 单实例限制:每次调用仅支持一个 Mastodon 实例
  • 媒体路径依赖本地文件:不支持远程 URL 直接上传
  • Node 依赖:相比纯 HTTP 请求增加了运行时依赖

适合人群

  • 需要在 Mastodon 进行自动化内容分发的开发者/运营者
  • 希望从命令行或脚本环境管理联邦宇宙账号的技术用户
  • 对隐私控制有较高要求的社交媒体管理者

常规风险

  • 认证信息泄露:环境变量中的 access token 若被窃取可导致账号被恶意使用
  • 定时任务失控:错误的 --scheduled-at 时间可能导致内容意外延迟或提前发布
  • 媒体文件路径错误:相对路径解析失败会导致发布失败
  • 实例可用性依赖:目标 Mastodon 实例故障或服务变更可能影响功能

安全解读

核心用法

Mastodon Publisher 是一个用于将内容发布到 Mastodon 联邦宇宙社交媒体平台的自动化工具。用户通过 Node.js 脚本 toobot.js 执行 new-status 命令,配合 --status 文本内容、--visibility 可见性设置(public/private/unlisted/direct)、--language ISO 639-1 语言代码、--scheduled-at RFC3339 定时参数以及 --media-path 媒体附件路径等参数,实现灵活的动态或定时发布。环境变量 MASTODON_URLMASTODON_ACCESS_TOKEN 用于配置实例地址和 API 凭证。

显著优点

安全架构设计:采用环境变量存储敏感凭证,彻底杜绝硬编码密钥风险;330KB 自包含单文件部署,零外部 npm 依赖,供应链攻击面极小。

功能完整丰富:支持纯文本、多媒体附件、定时发布、可见性分级、引用权限控制等 Mastodon 原生 API 完整特性。

合规性优秀:通过 GDPR 数据最小化、用户同意机制、敏感凭证安全存储等六项合规检查,隐私保护到位。

来源可信:作者信息明确(Behrang Saeedzadeh),MIT 开源协议,GitHub 社区项目背景,无已知恶意模式匹配。

潜在缺点与局限性

网络依赖风险:必须访问外部 Mastodon 实例,用户需自行验证目标服务器可信度;不支持证书固定或额外验证机制,存在中间人攻击理论风险。

权限管理责任:访问令牌权限范围完全依赖用户配置,若误用高权限令牌(如 admin 级别)可能导致账户安全风险。

Node.js 环境依赖:要求目标系统预装 Node.js 运行时,对轻量级容器环境可能增加部署负担。

功能单一性:仅覆盖发布场景,不支持 Mastodon 内容读取、互动管理(回复/转发/点赞)或账户分析等进阶功能。

适合人群

  • 个人博主与内容创作者,需自动化跨平台内容分发至 Mastodon
  • 开发者与 DevOps 工程师,构建社交媒体 CI/CD 发布流水线
  • 注重隐私与去中心化社交的用户,倾向使用联邦宇宙平台替代中心化社交网络
  • 技术团队需定时公告、状态更新等自动化运维通知场景

常规风险

  • 实例可信度风险:配置不可信 Mastodon 实例可能导致数据泄露或内容劫持
  • 令牌泄露风险:环境变量配置不当或日志泄露可能导致账户被恶意利用
  • 内容误发风险:自动化脚本缺乏人工审核环节时,可能意外发布错误内容或敏感信息
  • 定时任务可靠性:依赖外部 Mastodon 服务器的定时发布功能,存在服务可用性风险

Tootbot 内容

scripts文件夹
手动下载zip · 87.2 kB
tootbot.jstext/javascript
请选择文件