创建一个包含您的 Foursquare Swarm 签到历史的 SQLite 数据库。

$ pip install swarm-to-sqlite

您首先需要获取 Foursquare 账户的有效 OAuth token。您可以使用此工具来获取：https://your-foursquare-oauth-token.glitch.me/

最简单的用法是直接提供您希望写入的数据库文件名。该工具将提示您粘贴 token，然后下载您的签到信息并将其存储到指定的数据库文件中。

$ swarm-to-sqlite checkins.db
Please provide your Foursquare OAuth token:
Importing 3699 checkins  [#########-----------------------] 27% 00:02:31

您也可以将 token 作为命令行选项传递

$ swarm-to-sqlite checkins.db --token=XXX

或作为环境变量传递

$ export FOURSQUARE_TOKEN=XXX
$ swarm-to-sqlite checkins.db

要只检索过去 X 小时、天或周内的签到信息，请使用 --since= 选项。例如，要仅拉取过去 10 天内发生的签到信息，请使用

$ swarm-to-sqlite checkins.db --token=XXX --since=10d

使用 2w 表示两周，10h 表示十小时，3d 表示三天。

除了将签到信息保存到数据库外，您还可以使用 --save 选项将它们写入 JSON 文件

$ swarm-to-sqlite checkins.db --save=checkins.json

完成此操作后，您可以直接从该文件重新导入签到信息（而不是通过 API 调用从 Foursquare 获取数据），像这样

$ swarm-to-sqlite checkins.db --load=checkins.json

此工具生成的 SQLite 数据库旨在通过 Datasette 进行浏览。

您可以安装 datasette-cluster-map 插件以在地图上查看您的签到信息。