Smaug — Twitter/Xブックマークを自動でMarkdown保存するツール

ToolTwitterブックマーク自動化

alexknowshtml/smaug

GitHub で見る

GitHub →

概要

Smaugは、Twitter/X上で保存したブックマークを自動でMarkdown形式のファイルにエクスポートしてアーカイブするツールです。設定に沿ってAPIからブックマークを取得し、ツイート本文やリンク、メディア情報をMarkdownに整形、カテゴリごとにファイルを分けたり、メタデータ（日時・URL・Tweet IDなど）を付与して出力します。定期実行やCI（例：cronやGitHub Actionsなど）に組み込んで自動化でき、Claudeによる補助的な分類や要約を組み合わせることで、手動での整理を減らすことも可能です。軽量なNode.js/JavaScript実装で、設定ファイルとTwitterの認証情報を用意すれば短時間で運用を開始できます。

GitHub

リポジトリの統計情報

  • スター数: 91
  • フォーク数: 10
  • ウォッチャー数: 91
  • コミット数: 5
  • ファイル数: 8
  • メインの言語: JavaScript

主な特徴

  • Twitter/Xのブックマークを定期的に取得してMarkdownファイルに自動出力
  • 出力ファイルにメタデータを付与し、カテゴリ別やタグ別の整理が可能
  • 自動化（cron / CI）に向けた実行フローとサンプルを提供
  • Claude（AI）連携のオプションで要約や分類を自動化できる拡張性

技術的なポイント

SmaugはJavaScript（Node.js）で実装されたツールで、Twitter/XのAPIを利用してユーザーのブックマークを取得し、Markdown形式に整形して保存するというシンプルな処理パイプラインが中心です。セットアップではTwitterデベロッパー向けの認証情報（APIキーやBearerトークンなど）を用意し、これを環境変数や設定ファイルに渡してAPIコールを行います。取得したデータはツイート本文、投稿日時、URL、メディアリンク、Tweet IDなどの情報を抽出してMarkdownへ変換し、YAMLフロントマターや見出しを付けて人間にも読みやすく保存します。

設定は柔軟で、エクスポートするフィールドやカテゴリ判定ルール、保存先ディレクトリ、ファイル命名規則などを変更できます。READMEの「Categories」「Configuration」セクションが用意されているため、カテゴリごとの仕分けやキーワードベースの振り分けが可能です。実行の自動化は、ローカルのcronジョブやCIツール（例：GitHub Actions）へ組み込むことを想定した設計になっており、定期的に実行して差分をコミットしていくワークフローに適しています。

また「Claude Code Integration」としてAIを組み合わせる仕組みがあり、取得したブックマークに対して自動で要約を作成したり、タグ付け・カテゴリ分類の補助を行うことができます。これにより大量のブックマークの整理負荷を下げ、検索性・可読性を高められます。運用上は、APIのレート制限や失敗時のリトライ、ログ出力による監視、保存先のバックアップ（例：Gitで履歴管理）を組み合わせると堅牢になります。コードはモジュール化されており、必要に応じて出力テンプレートのカスタマイズや他サービスへの転送（静的サイトジェネレータやノートアプリ連携）も比較的容易です。

プロジェクトの構成

主要なファイルとディレクトリ：

  • .claude: dir
  • .gitignore: file
  • LICENSE: file
  • README.md: file
  • examples: dir

…他 3 ファイル

まとめ

Twitter/Xのブックマークを手軽にMarkdownで長期保存・整理できる実用的なツール。

リポジトリ情報：

READMEの抜粋：

Smaug 🐉

Archive your Twitter/X bookmarks to markdown. Automatically.

Like a dragon hoarding treasure, Smaug collects the valuable things you bookmark.

Contents

関連記事

Tool

x-bookmarks — Xブックマークをエージェントアクションに変換するスキル

X（旧Twitter）のブックマークを単なる「読む予定」から実際の作業につなげるための軽量スキルです。Claude Code と OpenClaw に対応したスキル定義とシェルスクリプト群で、ブックマークを取得・要約・分類し、実行可能なエージェントアクション（タスク提案や実行コマンド）に変換します。個人の知見活用を自動化し、情報の埋もれを防ぐことを目的としています（約300字）。

ブックマークエージェント自動化
Tool

AetherSwap — Steam 低価格バランス自動化アシスタント

AetherSwap は「全自動・ゼロコード」設定で Steam の低価格アイテムを自動で購入・出品し、残高運用を支援するツールです。クロスリージョン購入・市場分析・データ復盤・可視化ダッシュボードを備え、数学モデルに基づくスマートな選品ロジックで買付から自動出品まで無人運用を目指します。バックエンドは FastAPI、実行環境は Python 3.10+ を想定し、モニタリングや戦略調整を Web コンソールから行える設計です。（約300字）

Steam自動化FastAPI
Tool

Maps Call Assistant（my-caller）

Google Mapsで店舗を検索し、条件に基づいて評価・順位付けしたうえで、実際に電話で問い合わせを行うワークフローのプロトタイプ。ローカルのExpressサーバと最小限のUI、Playwrightを使ったGoogle Mapsの検索・取得ロジックを備え、営業・予約・在庫確認などの一般的な問い合わせを自動化するための設計を示します。規制対象品目の探索には使わないよう注意喚起があります。

自動化GoogleMapsTypeScript
Tool

Any Auto Register（多プラットフォーム自動アカウント登録）

多プラットフォームのアカウントを自動で作成・管理するためのPython製ツール。プラグイン方式で新しいプラットフォーム／メールサービス／キャプチャ解決器を追加でき、API実行・ヘッドレス／有頭ブラウザ実行を切り替え可能。プロキシプール管理や並列実行、SSEによるリアルタイムログなど運用に便利な機能を備え、学習・研究目的で提供されている。

自動化アカウント管理Python
Tool

git-hook — Gitフック自動ビルドスクリプト

git-hook は Git のフックを利用して、自動 pull（自動更新）と自動コンパイル（ビルド）を行う軽量なスクリプト群です。ローカルやサーバー上でコミット／マージ後に自動でビルド処理を走らせることで、手動ビルドの工数削減や早期のビルド失敗検出を実現します。設定は build-config で管理され、Python 製の実行スクリプト（build-on-hook.py）をフックから呼び出してビルドコマンドを実行するシンプルな構成です。

git自動化Python
Tool

台湾学生向け無料特典トラッカー

台灣大專院校の `.edu.tw` メールアドレスを持つ学生向けに設計された「無料特典追跡ツール」です。Anthropic の Claude Code スキルとクロスプラットフォームなリマインダー機能を組み合わせ、GitHub Copilot、JetBrains、Azure、Figma など 37 件以上の無料サブスクリプションを検出・整理・追跡します。年間総額4,400ドル以上に相当するオファーを体系化し、取得手順や期限管理をサポートすることで、学生が見逃さずに特典を活用できるようにします（英中両語ドキュメントあり）。自動化スクリプトは主に PowerShell ベースで構成されています。

学生自動化リマインダー