biubiubiu
JA
GitHub デプロイ

オープンソース · Cloudflare で動作

あらゆる場所から、スマホへ直接プッシュ。

biubiubiu は Cloudflare Workers と D1 で動く、軽量なセルフホスト型 Web Push サーバーです。スクリプト、cron ジョブ、CI、AI エージェントから HTTP リクエストを 1 本送るだけでスマホに通知が届きます。サーバーの保守も、ネイティブアプリのインストールも不要です。

Cloudflare にデプロイ GitHub で見る

約 1 分でデプロイ完了。無料プランでも利用できます。

1 行で送信

HTTP リクエストを送れるなら、あなたに届けられる。

ちょっとした通知なら URL にデバイスキーを入れるだけ。JSON API ではトークン、デバイスグループ、Markdown、予約配信、エンドツーエンド暗号化、ボタン・自由入力・パスキー確認に対応した質問が使えます。Webhook テンプレートで GitHub、Grafana、Alertmanager をそのまま受け付け、緊急の通知は開くまで繰り返し届きます。

デバイスキーで手軽に GET
curl https://push.example.com/<deviceKey>/Backup%20done
API トークンで全デバイスに JSON を送信
curl -X POST https://push.example.com/api/send \
  -H "Authorization: Bearer $TOKEN" \
  -d '{"title":"Deploy","body":"v2.3.1 is live"}'
質問を送って回答を待つ
curl -X POST https://push.example.com/api/send \
  -H "Authorization: Bearer $TOKEN" \
  -d '{"title":"Deploy?","choices":["Ship it","Hold"]}'
緊急：開かれるまで再送
curl -X POST https://push.example.com/api/send \
  -H "Authorization: Bearer $TOKEN" \
  -d '{"title":"Prod down","level":"critical","retry":120}'

機能

小さなサーバーに、必要なものはすべて。

全プラットフォーム対応

iOS 16.4+（ホーム画面の Web アプリ）、Android、主要デスクトップブラウザ。アプリストアは不要です。

デバイス別のキー

デバイスごとに失効可能なキーを発行。スクリプト用のスコープ付き API トークンと、全体を管理するマスターキー。

柔軟な宛先指定

全体配信、デバイスグループ指定、特定デバイスへの個別送信に対応。

メッセージセンター

すべてのプッシュを保存。Markdown 描画、カテゴリ絞り込み、未読バッジ、TTL 有効期限に対応。

その場で上書き更新

同じ id を使えば、通知を積み重ねずに既存の通知を更新。ビルド進捗の表示に最適です。

予約配信

scheduledAt を指定してキューに追加すると、毎分実行される cron が時間どおりに配信します。

エンドツーエンド暗号化

Bark 互換の AES-CBC ペイロードを端末側で復号。サーバーが見るのは暗号文だけです。

信頼性の高い配信

自動リトライ、失効した購読の整理、購読の自己修復、デバイス別の配信ログ。

Webhook テンプレート

?template=github を付けるだけで GitHub、Grafana、Alertmanager の Webhook を直接受け取れます。Slack、Discord、ntfy に送れるツールもそのまま使えます。

確認されるまで再通知

critical のメッセージに retry を付けると、誰かが開くまで数分おきに再送します。

AI エージェントのために

ターミナルから離れても大丈夫。エージェントが呼んでくれます。

コーディングエージェントは、あなたが席を外している間に作業を終えたり、失敗したり、行き詰まったりします。biubiubiu はエージェントがあなたに連絡する手段と、あなたが答える手段を提供します。

MCP サーバー

/mcp の Streamable HTTP で、あらゆる MCP クライアントに send_notification ツールを提供。Claude Code にはコマンド 1 つで追加できます。

ask_human

エージェントが回答ボタンや返信欄付きの質問を送信。答えた瞬間にツール呼び出しが回答を返します。危険な選択肢は Face ID や Touch ID を必須にできます。

スキルとフック

Agent Skill がいつ通知すべきかをエージェントに教え、Claude Code のフックは停止や権限確認のたびに通知します。

Claude Code
claude mcp add --transport http biubiubiu \
  https://push.example.com/mcp \
  --header "Authorization: Bearer $BIUBIUBIU_TOKEN"
Agent Skill
npx skills add chada/biubiubiu --skill biubiubiu-notify
エージェントを設定する

アカウントモード

家族やチームで 1 台のサーバーを共有。

アカウントモードを有効にすると、各自が自分のアカウントでサインインし、次のものを利用できます。

  • 招待制で参加者を管理
  • 自分専用のデバイスと受信箱
  • スクリプト用の個人送信トークン
  • プッシュまたはメールでのパスワードリセット

