# 브라우저 확장 프로그램

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 키는 브라우저 저장소에 보관되며, `api.pocketalert.app`과 통신하는 데만 사용돼요. 다른 곳으로는 아무것도 전송되지 않아요.

> **Tip: 별도의 키를 사용하세요**
>
> 서버에서 쓰는 API 키 대신 확장 프로그램 전용 API 키를 만들어 사용하세요. 노트북을 다른 사람에게 넘기거나 여러 기기에서 프로필을 동기화하는 경우에도 해당 키만 폐기할 수 있어요.

## 권한과 필요한 이유

| 권한 | 사용 목적 |
|------|----------|
| `storage` | API 키, 설정, 저장되지 않은 임시 메시지를 로컬에 보관 |
| `alarms` | 새 메시지를 확인하는 백그라운드 폴링 일정 관리 |
| `notifications` | 데스크톱 알림 표시 |
| `host_permissions` for `api.pocketalert.app` | Pocket Alert API 호출 — 그 외 용도로는 사용하지 않음 |

광범위한 호스트 접근 권한은 요청하지 않아요. 확장 프로그램은 사용자가 방문한 페이지의 내용을 읽을 수 없어요.

## 관련 문서

- [CLI](https://info.pocketalert.app/cli.md) — 터미널에서 같은 작업을 수행하는 방법
- [메시지 생성](https://info.pocketalert.app/api/messages/create.md) — 확장 프로그램이 호출하는 API
