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

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

getrecordingfull(): Returns recording, transcript, summary, action_items, speakers

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: tmustier
• Source: tmustier/heypocket-reader
• License: MIT

Install and usage instructions live in the source repository linked above.