mdldm-maitian — 複数SNSの一括投稿管理とデータ監視を行う自メディア運用ツール
CzzzzzzJ/mdldm-maitian
★ 1,076 ・ JavaScript ・ MIT
概要
個人や少人数のクリエイターが動画やテキストコンテンツを複数のSNSや動画プラットフォームに展開する際、プラットフォームごとに異なる文面やサムネイルの指定、投稿後の反響計測、コンバージョン管理など、多大な作業負荷が発生します。
「mdldm-maitian(麦田)」は、こうした運用作業を一元化するために開発された自メディア向けコントロールセンターです。YouTube、X(旧Twitter)、Instagramのほか、中国系主要プラットフォーム(Bilibili、Douyin、小紅書、WeChat動画号)へのコンテンツ配信計画の管理、フォーム自動入力、投稿後の再生回数やフォロワー数の定期収集、Webダッシュボード表示、Feishu(飛書)を通じたステータス通知をまとめて担います。常時稼働するマシン上の専用ブラウザを介して動作し、アカウントのパスワードをシステム側に保持しない設計となっています。
主な特徴
-
複数プラットフォームへの配信パイプライン管理 1本の完成動画から各SNS向けのテキストやサムネイル、公開日時を指定し、バッチ単位で投稿準備を進められます。プラットフォームごとの重複投稿防止機能も備えています。
-
リスクを考慮したハイブリッド投稿制御 X、YouTube、Instagramなどでは設定値の自動検証と送信をワンストップで行う一方、アカウント制限のリスクが高い一部のプラットフォームではフォームの自動入力のみを行い、最終的な公開ボタンはユーザーが手動で押すフローを採用しています。
-
定期的なデータ収集と分析ダッシュボード 公開したコンテンツの再生回数、インタラクション数、各プラットフォームのフォロワー数を定期的にスクレイピングしてローカルデータベースに蓄積し、Web画面やFeishuのカード通知で振り返りレポートを確認できます。
-
独自のWebサイトとのコンバージョン連携 URLに付与されたトラッキングパラメーター(UTMパラメーター)と自前WebサイトのAPIを連携させることで、動画コンテンツ経由のユーザー登録や収益の発生状況を追跡できます。
-
モバイル環境からの監視とアクセス Feishu通知による進捗把握のほか、Cloudflare Tunnel経由でのリモートアクセス認証、iOSのScriptableアプリを利用したホーム画面・ロック画面ウィジェットへの数値表示に対応しています。
使い方
必要環境
- macOS(またはコミュニティ提供のWindows 10/11対応スクリプト)
- Node.js 22.5以上(組み込みの
node:sqliteを利用するため) - Google Chrome
自動インストール
macOS向けには以下のワンラインスクリプトが用意されています。
bash -c "$(curl -fsSL https://raw.githubusercontent.com/CzzzzzzJ/mdldm-maitian/main/scripts/install.sh)"
このスクリプトは本体とプラグインを ~/maitian/ にダウンロードし、セットアップウィザードを起動して設定ファイルの作成や起動時自動実行(launchd)の設定を行います。
Windows向けにはPowerShell用のスクリプトが提供されています。
powershell -ExecutionPolicy Bypass -Command "irm https://raw.githubusercontent.com/CzzzzzzJ/mdldm-maitian/main/scripts/install-windows.ps1 | iex"
手動でのセットアップ
手動で環境を構築する場合は、リポジトリをクローンして付属スクリプトを実行します。
git clone https://github.com/CzzzzzzJ/mdldm-maitian.git && cd mdldm-maitian
node src/demo.mjs # ダミーデータでダッシュボードを確認 (http://localhost:8788/?key=demo)
node src/init.mjs # 対話形式のインストールウィザードを実行
node src/hub.mjs doctor # 各プラットフォームのログイン状態と投稿ページの疎通確認
セットアップウィザード完了後、指定されたURL(例: http://localhost:8787/?key=)をブラウザで開くことでダッシュボードへアクセスできます。
主な運用コマンド
src/hub.mjs を通じて様々な運用操作を行います。
node src/hub.mjs plan [工程ディレクトリ] # 配信計画への登録
node src/hub.mjs run <工程ディレクトリ> # 対象コンテンツの投稿処理を実行
node src/hub.mjs status [id] # 進捗状況の確認
node src/hub.mjs sync <id> # 公開URLの取得と記録の反映
node src/hub.mjs metrics [id] # 再生数などの指標を収集し日報を送信
node src/hub.mjs followers # 全プラットフォームのフォロワー数を取得
node src/hub.mjs daemon # 常駐プロセスの起動
運用の成熟度に応じて、まずは「データ閲覧のみ(L1)」から開始し、次に「一括配信設定(L2)」、最終的に「自前サイトとのコンバージョン連携(L3)」と段階的に機能を拡張していく構成が推奨されています。
技術的なポイント
アーキテクチャと制御方式
mdldm-maitianは、常時起動マシン上で動作するNode.jsデーモン(src/hub.mjs)を中心に構築されています。
- Chrome DevTools Protocol(CDP)によるブラウザ制御: 専用プロファイルで起動したGoogle Chromeに対し、CDPポート(デフォルト: 9333)経由で接続します。ログインセッションはユーザーが専用Chrome側で保持するため、mdldm-maitian本体の設定ファイルには各SNSの生パスワードを保存しません。
- Chrome拡張機能との分離: 各プラットフォームのDOM構成変更やアップロードフォームの操作ロジックはChromeウェブストアで配布されている拡張機能(麦田发布助手)に集約されています。本体側は
src/chrome-shim.mjsを用いてNode.js環境下でChrome拡張APIをエミュレートし、拡張機能のエンジンを直接読み込んで実行します。 - SQLiteによるステータス管理: Node.js 22.5から標準搭載された
node:sqliteを利用し、外部のDBMSサーバーを立てることなくローカルのdata/hub.dbに配信ステータスや過去の指標データを保存しています。 - Webサーバーと通知機能:
src/web.mjsがポート8787で内蔵ダッシュボードを提供し、src/feishu.mjsがFeishuのグループボットへカード形式の通知(配信進捗、エラー、手動ボタン押下待ち、日報)を送信します。
投稿バリデーションと実戦的な対策
Markdown形式の原稿から publish.json を生成する際、文字数、NGワード、サムネイル比率、動画ファイルの構造チェック(moov atomがファイル先頭にある「faststart」形式かどうかの検証)などを自動で実施します。動画ファイルのメタデータ配置に起因するアップロードエラーを事前に防ぐ工夫が施されています。
注意点
- ライセンス: 本プロジェクトのソースコードはMITライセンスに基づいて公開されています。
- プラットフォーム制限とアカウントリスク: 一部のプラットフォーム(小紅書など)では、API直接呼び出しを避け、人間による操作に近い低頻度なスクロールやクリック動作に留めるなど対策が取られていますが、自動化ツールの利用自体が各SNSの利用規約やアカウント監視基準に抵触するリスクは常に伴います。国内系プラットフォームで手動送信を残しているのはこのリスクを緩和するための設計です。
- 環境依存性: 公式スクリプトや常駐設定(launchd)はmacOSを主軸に設計されています。Windows環境への対応はコミュニティ提供のスクリプトによるものであり、タスクスケジューラを手動で設定する必要があるなど一部制限が存在します。
- 外部サービス連携の前提: Feishu通知やCloudflare Tunnelによるリモート認証、自前サイトとのコンバージョン測定を利用するには、それぞれのサービス側での設定や追加のアカウント構築が必要になります。
まとめ
mdldm-maitianは、複数プラットフォームにわたるコンテンツ配信とデータ集計を効率化するためのセルフホスト型管理基盤です。ブラウザ自動操作と人手による最終確認を組み合わせた現実的なワークフローを採用しており、日々の投稿作業やデータ追跡を自動化したいクリエイターにとって参考になる実装となっています。





