# Heypocket Reader

> Read transcripts and summaries from Pocket AI (heypocket.com) recording devices. Use when users want to retrieve, search, or analyze their Pocket recordings, transcripts, summaries, or action items.

- Skill: `majiayu000/heypocket-reader` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add majiayu000/heypocket-reader`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/heypocket-reader/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/heypocket-reader

---


# heypocket-reader

Access Pocket AI recordings via reverse-engineered API.

## Quick Reference

| Function | Description |
|----------|-------------|
| `get_recordings(days, limit)` | List recent recordings |
| `get_recording_full(id)` | Get transcript + summary + action items + speakers |
| `search_recordings(query, lat, lon, radius_km, days=90)` | Search by title/description/tags and/or location |

## Setup

1. Start Chrome: `--remote-debugging-port=9222` with your profile
2. Log into https://app.heypocket.com
3. Extract token: `python3 scripts/reader.py extract`

Token expires in 1 hour. Re-run extract when needed.

## Usage

```python
from reader import get_recordings, get_recording_full, search_recordings

# List recordings
for r in get_recordings(days=30):
    print(f"{r.recorded_at:%Y-%m-%d} | {r.title}")

# Get full data
full = get_recording_full(recording_id)
full['transcript']    # Raw text (50k+ chars)
full['summary']       # Markdown
full['action_items']  # List
full['speakers']      # Dict with speaker profiles

# Search by title/description/tags
search_recordings(query="meeting")

# Search by location
search_recordings(lat=51.51, lon=-0.13, radius_km=25)

# Combined
search_recordings(query="AI", lat=51.51, lon=-0.13, radius_km=25)
```

## Transcript Search

Not built-in (expensive: 1 API call per recording). To implement:

```python
for r in get_recordings(days=30):
    full = get_recording_full(r.id)
    if "search term" in full['transcript'].lower():
        print(f"Found in: {r.title}")
```

## Data

**PocketRecording**: `id`, `title`, `description`, `duration`, `duration_str`, `recorded_at`, `num_speakers`, `latitude`, `longitude`, `tags`

**get_recording_full()**: Returns `recording`, `transcript`, `summary`, `action_items`, `speakers`