Heypocket Reader
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.md
Full skill instructions
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
- Start Chrome:
--remote-debugging-port=9222with your profile - Log into https://app.heypocket.com
- 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