Snap Scraper

描述

Snap Scraper 是一款开源情报工具，能根据一组经纬度坐标下载上传至 Snapchat Snap Map 的媒体内容。本项目绝不与 Snap 公司或任何其附属机构、子公司有关联、授权、维护、赞助或认可。本程序仅用于教育、取证及错误报告目的，且不提供任何担保。

使用本工具时请引用以下出版物：

1. Richard Matthews, Kieren Lovell, Matthew Sorell, Ghost protocol – Snapchat as a method of surveillance, Forensic Science International: Digital Investigation, Volume 36, Supplement, 2021, 301112, ISSN 2666-2817, https://doi.org/10.1016/j.fsidi.2021.301112。

截图

</img src=""> </img src=""> </img src=""> </img src=""> </img src="">

安装

MacOS

下载最新发行版中附带的当前链接二进制文件。使用终端确保修改权限以包含可执行权限。

chmod 755 SnapScraper

此外，附带的 icon.png 文件可用于更改下载可执行文件的图标。

Windows/Linux

目前 SnapScraper 仅支持 MacOS。不过，依赖项已检查，用户应能自行在其文件系统上编译代码而不会出现问题。确保已安装 Alamofire。

使用方法

双击 SnapScraper 启动命令行工具。当默认窗口大小设置为 80x50 时，SnapScraper 效果最佳。

您应会看到以下窗口：

当前可用选项显示在命令窗口中。通过按键盘上相应按键并按回车键选择选项。

检查

用户最常选择的主要选项是检查选项，用于在 Snap Map 上定位快照媒体。要选择此选项，请键入 'c' 然后按回车键。

随后 SnapScraper 将要求您提供一组经纬度坐标，这些坐标可从 map.snapchat.com 获取，如出版物 “Richard Matthews, Kieren Lovell, Matthew Sorell, Ghost protocol – Snapchat as a method of surveillance, Forensic Science International: Digital Investigation, Volume 36, Supplement, 2021, 301112, ISSN 2666-2817, https://doi.org/10.1016/j.fsidi.2021.301112。” 中所述。导航至 map.snapchat.com 并记下您希望提取快照媒体的位置 URL，例如 _https://map.snapchat.com/@24.931153,44.873214,6.04z_。要输入至 SnapScraper 的坐标位于 URL 中 @ 符号之后。第一个数值是纬度，第二个是经度，最后一个是缩放级别。纬度与经度应输入至 6 位小数，缩放级别应输入至 2 位小数。

当每个坐标输入程序后，SnapScraper 将在所需位置轮询 Snap Map 以查找快照媒体。当找到媒体时，媒体的元数据将打印到命令窗口中。

随后用户将获得选项，是否将媒体的直接链接打印到命令窗口中。选择 y 则打印这些链接到命令窗口，选择 n 则跳过。

随后用户将获得选项，是否将链接保存到文本文件。选择 y 则保存文件，选择 n 则跳过。文件将保存在用户的“下载”目录下一个名为“Snapchat”的文件夹中（仅限 macOS 用户）。文件名以当前日期、时间和提取坐标命名，并以单词“listing”为前缀。

最后，系统将询问用户是否要下载媒体。这是提取步骤，媒体将直接从先前步骤中指出的 URL 保存。选择 y 则下载，选择 n 则跳过。媒体将保存在一个以当前日期、时间和提取坐标命名的文件夹中，该文件夹位于之前标识的“Snapchat”文件夹内。

日志报告

目前 0.5.0-b 版本尚未实现日志报告功能。要保存提取方法的日志，请使用终端内置的“导出文本为”功能。

按上述步骤完成提取过程，然后通过选择“q”退出 SnapScraper。终端会话将结束，但窗口将保持打开状态，如下所示。

要保存活动日志，请导航至“Shell -> 导出文本为...”。将弹出一个保存对话框。导航至用户“下载”文件夹中的“Snapchat”文件夹，并找到最近保存的 URL 列表（如果前一步骤使用了）。点击此文件，更改保存文件名为“listing”前缀改为“log”。这将保存一个包含终端窗口内容的文本文件，并显示运行 SnapScraper 时的所有活动。

其他选项

SnapScraper 具有完整的功能菜单。其他选项包括显示 MIT 许可证、与当前工具版本相关的出版物信息、支持持续开发与维护的信息以及当前开发日志。要访问，请按相应选项键然后按回车键。

贡献

SnapScraper 源于 2017 年在爱沙尼亚塔林的一次讨论。本着当初合作的精神，我非常希望您能帮助实现该项目的全部愿景。Wiki 中包含了代码库的路线图，其中包括未来功能的愿望清单。

欢迎提交拉取请求。对于重大更改，请先打开一个问题讨论您希望更改的内容。

请确保相应更新测试。

捐赠

欢迎捐赠以支持本产品的持续开发、维护和更新。

使用门罗币捐赠： 41hZLF5Mhh7gDeiTLLws8dXMsi9NpyM6cWUQJoTJNAWkbx4YccDagRMWYED4cyHw481VjYyiEgkEh9mxHR1tJeNy7ce9yNp

资金目标包括：

• 托管 SnapScraper 网页版所需的服务器。
• 支持 Windows 文件系统。
• 对下载媒体进行过滤，标记 NSFW 内容（分诊）。
• 按地理围栏和时间自动抓取。
• 长期数据存储，支持历史、社会学及其他研究领域（类似 Internet Archive，但专为 Snapmap 设计）。

贡献者

项目负责人

• Richard Matthews

自动内容审核团队

• Matthew Sorell
• Sanjana Tanuku
• Siyu Wang
• Liyu Xu

致谢

• Ben Agnew - 感谢 2019 年 CSRB 期间的开发者模式讨论！
• Kieren Lovell - 扫雷大师。
• Matthew Sorell - 取证及其他。

使用的仓库

• Alamofire - https://github.com/Alamofire/Alamofire

出版物

1. Richard Matthews, Kieren Lovell, Matthew Sorell. "Ghost protocol – Snapchat as a method of surveillance", Forensic Science International: Digital Investigation, Volume 36, Supplement, 2021, 301112, ISSN 2666-2817, https://doi.org/10.1016/j.fsidi.2021.301112。
2. Richard Matthews. "Snapchat Disclosed on HackerOne: CreatorID Leaked from Public Content Posted to SnapMaps", May 7, 2020. 访问日期：November 06, 2021。https://hackerone.com/reports/867521。

许可证

MIT (c) 2020 Dr Richard Matthews

免责声明

本项目绝不与贡献者部分中提及人员的教育机构有关联、关联、授权或认可。这些机构包括但不限于澳大利亚阿德莱德大学和塔林理工大学（TalTech）。

本项目绝不与 Snapchat、Snap 公司或其任何子公司、附属机构有关联、关联、授权、认可或以任何方式正式连接。Snapchat 官网位于 http://www.snapchat.com。

Snap、Snap Map 和 Snapchat 等名称以及相关名称、标志、徽章和图像均为其各自所有者的注册商标。

所有名称、徽标、图像和品牌均为其各自所有者的财产。

本工具按“原样”提供，仅用于教学目的，不提供任何担保。任何使用均未经授权或暗示。