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.
Security Assessment
About heypocket-reader
The heypocket-reader skill provides users with programmatic access to recordings, transcripts, summaries, and action items from Pocket AI (heypocket.com) devices. It solves the challenge of efficiently retrieving and managing audio content from multiple recordings, allowing users to process and analyze their meetings or conversations without manually navigating the Pocket AI interface. By leveraging a reverse-engineered API, the skill enables direct access to both metadata and full recording content, streamlining workflows for professionals who rely on detailed audio documentation.
Key features of heypocket-reader include listing recent recordings, retrieving full recording data including transcripts, summaries, action items, and speaker profiles, and performing searches based on text queries or geographical location. While transcript search is not built-in due to the cost of multiple API calls, the skill provides a clear pattern for implementing custom search routines. The skill returns structured data objects like PocketRecording, containing attributes such as title, description, duration, timestamp, speaker count, location, and tags, which can be programmatically processed for reporting or analysis. It integrates seamlessly with Python, enabling scripting and automation for managing and querying recordings.
The skill is suitable for professionals, researchers, or teams who need to analyze meetings, interviews, or other audio sessions. Use cases include generating summaries of meetings, extracting action items for follow-up, monitoring discussions across multiple locations, and performing keyword searches across transcripts for research or compliance purposes. Target users are those who are comfortable with Python scripting and want to automate access to their Pocket AI recordings, such as project managers, data analysts, or knowledge workers who rely on efficient audio data management.
FAQ
How do I retrieve a list of recent recordings?
Use the get_recordings(days, limit) function in Python to list recordings from the past specified number of days. You can iterate over the results to access recording titles and dates.
Can I search recordings by location?
Yes, the search_recordings function allows searching by latitude, longitude, and radius in kilometers. You can combine location search with text queries for more targeted results.
What do I need to set up before using the skill?
You need to start Chrome with remote debugging, log into Pocket AI, and extract an API token using the provided script. The token expires after 1 hour, so you may need to re-run extraction periodically.
Is full transcript search built-in?
No, transcript search is not built-in due to API call costs. You can implement it by fetching full recordings and manually searching the transcript text.
What data is returned for a full recording?
get_recording_full() returns a dictionary containing the raw transcript, summary in Markdown, action items as a list, and speaker profiles as a dictionary.
Install heypocket-reader
Quick Setup:
- Copy the skill folder to
.claude/skills/ - Claude will automatically detect and use the skill
Repository
tmustier/heypocket-reader