@pipeworx/pod-researcher

Podcast prospecting for guest booking and sponsorship: given a topic and a purpose, returns active podcasts whose recent episodes cover the topic, each with the best contact route the show itself published, the episodes that prove the fit, and your own outreach history so you never pitch the same show twice.

Part of Pipeworx — an MCP gateway connecting AI agents to 1867+ live data sources. This is an independent, unofficial integration — not affiliated with, endorsed by, or published by the upstream provider.

Tools

• find_podcast_contacts(topic, purpose, require_route?, language?, country?, active_only?, include_engaged?, limit?, cursor?) — active shows ranked by topical fit, each with best_route (or route_status: "none_found" plus what was checked), evidence episodes, coverage counts and data_as_of. purpose is guest or sponsor; routes designated for that purpose rank first, and a general contact or a person's published address is a labelled fallback. require_route: true returns only shows that have one.
• get_podcast_profile(id) — one show in full: identity, activity status, feed health, latest episodes, every published route. id is a show_id, an RSS feed URL (moved feeds resolve by their old URL) or a podcast:guid.
• refresh_podcast(id) — re-read one show's RSS feed now rather than waiting for its next scheduled check.
• watch_podcast_topic(topic, purpose, ...) / get_podcast_topic_changes(watch_id?) — save a search and get the shows that newly match it.
• record_podcast_outreach(show_id, outcome, scope?, contact_id?) — record contacted / replied / declined / booked / bounced / do_not_contact / clear. Declined and do_not_contact shows leave your searches; a scope: "person" record hides every show that publishes that person's address. Private to your account.
• list_podcast_transcripts(id, episode?, limit?) — which episodes have a publisher-provided transcript and where: reads the show's RSS feed live and lists every episode's Podcasting 2.0 <podcast:transcript> links (URL, declared type, format srt / vtt / json / text / html, language, rel). Episodes without one stay in the list as transcript_status: "no_publisher_transcript"; a show with none says so in note with transcript_coverage: "none" and the episode list intact. id is a show_id, podcast:guid or feed URL (a feed URL the index does not know is read directly).
• search_podcast_transcript(id, query, episode?, format?, limit?, window_seconds?) — passages of one episode's transcript that match a query, each with start / end (hh:mm:ss and seconds), the speakers when the file names them, and matched_terms. Defaults to the newest episode with a transcript; episode takes a guid, URL, episode number or title words. Formats parsed: SRT, WebVTT, Podcasting 2.0 JSON, plain text (timestamped lines, or untimed text returned with timing_note) and HTML. found: false, reason: "no_publisher_transcript" names the episodes that do have one. A feed or file that fails to fetch or parse throws an error naming the upstream HTTP status or the format.

Auth

Keyless to search. watch_podcast_topic, get_podcast_topic_changes and record_podcast_outreach need a signed-in account (an API key from pipeworx.io/signup): outreach history is kept per account, and an anonymous caller has none. This pack runs only on the Pipeworx gateway; a standalone build refuses every call rather than returning an empty list.

Contacts: what is returned and how it is labelled

Every address a show publishes in its own RSS feed or on its own website is returned, labelled:

• holder_type: role (a function inbox such as booking@ or sponsorships@), hosting_account_owner (the itunes:owner address from the feed, usually the host), or person (an individual's own address).
• purpose (guest, sponsor, general) and confidence (designated when the show invited that purpose in wo

... View full README on GitHub