heypocket-reader

name	heypocket-reader
description	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.

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

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:

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