任意の機能で、既定ではオフです。Workers 有料プランが必要です。オフのままなら、1 つのマスターキーで無料プランのまま動作します。

アカウントの仕組み

アプリ

ホーム画面に置ける受信箱。

「要対応」、日付ごとのセクション、グループ絞り込み付きの受信箱
エージェントからの質問にワンタップで回答
Markdown のメッセージを id でその場で更新

はじめる

3 ステップで自分のプッシュサーバーを。

  1. デプロイ

    ボタンを押すと、リポジトリを GitHub / GitLab にコピーし、D1 データベースの作成、マイグレーション、Worker のデプロイまで行います。

  2. マスターキーを設定

    管理者パスワード MASTER_KEY を入力します（例: openssl rand -base64 32）。VAPID キーは自動生成されます。

  3. スマホで開く

    アプリをホーム画面に追加し、通知を許可して、デバイスキーをコピー。最初の biu を送ってみましょう。

Deploy to Cloudflare

コマンドラインで行いたい場合は手動デプロイを参照してください。

よくある質問

よくある質問。

ほかにも気になることがあれば、GitHub で質問してください。

biubiubiu とは何ですか？

biubiubiu は、Cloudflare Workers と D1 でセルフホストする、無料でオープンソースの Web Push 通知サーバーです。スクリプト、cron ジョブ、CI パイプライン、AI エージェントから HTTP リクエストを 1 本送ると、標準の Web Push プロトコルでスマホ、タブレット、デスクトップに通知を届けます。

費用はかかりますか？

biubiubiu 自体は無料です。ご自身の Cloudflare アカウントで動作し、デフォルトのマスターキーモードは Workers の無料プランに収まります。オプションのアカウントモードだけは、パスワードのハッシュ化に無料プランを超える CPU 時間が必要なため Workers Paid が必要です。

アプリをインストールせずに iPhone で使えますか？

はい。iOS / iPadOS 16.4 以降では、Safari でサーバーを開いてホーム画面に追加し、通知を許可するだけです。Android とデスクトップでは、Chrome、Edge、Firefox、Safari がブラウザのままプッシュを受信できます。

Bark の代わりに使えますか？Android でも？

はい。biubiubiu は Bark の URL と JSON API のスタイルに従っているので、サーバーアドレスとデバイスキーを差し替えるだけで既存の Bark スクリプトや iOS ショートカットがそのまま動き、Android やデスクトップにも届くようになります。カスタムサウンドや重大な通知のアラーム音など、Web Push では実現できない Bark のオプションもありますが、緊急のメッセージは開くまで再通知できます。

Claude Code などの AI エージェントからどう通知されますか？

/mcp の MCP サーバーを任意の MCP クライアントに追加すると（Claude Code ならコマンド 1 つ）、エージェントは send_notification ツールと、回答ボタンや返信欄付きの質問を送り、答えた瞬間に結果を返す ask_human ツール（危険な回答はパスキーによる Face ID や Touch ID の確認を必須にできます）を使えるようになります。Agent Skill（npx skills add chada/biubiubiu でインストール）と Claude Code のフックも用意しています。

ntfy、Gotify、Pushover との違いは？

Pushover は有料のホスティングサービスで、セルフホストの ntfy や Gotify は稼働させ続けるサーバーが必要です。biubiubiu はご自身の Cloudflare アカウント上でサーバーレスに動くため、パッチ適用や常時稼働の手間がありません。ネイティブアプリなしで標準の Web Push で届き、AI エージェント向けの MCP サーバーも内蔵しています。ntfy に対応したツールはデバイスキーをトピックにしてそのまま送信でき、緊急のメッセージは Pushover の緊急優先度のように確認されるまで再通知されます。

通知の内容は誰が読めますか？

あなただけです。メッセージはご自身の Cloudflare アカウントの D1 データベースに保存されます。エンドツーエンド暗号化を有効にすると、内容は送信前に暗号化されデバイス上で復号されるため、サーバーには暗号文しか見えません。

ドキュメント

ドキュメントを読む。

API リファレンス

認証、すべてのエンドポイントとパラメーター、MCP、暗号化。

デプロイ

ローカル開発、シークレット、D1、カスタムドメイン、アカウントモード。

AI エージェント

MCP の設定、通知スキル、Claude Code のフック。

プラットフォーム別の注意点

iOS での設定と Web Push の制限。

詳細なドキュメントは英語です。 日本語の README を読む

はじめる

リクエスト 1 本で、スマホに届く。

自分だけのプッシュサーバーを約 1 分でデプロイ。無料でオープンソース、そしてあなたのものです。

Cloudflare にデプロイ GitHub で見る