freemobile-sms

💬 Free Mobile 专属短信通知助手

基于 Free Mobile 官方 API 的 SMS 通知技能,由实名开发者 Damien Clauzel 开源维护,帮助用户通过环境变量安全配置,实现向自己手机发送即时短信提醒。

收藏
8k
安装
2k
版本
v0.0.1
CLS 安全性认证2026-05-21
点击查看完整报告 >

使用说明

核心用法

freemobile-sms 是一个专为 Free Mobile 法国运营商用户设计的 SMS 发送技能。用户需先在 Free Mobile 官网(mobile.free.fr)的"Mes options"中启用"Notifications par SMS"功能,获取 API 密钥。配置环境变量 FREEMOBILE_SMS_USER(用户标识)和 FREEMOBILE_SMS_API_KEY 后,即可通过命令行调用 scripts/FreeMobile_sms.py 发送短信。典型使用场景包括:发送日程提醒、系统告警通知、待办事项提示等。脚本支持 --message 参数指定短信内容,,--timeout 参数控制 HTTP 请求超时(默认 10 秒)。

显著优点

安全性设计优秀:凭证完全通过环境变量管理,无硬编码风险;代码中未使用 eval/exec/subprocess/os.system 等危险函数;网络请求强制使用 HTTPS 加密传输。

功能透明可控:仅与 Free Mobile 官方 API(smsapi.free-mobile.fr)通信,目标固定;消息长度自动截断至 160 字符,防止滥用;内置超时机制避免长时间阻塞。

部署轻量便捷:仅依赖 Python 3 标准库(argparse、os、sys)和 requests 库,通过 Homebrew 即可快速安装;开源项目托管于 GitHub,代码完全可审计。

潜在缺点与局限性

运营商强绑定:仅限 Free Mobile 法国运营商订阅用户使用,其他运营商用户无法使用;需主动在官网开启 API 功能,门槛存在。

功能高度单一:仅能向用户自己的手机号码发送短信,不支持群发、不支持自定义收件人、不支持国际号码。

严格的使用配额:Free Mobile API 限制每天 200-250 条短信,单条 160 字符,两次发送间隔至少 10 秒——不适合高频通知场景。

语言与地域限制:文档和界面均为法语,对非法语用户不够友好;API 服务端位于法国,其他地区可能存在网络延迟。

适合的目标群体

  • Free Mobile 法国用户:已订阅该运营商且需要简单短信提醒的个人用户
  • 开发者与运维人员:希望为个人项目或家庭服务器添加低成本告警通知的技术用户
  • 隐私敏感用户:倾向于使用官方 API 而非第三方短信服务,避免数据外泄
  • 法语环境用户:能阅读法语文档,或仅需基础命令行操作的简单场景

使用风险

依赖项风险:需要 Python 3 和 requests 库,若环境未预装需手动配置;requests 版本过旧可能存在 TLS 兼容性问题。

API 可用性风险:Free Mobile 服务变更或 API 下线将导致技能失效;网络不稳定时短信可能发送失败。

配额耗尽风险:高频自动化脚本易触发日限额,需自行实现发送频率控制逻辑。

凭证管理风险:环境变量虽比硬编码安全,但若在多用户系统配置不当,仍存在被其他进程读取的可能。

安全解读

核心用法

freemobile-sms 是一个轻量级的 SMS 发送工具,专为 Free Mobile 法国运营商用户设计。用户配置环境变量 FREEMOBILE_SMS_USERFREEMOBILE_SMS_API_KEY 后,即可通过命令行或脚本调用向绑定手机号发送短信。典型用法如提醒日程、系统告警通知等场景,支持自定义超时参数(默认 10 秒)。

显著优点

  • 极简架构:仅 207 行 Python 代码,4 个文件,无冗余依赖
  • 安全凭证管理:敏感信息通过环境变量注入,零硬编码风险
  • 官方 API 直连:仅调用 Free Mobile 官方 HTTPS 端点,传输加密
  • 合规友好:通过 GDPR、CCPA 隐私合规检测
  • 透明开源:GitHub 可审计,作者 dClauzel 为活跃开发者

潜在缺点与局限性

  • 运营商锁定:仅限 Free Mobile 订阅用户,覆盖范围受限
  • 发送限制:每日 200-250 条上限,单条 160 字符,两次发送间隔 ≥10 秒
  • 单向通信:仅支持发给自己绑定的号码,无回复能力
  • 地域限制:服务主要针对法国本土用户
  • 无消息状态回执:无法确认短信是否送达

适合人群

  • Free Mobile 用户在法国的个人自动化工作流
  • 需要轻量级服务器告警通知的开发者
  • 追求隐私优先、不愿依赖第三方推送服务的用户
  • 法语区 IoT 项目或家庭自动化场景

常规风险

  • API 密钥泄露:环境变量若被其他进程读取可能导致滥用
  • 依赖供应链:requests 库虽可信,但仍需关注其安全更新
  • 网络可用性:依赖 Free Mobile 基础设施,服务中断时失效
  • 消息截断:超长内容自动截断可能导致信息不完整

freemobile-sms 内容

references文件夹
scripts文件夹
手动下载zip · 3.8 kB
REFERENCE.mdtext/markdown
请选择文件