# ブラウザ拡張機能

Pocket Alert 拡張機能を使うと、ブラウザのツールバーからプッシュ通知の受信箱を開けます。未読バッジ、デスクトップ通知、そして今開いているタブを離れずにプッシュ通知を送信できる作成ボックスを利用できます。

[Chrome ウェブストアからインストール](https://chromewebstore.google.com/detail/pocket-alert/hnknmapadalodjkmikfhjnmbbhpbhbdk)。Chrome と Edge で動作します。

## 主な機能

**受信箱。** 最近のメッセージをカード形式で表示し、未読のものには印が付きます。カードをクリックすると本文が展開され、既読になります。上部のチップでアプリケーションごとに絞り込めます。スクロールすると、古いメッセージも順次読み込まれます。

**送信。** タイトル、メッセージ、送信先のデバイスを指定します。すべてのデバイスに一斉送信することもできます。送信元を示すアプリケーションも選択できます。

**未読バッジとデスクトップ通知。** バックグラウンドワーカーが、設定した間隔で新着を確認します。新しいメッセージがあれば、ネイティブのデスクトップ通知を表示します。

**すべて既読にする。** 実際に未読メッセージがあるときだけ表示されます。

**テーマ。** ライト、ダーク、またはシステム設定に合わせて切り替えられます。ウェブアプリと同じデザイントークンを使用しています。

**下書きの保存。** 書きかけのメッセージは、ポップアップを閉じても保持されます。

## セットアップ

1. 拡張機能をインストールします。
2. [API キー](https://pocketalert.app/account/apikeys)で API キーを作成します。
3. 拡張機能のオプションを開き、キーを貼り付けて **接続テスト** を押します。
4. 同じ画面で、ポーリング間隔とページサイズを設定します。

キーはブラウザのストレージに保存され、`api.pocketalert.app` との通信にのみ使用されます。ほかの宛先に送信されることはありません。

> **Tip: 専用のキーを使う**
>
> サーバーで使っている API キーではなく、拡張機能専用の API キーを発行してください。ノートパソコンを他の人に渡したり、複数のマシンでプロファイルを同期したりする場合も、そのキーだけを無効化できます。

## 必要な権限とその理由

| 権限 | 用途 |
|------|------|
| `storage` | API キー、設定、未送信の下書きをローカルに保存する |
| `alarms` | 新着メッセージを確認するバックグラウンドのポーリングをスケジュールする |
| `notifications` | デスクトップ通知を表示する |
| `host_permissions`（`api.pocketalert.app`） | Pocket Alert API の呼び出しのみに使用する（それ以外には使用しない） |

広範囲のホストへのアクセス権はありません。拡張機能が閲覧中のページの内容を読み取ることはできません。

## 関連ページ

- [CLI](https://info.pocketalert.app/cli.md) — ターミナルから同じ操作を行う方法
- [メッセージを作成](https://info.pocketalert.app/api/messages/create.md) — 拡張機能が通信する API
