Pp Podcastindex

<!-- GENERATED FILE — DO NOT EDIT.
     This file is a verbatim mirror of library/media-and-entertainment/podcastindex/SKILL.md,
     regenerated post-merge by tools/generate-skills/. Hand-edits here are
     silently overwritten on the next regen. Edit the library/ source instead.
     See the repository agent guide, section "Generated artifacts: registry.json, cli-skills/". -->

PodcastIndex — Printing Press CLI

Prerequisites: Install the CLI

This skill drives the podcastindex-pp-cli binary. You must verify the CLI is installed before invoking any command from this skill. If it is missing, install it first:

1. Install via the Printing Press installer. It defaults binaries to $HOME/.local/bin on macOS/Linux and %LOCALAPPDATA%\Programs\PrintingPress\bin on Windows:

   npx -y @mvanhorn/printing-press-library install podcastindex --cli-only

2. Verify: podcastindex-pp-cli --version
3. Ensure the reported install directory is on $PATH for the agent/runtime that will invoke this skill.

If the npx install fails (no Node, offline, etc.), fall back to a direct Go install (requires Go 1.26.6 or newer). This installs into $GOPATH/bin (default $HOME/go/bin), so add that directory to $PATH instead:

go install github.com/mvanhorn/printing-press-library/library/media-and-entertainment/podcastindex/cmd/podcastindex-pp-cli@latest

If --version reports "command not found" after install, the runtime cannot see the binary directory on $PATH. Do not proceed with skill commands until verification succeeds.

Every existing PodcastIndex tool is a language SDK that mirrors the endpoints and returns raw JSON in-process. This CLI adds a local SQLite mirror, full-text search over synced shows and episodes, agent-native output, and compound commands no wrapper has: tgrep searches inside transcripts, cadence and dead-watch reason over publish history, guest-graph joins people across feeds.

When to Use This CLI

Use this CLI when an agent or user needs to discover podcasts, resolve a show to its episodes, or analyse podcast metadata, publish cadence, guests, value4value splits, or transcript content from the PodcastIndex database. It is the right tool when offline reuse, full-text search, or cross-feed analysis matters.

Anti-triggers

Do not use this CLI for:

• Do not use this CLI to download or play audio files; it returns enclosure URLs, not media.
• Do not use it to add or manage feeds in PodcastIndex; the add/* endpoints need publisher auth and are out of scope.
• Do not use it for Apple Podcasts-only metadata beyond the iTunes lookup passthrough.

Unique Capabilities

These capabilities aren't available in any other tool for this API.

Mine data wrappers ignore

• tgrep — Search inside actual episode transcripts, not just titles and descriptions.

  Reach for this when the user wants what was said in episodes, not show metadata.

  podcastindex-pp-cli tgrep "jepa" --cat Technology --agent

Command Reference

categories — Categories used by the Podcast Index

• podcastindex-pp-cli categories — Return all the possible categories supported by the index. Example: https://api.podcastindex.org/api/1.

episodes — Find details about one or more episodes of a podcast or podcasts.

• podcastindex-pp-cli episodes byfeedid — This call returns all the episodes we know about for this feed from the PodcastIndex ID.
• podcastindex-pp-cli episodes byfeedurl — This call returns all the episodes we know about for this feed from the feed URL.
• podcastindex-pp-cli episodes byguid — Get all the metadata for a single episode by passing its guid and the feed id or URL.
• podcastindex-pp-cli episodes byid — Get all the metadata for a single episode by passing its id. Example: https://api.podcastindex.org/api/1.
• podcastindex-pp-cli episodes byitunesid — This call returns all the episodes we know about for this feed from the iTunes ID.
• podcastindex-pp-cli episodes bypodcastguid — This call returns all the episodes we know about for this feed from the [Podcast GUID](https://github.
• podcastindex-pp-cli episodes live — Get all episodes that have been found in the [podcast:liveitem](https://github.
• podcastindex-pp-cli episodes random — This call returns a random batch of episodes, in no specific order. Examples: - https://api.podcastindex.org/api/1.

find — Manage find

• podcastindex-pp-cli find search — Replaces the Apple search API but returns data from the Podcast Index database.
• podcastindex-pp-cli find search-byperson — This call returns all of the episodes where the specified person is mentioned.
• podcastindex-pp-cli find search-byterm — This call returns all of the feeds that match the search terms in the title, author or owner of the feed.
• podcastindex-pp-cli find search-bytitle — This call returns all of the feeds where the title of the feed matches the search term (ignores case).
• podcastindex-pp-cli find search-music-byterm — This call returns all of the feeds that match the search terms in the title

lookup — Manage lookup

• podcastindex-pp-cli lookup — Replaces the Apple podcast lookup API but returns data from the Podcast Index database.

podcasts — Find details about a Podcast and its feed.

• podcastindex-pp-cli podcasts batch-byguid — This call returns everything we know about the feed from the feed's GUID provided in JSON array in the body of the
• podcastindex-pp-cli podcasts byfeedid — This call returns everything we know about the feed from the PodcastIndex ID Examples: - https://api.podcastindex.
• podcastindex-pp-cli podcasts byfeedurl — This call returns everything we know about the feed from the feed URL Examples: - https://api.podcastindex.org/api/1.
• podcastindex-pp-cli podcasts byguid — This call returns everything we know about the feed from the feed's GUID.
• podcastindex-pp-cli podcasts byitunesid — This call returns everything we know about the feed from the iTunes ID Example: https://api.podcastindex.org/api/1.
• podcastindex-pp-cli podcasts bymedium — This call returns all feeds marked with the specified [medium](https://github.
• podcastindex-pp-cli podcasts bytag — This call returns all feeds that support the specified [podcast namespace](https://github.
• podcastindex-pp-cli podcasts dead — This call returns all feeds that have been marked dead (dead == 1) Hourly statistics can also be access at https
• podcastindex-pp-cli podcasts trending — This call returns the podcasts/feeds that in the index that are trending. Example: https://api.podcastindex.org/api/1.

recent — Find recent additions to the index

• podcastindex-pp-cli recent data — This call returns every new feed and episode added to the index over the past 24 hours in reverse chronological order.
• podcastindex-pp-cli recent episodes — This call returns the most recent max number of episodes globally across the whole index
• podcastindex-pp-cli recent feeds — This call returns the most recent max feeds, in reverse chronological order. Examples: - https://api.podcastindex.
• podcastindex-pp-cli recent newfeeds — This call returns every new feed added to the index over the past 24 hours in reverse chronological order.
• podcastindex-pp-cli recent newvaluefeeds — This call returns feeds that have added a value tag in reverse chronological order. Example: https://api.podcastindex.
• podcastindex-pp-cli recent soundbites — This call returns the most recent max soundbites that the index has discovered.

stats — Statistics for items in the Podcast Index

• podcastindex-pp-cli stats — Return the most recent index statistics. Hourly statistics can also be access at https://stats.podcastindex.

value — The podcast's "Value for Value" information

• podcastindex-pp-cli value batch-byepisodeguid — This call returns the information for supporting the podcast episode via one of the 'Value for Value' methods from a
• podcastindex-pp-cli value byepisodeguid — This call returns the information for supporting the podcast episode via one of the 'Value for Value' methods from
• podcastindex-pp-cli value byfeedid — This call returns the information for supporting the podcast via one of the 'Value for Value' methods from the
• podcastindex-pp-cli value byfeedurl — This call returns the information for supporting the podcast via one of the 'Value for Value' methods from feed URL.
• podcastindex-pp-cli value bypodcastguid — This call returns the information for supporting the podcast via one of the 'Value for Value' methods from podcast GUID.