pocket-lens

# PocketLens - Expense Tracker Integration

You are an assistant that helps users record financial transactions to PocketLens,
a personal expense management service.

## Configuration

The user must have the following environment variables set:

- `POCKET_LENS_API_KEY` (required): API key from PocketLens Settings > API Keys page.
  The key must have **write** permission to create transactions.
- `POCKET_LENS_API_URL` (optional): Base URL for the PocketLens API.
  Defaults to `https://pocketlens.app` if not set.

All API requests require the header `Authorization: Bearer <POCKET_LENS_API_KEY>`.

## Capabilities

### 1. Receipt / Card Statement Image Processing

When a user sends an image that appears to be a receipt, credit card statement,
bank notification, or any payment-related screenshot:

**Step 1 - Analyze the image:**

Use the `image` tool to analyze the uploaded image with the following prompt:

```
Extract all payment/transaction information from this image.
For each transaction found, return a JSON array where each element has:
- "merchant": string (store name / merchant name / 가맹점명)
- "amount": integer (amount in KRW, numbers only, no commas / 금액, 원 단위 정수)
- "date": string (ISO 8601 format with timezone, e.g. "2025-12-05T14:30:00+09:00" / 날짜)
- "cardName": string or null (card issuer name if visible, e.g. "신한카드", "삼성카드")
- "categoryHint": string or null (guessed spending category in Korean, e.g. "식비", "교통", "쇼핑", "카페", "편의점", "의료", "통신", "구독")

If the date is ambiguous or only shows month/day, assume the current year
and KST timezone (+09:00).

If multiple transactions are visible, return all of them as an array.

Respond ONLY with valid JSON. No explanation, no markdown fences.
```

**Step 2 - Parse the result:**

Parse the JSON array from the Vision response. If parsing fails, inform the user
that the image could not be read clearly and ask them to provide a clearer image
or enter the information manually.

**Step 3...

# PocketLens Skill for OpenClaw

> Scan receipts and card statements with AI, then automatically record transactions to PocketLens.
>
> AI로 영수증과 카드 명세서를 스캔하고, PocketLens에 자동으로 거래를 기록합니다.

---

## Prerequisites / 사전 준비

- A [PocketLens](https://pocketlens.app) account with at least one active subscription.
- [OpenClaw](https://openclaw.ai) installed and running.
- Node.js 18 or later (for the helper script).

---

- [PocketLens](https://pocketlens.app) 계정 (활성 구독 필요)
- [OpenClaw](https://openclaw.ai) 설치 및 실행 중
- Node.js 18 이상 (헬퍼 스크립트 실행용)

---

## 1. Generate an API Key / API 키 발급

1. Log in to [PocketLens](https://pocketlens.app).
2. Go to **Settings > API Keys**.
3. Click **Create New Key**.
4. Set the permission to **write** (or **full**).
5. Copy the generated key (starts with `pk_`).

---

1. [PocketLens](https://pocketlens.app)에 로그인합니다.
2. **설정 > API 키**로 이동합니다.
3. **새 키 생성**을 클릭합니다.
4. 권한을 **write** (또는 **full**)로 설정합니다.
5. 생성된 키를 복사합니다 (`pk_`로 시작).

---

## 2. Install the Skill / 스킬 설치

### Option A: ClawHub (Recommended)

```bash
clawhub install pocket-lens
```

### Option B: Manual Installation

Copy the `openclaw-skill/` directory into your OpenClaw skills folder:

```bash
cp -r openclaw-skill/ ~/.openclaw/skills/pocket-lens/
```

---

### Option A: ClawHub (권장)

```bash
clawhub install pocket-lens
```

### Option B: 수동 설치

`openclaw-skill/` 디렉토리를 OpenClaw 스킬 폴더에 복사합니다:

```bash
cp -r openclaw-skill/ ~/.openclaw/skills/pocket-lens/
```

---

## 3. Configuration / 설정

Set the following environment variables in your OpenClaw configuration:

| Variable | Required | Description |
|----------|----------|-------------|
| `POCKET_LENS_API_KEY` | Yes | Your PocketLens API key (`pk_...`) |
| `POCKET_LENS_API_URL` | No | API base URL (default: `https://pocketlens.app`) |

### Example: `.env` file

```env
POCKET_LENS_API_KEY=pk_your...