Endpoints: 76,849MCP servers: 32,729Payout addresses: 3,825Paid calls: 6,151Letters: 84Defects: 3,892counted 2 min ago
teppi

Server definition

Hash
sha256:169a601004c561c06c9bb12ef2378c8cae01aa281e6cb1c92d6ce06dbd385d15
What it is
What a remote MCP server returned when asked what it offers: 7 tools

The blob, as servednamed by its sha256

{ "instructions": "BitePods clips the exact moment of a podcast episode and gives you a shareable link. A clip is a pointer — the publisher's URL plus an in and an out point — so nothing is uploaded and the clip lives in its own link.\n\nOrder of work: find it (`resolve_url` for a link, `search_shows` for a name) → `list_episodes` → `get_transcript` to locate the moment → `create_clip`. Pass an episode's `clipUrl`, `showUrl` and `audioUrl` back exactly as you were given them.\n\nTimes are seconds from the start of the episode (754.3), never \"12:34\".\n\nThree things to know so you don't retry what can't work: transcripts are the publisher's own and only about one show in six publishes any, so `available: false` is final; a link nothing playable was found behind answers `unresolved` with a reason, which is an answer rather than a transient failure; and there is no summarizing tool here on purpose — you get the transcript, you do the reading.\n\nCheck `clip.title` on the way out. It is the episode as its feed names it, and it is how you know you clipped what you meant to before you share the link. Full guide: https://bitepods.com/llms-full.txt", "tools": [ { "description": "Marks a span of an episode and hands back the links that play it. Nothing is downloaded, transcoded or re-hosted: a clip is a pointer — the publisher's own URL plus an in and an out point — so the whole clip fits in its link and this call cannot fail for reasons of storage. The episode's name and cover are resolved and returned, so you can check you clipped what you meant to before sharing the link.\n\nTimes are seconds from the start of the episode, decimals allowed.\n\nReturns `{ clip, links: { page, short, sourceAtMoment, mp3 }, shareText }`.\n\nUsually followed by: share links.short (or links.page); links.mp3 downloads the audio.", "inputSchema": { "additionalProperties": false, "properties": { "audioUrl": { "description": "The episode's audio file, when `url` is a page rather than the file. Pass the `audioUrl` from a resolve or an episode list: the clip then plays without waiting on the page to be read again.", "type": "string" }, "end": { "description": "Where it ends, in seconds. Must be at least half a second after `start`.", "examples": [ 784.5 ], "minimum": 0, "type": "number" }, "shorten": { "default": true, "description": "Also register the `/x/<id>` short link, which is the one thing this service stores. Set false to get only the self-contained long link and write nothing.", "type": "boolean" }, "showUrl": { "description": "The show this episode came out of (its feed). Pass the `showUrl` a resolve or an episode list gave you: it is what lets the clip page name the episode when its own page won't say, and what keeps a clip playable when the page moves.", "type": "string" }, "start": { "description": "Where the clip starts, in seconds from the start of the episode.", "examples": [ 754.3 ], "minimum": 0, "type": "number" }, "title": { "description": "A title of your own for this clip, shown in place of the episode's on the clip's card, its page and the link's unfurl. The episode's name says which episode; this says what the clip is, which is what somebody scrolling past the link is deciding on. Trimmed to one line and cut at 50 characters, which is what the card holds without clamping on a phone. Leave it out and the episode's own name is used.", "examples": [ "The bit where he admits the model was guessing" ], "type": "string" }, "url": { "description": "The episode to clip. Use the `clipUrl` from list_episodes or resolve_url when you have one.", "examples": [ "https://lexfridman.com/anthony-kaldellis/" ], "type": "string" } }, "required": [ "url", "start", "end" ], "type": "object" }, "name": "create_clip", "outputSchema": { "$defs": { "Chapter": { "description": "A moment the publisher named, from their own timestamp index.", "properties": { "startSeconds": { "description": "Seconds from the start of the episode. Pass it to create_clip as `start`.", "type": "number" }, "title": { "description": "The publisher's own words for this stretch.", "type": "string" } }, "required": [ "startSeconds", "title" ], "type": "object" }, "Clip": { "properties": { "clip": { "properties": { "artwork": { "format": "uri", "type": "string" }, "audioUrl": { "format": "uri", "type": "string" }, "durationSeconds": { "type": "number" }, "end": { "type": "number" }, "headline": { "description": "The title passed as `title`, cleaned and capped — what the clip is called wherever it appears. Absent when none was given, in which case the episode's own title is used.", "type": "string" }, "kind": { "enum": [ "audio" ], "type": "string" }, "lengthSeconds": { "type": "number" }, "show": { "type": "string" }, "showUrl": { "format": "uri", "type": "string" }, "sourceUrl": { "description": "Exactly what was passed in. Never rewritten — that's the promise.", "format": "uri", "type": "string" }, "start": { "type": "number" }, "title": { "description": "The episode, as resolved. Check it before you share the link.", "type": "string" } }, "required": [ "kind", "sourceUrl", "start", "end", "lengthSeconds" ], "type": "object" }, "links": { "properties": { "mp3": { "description": "The clip as a file. Audio only, 10 minutes at most.", "format": "uri", "type": "string" }, "page": { "description": "The clip, in a link that contains the whole clip.", "format": "uri", "type": "string" }, "short": { "format": "uri", "type": "string" }, "sourceAtMoment": { "description": "The publisher's own URL at that moment — no BitePods in the middle.", "format": "uri", "type": "string" } }, "required": [ "page", "sourceAtMoment" ], "type": "object" }, "note": { "type": "string" }, "plays": { "description": "Approximate: a per-clip counter, not an audit trail.", "type": "integer" }, "shareText": { "type": "string" }, "shortId": { "description": "The id in `/x/<id>`, when one was registered.", "type": "string" }, "shortened": { "type": "boolean" } }, "required": [ "clip", "links", "shareText" ], "type": "object" }, "Episode": { "properties": { "artwork": { "format": "uri", "type": "string" }, "audioUrl": { "description": "The publisher's audio file, for an audio episode.", "format": "uri", "type": "string" }, "chapters": { "description": "The publisher's own chapter marks, read from the episode notes. Absent when the show doesn't publish an index.", "items": { "$ref": "#/$defs/Chapter" }, "type": "array" }, "clipUrl": { "description": "Pass this back as `url` to create_clip or get_transcript.", "format": "uri", "type": "string" }, "durationSeconds": { "type": "number" }, "hasTranscript": { "description": "Whether get_transcript will have anything to read.", "type": "boolean" }, "kind": { "description": "How it plays back.", "enum": [ "audio" ], "type": "string" }, "pageUrl": { "description": "The episode's own web page, when it has one of its own.", "format": "uri", "type": "string" }, "publishedAt": { "description": "Unix seconds, when the source gave a date.", "type": "integer" }, "showUrl": { "description": "The show this came out of. Pass it to create_clip alongside `url`.", "format": "uri", "type": "string" }, "title": { "type": "string" }, "transcriptUrl": { "format": "uri", "type": "string" } }, "required": [ "title", "kind", "clipUrl", "hasTranscript" ], "type": "object" }, "EpisodeList": { "properties": { "episodes": { "items": { "$ref": "#/$defs/Episode" }, "type": "array" }, "hasMore": { "type": "boolean" }, "limit": { "type": "integer" }, "offset": { "type": "integer" }, "show": { "properties": { "artwork": { "format": "uri", "type": "string" }, "author": { "type": "string" }, "name": { "type": "string" }, "sourceUrl": { "format": "uri", "type": "string" } }, "type": "object" }, "total": { "description": "Episodes the source listed, up to the 60-item cap.", "type": "integer" } }, "required": [ "show", "episodes", "total", "offset", "limit", "hasMore" ], "type": "object" }, "Error": { "properties": { "docs": { "format": "uri", "type": "string" }, "error": { "properties": { "code": { "description": "The stable part. Branch on this, not on the wording.", "type": "string" }, "hint": { "description": "The call to make instead.", "type": "string" }, "message": { "type": "string" } }, "required": [ "code", "message" ], "type": "object" } }, "required": [ "error" ], "type": "object" }, "Resolution": { "description": "Read `type` first. All three are 200s: an unresolvable link is an answer, not a failure.", "oneOf": [ { "properties": { "episode": { "$ref": "#/$defs/ResolvedEpisode" }, "type": { "const": "episode" } }, "required": [ "type", "episode" ], "title": "episode", "type": "object" }, { "properties": { "episodeCount": { "type": "integer" }, "episodes": { "description": "The first few; list_episodes returns the rest.", "items": { "$ref": "#/$defs/Episode" }, "type": "array" }, "more": { "type": "string" }, "show": { "type": "object" }, "type": { "const": "show" } }, "required": [ "type", "show", "episodeCount", "episodes" ], "title": "show", "type": "object" }, { "properties": { "message": { "description": "Why nothing playable was found.", "type": "string" }, "type": { "const": "unresolved" }, "url": { "type": "string" } }, "required": [ "type", "url", "message" ], "title": "unresolved", "type": "object" } ] }, "ResolvedEpisode": { "description": "One playable episode. Nearly an `Episode`, but `sourceUrl` is the URL you passed in, unchanged — and a page that names nothing still resolves, so `title` can be absent.", "properties": { "artwork": { "format": "uri", "type": "string" }, "audioUrl": { "format": "uri", "type": "string" }, "clipUrl": { "description": "Pass this back as `url` to create_clip or get_transcript.", "format": "uri", "type": "string" }, "durationSeconds": { "type": "number" }, "hasTranscript": { "type": "boolean" }, "kind": { "enum": [ "audio" ], "type": "string" }, "show": { "type": "string" }, "showUrl": { "format": "uri", "type": "string" }, "sourceUrl": { "description": "Exactly what was passed in.", "format": "uri", "type": "string" }, "title": { "type": "string" }, "transcriptUrl": { "format": "uri", "type": "string" } }, "required": [ "kind", "sourceUrl", "clipUrl", "hasTranscript" ], "type": "object" }, "Show": { "description": "A show in the public podcast directory. Not playable on its own — resolve `sourceUrl` into episodes.", "properties": { "artwork": { "format": "uri", "type": "string" }, "author": { "description": "The publisher, as the directory names it.", "type": "string" }, "feedUrl": { "description": "The show's RSS feed, when the directory names one.", "format": "uri", "type": "string" }, "id": { "description": "Stable within one answer; Apple's collection id when Apple answered.", "type": "string" }, "name": { "type": "string" }, "pageUrl": { "description": "The show's Apple Podcasts page.", "format": "uri", "type": "string" }, "rank": { "description": "1-based chart position, on chart answers only.", "type": "integer" }, "sourceUrl": { "description": "What to pass to list_episodes: the feed, or the Apple page as a fallback.", "format": "uri", "type": "string" } }, "required": [ "id", "name" ], "type": "object" }, "ShowResults": { "properties": { "country": { "description": "Chart answers only: the country the chart is for.", "type": "string" }, "shows": { "items": { "$ref": "#/$defs/Show" }, "type": "array" } }, "required": [ "shows" ], "type": "object" }, "Transcript": { "description": "The publisher's own transcript, timed in seconds from the start of the episode.", "properties": { "available": { "type": "boolean" }, "episode": { "properties": { "clipUrl": { "type": "string" }, "durationSeconds": { "type": "number" }, "kind": { "type": "string" }, "show": { "type": "string" }, "title": { "type": "string" } }, "type": "object" }, "estimated": { "description": "True when long cues were split, so the split times are interpolated.", "type": "boolean" }, "lineCount": { "type": "integer" }, "lines": { "items": { "properties": { "end": { "type": "number" }, "speaker": { "description": "When the transcript says who's talking.", "type": "string" }, "start": { "description": "Seconds from the start of the episode — pass it to create_clip as-is.", "type": "number" }, "text": { "type": "string" } }, "required": [ "start", "end", "text" ], "type": "object" }, "type": "array" }, "reason": { "description": "Why there are no lines, when `available` is false.", "type": "string" }, "totalLines": { "type": "integer" }, "transcriptUrl": { "format": "uri", "type": "string" }, "truncated": { "description": "True when `limit` cut the answer; narrow the window or raise it.", "type": "boolean" }, "window": { "properties": { "end": { "type": [ "number", "null" ] }, "start": { "type": "number" } }, "type": "object" } }, "required": [ "available", "episode" ], "type": "object" } }, "properties": { "clip": { "properties": { "artwork": { "format": "uri", "type": "string" }, "audioUrl": { "format": "uri", "type": "string" }, "durationSeconds": { "type": "number" }, "end": { "type": "number" }, "headline": { "description": "The title passed as `title`, cleaned and capped — what the clip is called wherever it appears. Absent when none was given, in which case the episode's own title is used.", "type": "string" }, "kind": { "enum": [ "audio" ], "type": "string" }, "lengthSeconds": { "type": "number" }, "show": { "type": "string" }, "showUrl": { "format": "uri", "type": "string" }, "sourceUrl": { "description": "Exactly what was passed in. Never rewritten — that's the promise.", "format": "uri", "type": "string" }, "start": { "type": "number" }, "title": { "description": "The episode, as resolved. Check it before you share the link.", "type": "string" } }, "required": [ "kind", "sourceUrl", "start", "end", "lengthSeconds" ], "type": "object" }, "links": { "properties": { "mp3": { "description": "The clip as a file. Audio only, 10 minutes at most.", "format": "uri", "type": "string" }, "page": { "description": "The clip, in a link that contains the whole clip.", "format": "uri", "type": "string" }, "short": { "format": "uri", "type": "string" }, "sourceAtMoment": { "description": "The publisher's own URL at that moment — no BitePods in the middle.", "format": "uri", "type": "string" } }, "required": [ "page", "sourceAtMoment" ], "type": "object" }, "note": { "type": "string" }, "plays": { "description": "Approximate: a per-clip counter, not an audit trail.", "type": "integer" }, "shareText": { "type": "string" }, "shortId": { "description": "The id in `/x/<id>`, when one was registered.", "type": "string" }, "shortened": { "type": "boolean" } }, "required": [ "clip", "links", "shareText" ], "type": "object" } }, { "description": "What a short id stands for: the episode, the two times, the links, and how many times the clip has been played. The id is the `/x/<id>` part of a short link. Play counts are approximate by design — a per-clip counter with no atomic increment behind it, not an audit trail.\n\nReturns `{ clip, links, plays, shareText }`.", "inputSchema": { "additionalProperties": false, "properties": { "id": { "description": "The short id, 8-32 characters, as it appears in `/x/<id>`.", "examples": [ "k4m7pq2r" ], "type": "string" } }, "required": [ "id" ], "type": "object" }, "name": "get_clip", "outputSchema": { "$defs": { "Chapter": { "description": "A moment the publisher named, from their own timestamp index.", "properties": { "startSeconds": { "description": "Seconds from the start of the episode. Pass it to create_clip as `start`.", "type": "number" }, "title": { "description": "The publisher's own words for this stretch.", "type": "string" } }, "required": [ "startSeconds", "title" ], "type": "object" }, "Clip": { "properties": { "clip": { "properties": { "artwork": { "format": "uri", "type": "string" }, "audioUrl": { "format": "uri", "type": "string" }, "durationSeconds": { "type": "number" }, "end": { "type": "number" }, "headline": { "description": "The title passed as `title`, cleaned and capped — what the clip is called wherever it appears. Absent when none was given, in which case the episode's own title is used.", "type": "string" }, "kind": { "enum": [ "audio" ], "type": "string" }, "lengthSeconds": { "type": "number" }, "show": { "type": "string" }, "showUrl": { "format": "uri", "type": "string" }, "sourceUrl": { "description": "Exactly what was passed in. Never rewritten — that's the promise.", "format": "uri", "type": "string" }, "start": { "type": "number" }, "title": { "description": "The episode, as resolved. Check it before you share the link.", "type": "string" } }, "required": [ "kind", "sourceUrl", "start", "end", "lengthSeconds" ], "type": "object" }, "links": { "properties": { "mp3": { "description": "The clip as a file. Audio only, 10 minutes at most.", "format": "uri", "type": "string" }, "page": { "description": "The clip, in a link that contains the whole clip.", "format": "uri", "type": "string" }, "short": { "format": "uri", "type": "string" }, "sourceAtMoment": { "description": "The publisher's own URL at that moment — no BitePods in the middle.", "format": "uri", "type": "string" } }, "required": [ "page", "sourceAtMoment" ], "type": "object" }, "note": { "type": "string" }, "plays": { "description": "Approximate: a per-clip counter, not an audit trail.", "type": "integer" }, "shareText": { "type": "string" }, "shortId": { "description": "The id in `/x/<id>`, when one was registered.", "type": "string" }, "shortened": { "type": "boolean" } }, "required": [ "clip", "links", "shareText" ], "type": "object" }, "Episode": { "properties": { "artwork": { "format": "uri", "type": "string" }, "audioUrl": { "description": "The publisher's audio file, for an audio episode.", "format": "uri", "type": "string" }, "chapters": { "description": "The publisher's own chapter marks, read from the episode notes. Absent when the show doesn't publish an index.", "items": { "$ref": "#/$defs/Chapter" }, "type": "array" }, "clipUrl": { "description": "Pass this back as `url` to create_clip or get_transcript.", "format": "uri", "type": "string" }, "durationSeconds": { "type": "number" }, "hasTranscript": { "description": "Whether get_transcript will have anything to read.", "type": "boolean" }, "kind": { "description": "How it plays back.", "enum": [ "audio" ], "type": "string" }, "pageUrl": { "description": "The episode's own web page, when it has one of its own.", "format": "uri", "type": "string" }, "publishedAt": { "description": "Unix seconds, when the source gave a date.", "type": "integer" }, "showUrl": { "description": "The show this came out of. Pass it to create_clip alongside `url`.", "format": "uri", "type": "string" }, "title": { "type": "string" }, "transcriptUrl": { "format": "uri", "type": "string" } }, "required": [ "title", "kind", "clipUrl", "hasTranscript" ], "type": "object" }, "EpisodeList": { "properties": { "episodes": { "items": { "$ref": "#/$defs/Episode" }, "type": "array" }, "hasMore": { "type": "boolean" }, "limit": { "type": "integer" }, "offset": { "type": "integer" }, "show": { "properties": { "artwork": { "format": "uri", "type": "string" }, "author": { "type": "string" }, "name": { "type": "string" }, "sourceUrl": { "format": "uri", "type": "string" } }, "type": "object" }, "total": { "description": "Episodes the source listed, up to the 60-item cap.", "type": "integer" } }, "required": [ "show", "episodes", "total", "offset", "limit", "hasMore" ], "type": "object" }, "Error": { "properties": { "docs": { "format": "uri", "type": "string" }, "error": { "properties": { "code": { "description": "The stable part. Branch on this, not on the wording.", "type": "string" }, "hint": { "description": "The call to make instead.", "type": "string" }, "message": { "type": "string" } }, "required": [ "code", "message" ], "type": "object" } }, "required": [ "error" ], "type": "object" }, "Resolution": { "description": "Read `type` first. All three are 200s: an unresolvable link is an answer, not a failure.", "oneOf": [ { "properties": { "episode": { "$ref": "#/$defs/ResolvedEpisode" }, "type": { "const": "episode" } }, "required": [ "type", "episode" ], "title": "episode", "type": "object" }, { "properties": { "episodeCount": { "type": "integer" }, "episodes": { "description": "The first few; list_episodes returns the rest.", "items": { "$ref": "#/$defs/Episode" }, "type": "array" }, "more": { "type": "string" }, "show": { "type": "object" }, "type": { "const": "show" } }, "required": [ "type", "show", "episodeCount", "episodes" ], "title": "show", "type": "object" }, { "properties": { "message": { "description": "Why nothing playable was found.", "type": "string" }, "type": { "const": "unresolved" }, "url": { "type": "string" } }, "required": [ "type", "url", "message" ], "title": "unresolved", "type": "object" } ] }, "ResolvedEpisode": { "description": "One playable episode. Nearly an `Episode`, but `sourceUrl` is the URL you passed in, unchanged — and a page that names nothing still resolves, so `title` can be absent.", "properties": { "artwork": { "format": "uri", "type": "string" }, "audioUrl": { "format": "uri", "type": "string" }, "clipUrl": { "description": "Pass this back as `url` to create_clip or get_transcript.", "format": "uri", "type": "string" }, "durationSeconds": { "type": "number" }, "hasTranscript": { "type": "boolean" }, "kind": { "enum": [ "audio" ], "type": "string" }, "show": { "type": "string" }, "showUrl": { "format": "uri", "type": "string" }, "sourceUrl": { "description": "Exactly what was passed in.", "format": "uri", "type": "string" }, "title": { "type": "string" }, "transcriptUrl": { "format": "uri", "type": "string" } }, "required": [ "kind", "sourceUrl", "clipUrl", "hasTranscript" ], "type": "object" }, "Show": { "description": "A show in the public podcast directory. Not playable on its own — resolve `sourceUrl` into episodes.", "properties": { "artwork": { "format": "uri", "type": "string" }, "author": { "description": "The publisher, as the directory names it.", "type": "string" }, "feedUrl": { "description": "The show's RSS feed, when the directory names one.", "format": "uri", "type": "string" }, "id": { "description": "Stable within one answer; Apple's collection id when Apple answered.", "type": "string" }, "name": { "type": "string" }, "pageUrl": { "description": "The show's Apple Podcasts page.", "format": "uri", "type": "string" }, "rank": { "description": "1-based chart position, on chart answers only.", "type": "integer" }, "sourceUrl": { "description": "What to pass to list_episodes: the feed, or the Apple page as a fallback.", "format": "uri", "type": "string" } }, "required": [ "id", "name" ], "type": "object" }, "ShowResults": { "properties": { "country": { "description": "Chart answers only: the country the chart is for.", "type": "string" }, "shows": { "items": { "$ref": "#/$defs/Show" }, "type": "array" } }, "required": [ "shows" ], "type": "object" }, "Transcript": { "description": "The publisher's own transcript, timed in seconds from the start of the episode.", "properties": { "available": { "type": "boolean" }, "episode": { "properties": { "clipUrl": { "type": "string" }, "durationSeconds": { "type": "number" }, "kind": { "type": "string" }, "show": { "type": "string" }, "title": { "type": "string" } }, "type": "object" }, "estimated": { "description": "True when long cues were split, so the split times are interpolated.", "type": "boolean" }, "lineCount": { "type": "integer" }, "lines": { "items": { "properties": { "end": { "type": "number" }, "speaker": { "description": "When the transcript says who's talking.", "type": "string" }, "start": { "description": "Seconds from the start of the episode — pass it to create_clip as-is.", "type": "number" }, "text": { "type": "string" } }, "required": [ "start", "end", "text" ], "type": "object" }, "type": "array" }, "reason": { "description": "Why there are no lines, when `available` is false.", "type": "string" }, "totalLines": { "type": "integer" }, "transcriptUrl": { "format": "uri", "type": "string" }, "truncated": { "description": "True when `limit` cut the answer; narrow the window or raise it.", "type": "boolean" }, "window": { "properties": { "end": { "type": [ "number", "null" ] }, "start": { "type": "number" } }, "type": "object" } }, "required": [ "available", "episode" ], "type": "object" } }, "properties": { "clip": { "properties": { "artwork": { "format": "uri", "type": "string" }, "audioUrl": { "format": "uri", "type": "string" }, "durationSeconds": { "type": "number" }, "end": { "type": "number" }, "headline": { "description": "The title passed as `title`, cleaned and capped — what the clip is called wherever it appears. Absent when none was given, in which case the episode's own title is used.", "type": "string" }, "kind": { "enum": [ "audio" ], "type": "string" }, "lengthSeconds": { "type": "number" }, "show": { "type": "string" }, "showUrl": { "format": "uri", "type": "string" }, "sourceUrl": { "description": "Exactly what was passed in. Never rewritten — that's the promise.", "format": "uri", "type": "string" }, "start": { "type": "number" }, "title": { "description": "The episode, as resolved. Check it before you share the link.", "type": "string" } }, "required": [ "kind", "sourceUrl", "start", "end", "lengthSeconds" ], "type": "object" }, "links": { "properties": { "mp3": { "description": "The clip as a file. Audio only, 10 minutes at most.", "format": "uri", "type": "string" }, "page": { "description": "The clip, in a link that contains the whole clip.", "format": "uri", "type": "string" }, "short": { "format": "uri", "type": "string" }, "sourceAtMoment": { "description": "The publisher's own URL at that moment — no BitePods in the middle.", "format": "uri", "type": "string" } }, "required": [ "page", "sourceAtMoment" ], "type": "object" }, "note": { "type": "string" }, "plays": { "description": "Approximate: a per-clip counter, not an audit trail.", "type": "integer" }, "shareText": { "type": "string" }, "shortId": { "description": "The id in `/x/<id>`, when one was registered.", "type": "string" }, "shortened": { "type": "boolean" } }, "required": [ "clip", "links", "shareText" ], "type": "object" } }, { "description": "The episode's own transcript with absolute timestamps in seconds, so a line's `start` is a number you can pass straight to create_clip. This is how you find the moment worth clipping: read the transcript, choose the span, clip it.\n\nThese are the publisher's transcripts (Podcasting 2.0 `<podcast:transcript>`), and only about one show in six ships one. There is no speech-to-text here — deliberately, and it is not coming — so an episode without one answers `available: false` with a reason rather than an approximation. Cue-timed, not word-timed: a long cue is split into readable lines and `estimated: true` says the split points are interpolated between two known times.\n\nReturns `{ available, lines, lineCount, truncated, estimated, episode, … }`; `available: false` carries `reason`.\n\nUsually followed by: create_clip with a line's start and end.", "inputSchema": { "additionalProperties": false, "properties": { "end": { "default": 0, "description": "Only lines that overlap up to this many seconds. 0 means to the end of the episode.", "minimum": 0, "type": "number" }, "limit": { "default": 400, "description": "How many lines to return, at most. Clamped to 2000.", "maximum": 2000, "minimum": 1, "type": "integer" }, "showUrl": { "description": "The show the episode came out of (its feed). Pass the episode's `showUrl` from list_episodes: an episode whose `clipUrl` is its audio file finds its transcript through the feed.", "type": "string" }, "start": { "default": 0, "description": "Only lines that overlap from this many seconds into the episode.", "minimum": 0, "type": "number" }, "url": { "description": "The episode. An episode page, a direct audio file, or a `clipUrl` from list_episodes.", "examples": [ "https://lexfridman.com/anthony-kaldellis/" ], "type": "string" } }, "required": [ "url" ], "type": "object" }, "name": "get_transcript", "outputSchema": { "$defs": { "Chapter": { "description": "A moment the publisher named, from their own timestamp index.", "properties": { "startSeconds": { "description": "Seconds from the start of the episode. Pass it to create_clip as `start`.", "type": "number" }, "title": { "description": "The publisher's own words for this stretch.", "type": "string" } }, "required": [ "startSeconds", "title" ], "type": "object" }, "Clip": { "properties": { "clip": { "properties": { "artwork": { "format": "uri", "type": "string" }, "audioUrl": { "format": "uri", "type": "string" }, "durationSeconds": { "type": "number" }, "end": { "type": "number" }, "headline": { "description": "The title passed as `title`, cleaned and capped — what the clip is called wherever it appears. Absent when none was given, in which case the episode's own title is used.", "type": "string" }, "kind": { "enum": [ "audio" ], "type": "string" }, "lengthSeconds": { "type": "number" }, "show": { "type": "string" }, "showUrl": { "format": "uri", "type": "string" }, "sourceUrl": { "description": "Exactly what was passed in. Never rewritten — that's the promise.", "format": "uri", "type": "string" }, "start": { "type": "number" }, "title": { "description": "The episode, as resolved. Check it before you share the link.", "type": "string" } }, "required": [ "kind", "sourceUrl", "start", "end", "lengthSeconds" ], "type": "object" }, "links": { "properties": { "mp3": { "description": "The clip as a file. Audio only, 10 minutes at most.", "format": "uri", "type": "string" }, "page": { "description": "The clip, in a link that contains the whole clip.", "format": "uri", "type": "string" }, "short": { "format": "uri", "type": "string" }, "sourceAtMoment": { "description": "The publisher's own URL at that moment — no BitePods in the middle.", "format": "uri", "type": "string" } }, "required": [ "page", "sourceAtMoment" ], "type": "object" }, "note": { "type": "string" }, "plays": { "description": "Approximate: a per-clip counter, not an audit trail.", "type": "integer" }, "shareText": { "type": "string" }, "shortId": { "description": "The id in `/x/<id>`, when one was registered.", "type": "string" }, "shortened": { "type": "boolean" } }, "required": [ "clip", "links", "shareText" ], "type": "object" }, "Episode": { "properties": { "artwork": { "format": "uri", "type": "string" }, "audioUrl": { "description": "The publisher's audio file, for an audio episode.", "format": "uri", "type": "string" }, "chapters": { "description": "The publisher's own chapter marks, read from the episode notes. Absent when the show doesn't publish an index.", "items": { "$ref": "#/$defs/Chapter" }, "type": "array" }, "clipUrl": { "description": "Pass this back as `url` to create_clip or get_transcript.", "format": "uri", "type": "string" }, "durationSeconds": { "type": "number" }, "hasTranscript": { "description": "Whether get_transcript will have anything to read.", "type": "boolean" }, "kind": { "description": "How it plays back.", "enum": [ "audio" ], "type": "string" }, "pageUrl": { "description": "The episode's own web page, when it has one of its own.", "format": "uri", "type": "string" }, "publishedAt": { "description": "Unix seconds, when the source gave a date.", "type": "integer" }, "showUrl": { "description": "The show this came out of. Pass it to create_clip alongside `url`.", "format": "uri", "type": "string" }, "title": { "type": "string" }, "transcriptUrl": { "format": "uri", "type": "string" } }, "required": [ "title", "kind", "clipUrl", "hasTranscript" ], "type": "object" }, "EpisodeList": { "properties": { "episodes": { "items": { "$ref": "#/$defs/Episode" }, "type": "array" }, "hasMore": { "type": "boolean" }, "limit": { "type": "integer" }, "offset": { "type": "integer" }, "show": { "properties": { "artwork": { "format": "uri", "type": "string" }, "author": { "type": "string" }, "name": { "type": "string" }, "sourceUrl": { "format": "uri", "type": "string" } }, "type": "object" }, "total": { "description": "Episodes the source listed, up to the 60-item cap.", "type": "integer" } }, "required": [ "show", "episodes", "total", "offset", "limit", "hasMore" ], "type": "object" }, "Error": { "properties": { "docs": { "format": "uri", "type": "string" }, "error": { "properties": { "code": { "description": "The stable part. Branch on this, not on the wording.", "type": "string" }, "hint": { "description": "The call to make instead.", "type": "string" }, "message": { "type": "string" } }, "required": [ "code", "message" ], "type": "object" } }, "required": [ "error" ], "type": "object" }, "Resolution": { "description": "Read `type` first. All three are 200s: an unresolvable link is an answer, not a failure.", "oneOf": [ { "properties": { "episode": { "$ref": "#/$defs/ResolvedEpisode" }, "type": { "const": "episode" } }, "required": [ "type", "episode" ], "title": "episode", "type": "object" }, { "properties": { "episodeCount": { "type": "integer" }, "episodes": { "description": "The first few; list_episodes returns the rest.", "items": { "$ref": "#/$defs/Episode" }, "type": "array" }, "more": { "type": "string" }, "show": { "type": "object" }, "type": { "const": "show" } }, "required": [ "type", "show", "episodeCount", "episodes" ], "title": "show", "type": "object" }, { "properties": { "message": { "description": "Why nothing playable was found.", "type": "string" }, "type": { "const": "unresolved" }, "url": { "type": "string" } }, "required": [ "type", "url", "message" ], "title": "unresolved", "type": "object" } ] }, "ResolvedEpisode": { "description": "One playable episode. Nearly an `Episode`, but `sourceUrl` is the URL you passed in, unchanged — and a page that names nothing still resolves, so `title` can be absent.", "properties": { "artwork": { "format": "uri", "type": "string" }, "audioUrl": { "format": "uri", "type": "string" }, "clipUrl": { "description": "Pass this back as `url` to create_clip or get_transcript.", "format": "uri", "type": "string" }, "durationSeconds": { "type": "number" }, "hasTranscript": { "type": "boolean" }, "kind": { "enum": [ "audio" ], "type": "string" }, "show": { "type": "string" }, "showUrl": { "format": "uri", "type": "string" }, "sourceUrl": { "description": "Exactly what was passed in.", "format": "uri", "type": "string" }, "title": { "type": "string" }, "transcriptUrl": { "format": "uri", "type": "string" } }, "required": [ "kind", "sourceUrl", "clipUrl", "hasTranscript" ], "type": "object" }, "Show": { "description": "A show in the public podcast directory. Not playable on its own — resolve `sourceUrl` into episodes.", "properties": { "artwork": { "format": "uri", "type": "string" }, "author": { "description": "The publisher, as the directory names it.", "type": "string" }, "feedUrl": { "description": "The show's RSS feed, when the directory names one.", "format": "uri", "type": "string" }, "id": { "description": "Stable within one answer; Apple's collection id when Apple answered.", "type": "string" }, "name": { "type": "string" }, "pageUrl": { "description": "The show's Apple Podcasts page.", "format": "uri", "type": "string" }, "rank": { "description": "1-based chart position, on chart answers only.", "type": "integer" }, "sourceUrl": { "description": "What to pass to list_episodes: the feed, or the Apple page as a fallback.", "format": "uri", "type": "string" } }, "required": [ "id", "name" ], "type": "object" }, "ShowResults": { "properties": { "country": { "description": "Chart answers only: the country the chart is for.", "type": "string" }, "shows": { "items": { "$ref": "#/$defs/Show" }, "type": "array" } }, "required": [ "shows" ], "type": "object" }, "Transcript": { "description": "The publisher's own transcript, timed in seconds from the start of the episode.", "properties": { "available": { "type": "boolean" }, "episode": { "properties": { "clipUrl": { "type": "string" }, "durationSeconds": { "type": "number" }, "kind": { "type": "string" }, "show": { "type": "string" }, "title": { "type": "string" } }, "type": "object" }, "estimated": { "description": "True when long cues were split, so the split times are interpolated.", "type": "boolean" }, "lineCount": { "type": "integer" }, "lines": { "items": { "properties": { "end": { "type": "number" }, "speaker": { "description": "When the transcript says who's talking.", "type": "string" }, "start": { "description": "Seconds from the start of the episode — pass it to create_clip as-is.", "type": "number" }, "text": { "type": "string" } }, "required": [ "start", "end", "text" ], "type": "object" }, "type": "array" }, "reason": { "description": "Why there are no lines, when `available` is false.", "type": "string" }, "totalLines": { "type": "integer" }, "transcriptUrl": { "format": "uri", "type": "string" }, "truncated": { "description": "True when `limit` cut the answer; narrow the window or raise it.", "type": "boolean" }, "window": { "properties": { "end": { "type": [ "number", "null" ] }, "start": { "type": "number" } }, "type": "object" } }, "required": [ "available", "episode" ], "type": "object" } }, "description": "The publisher's own transcript, timed in seconds from the start of the episode.", "properties": { "available": { "type": "boolean" }, "episode": { "properties": { "clipUrl": { "type": "string" }, "durationSeconds": { "type": "number" }, "kind": { "type": "string" }, "show": { "type": "string" }, "title": { "type": "string" } }, "type": "object" }, "estimated": { "description": "True when long cues were split, so the split times are interpolated.", "type": "boolean" }, "lineCount": { "type": "integer" }, "lines": { "items": { "properties": { "end": { "type": "number" }, "speaker": { "description": "When the transcript says who's talking.", "type": "string" }, "start": { "description": "Seconds from the start of the episode — pass it to create_clip as-is.", "type": "number" }, "text": { "type": "string" } }, "required": [ "start", "end", "text" ], "type": "object" }, "type": "array" }, "reason": { "description": "Why there are no lines, when `available` is false.", "type": "string" }, "totalLines": { "type": "integer" }, "transcriptUrl": { "format": "uri", "type": "string" }, "truncated": { "description": "True when `limit` cut the answer; narrow the window or raise it.", "type": "boolean" }, "window": { "properties": { "end": { "type": [ "number", "null" ] }, "start": { "type": "number" } }, "type": "object" } }, "required": [ "available", "episode" ], "type": "object" } }, { "description": "Episodes of a show, newest first, from its RSS feed or its Apple Podcasts page. Feeds are read up to 60 items — that is the cap, not a page you can walk past. Each episode carries a `clipUrl`: pass it back as `url` to `create_clip` or `get_transcript` and the right episode is clipped, whatever the show's pages look like. Errors with `not_a_show` if the URL is one episode rather than a show.\n\nAn episode from a feed may also carry `chapters` — the publisher's own timestamp index, read out of the show notes, as `{ startSeconds, title }` in the order they happen. That is a human being naming the parts of their own episode, so it is the cheapest way to find a moment worth clipping: pick a chapter, pass its `startSeconds` to `create_clip` as `start`, and the next chapter's `startSeconds` as `end`. Roughly two shows in five publish one, and a show that doesn't simply has no `chapters` field.\n\nReturns `{ show, episodes, total, offset, limit, hasMore }`. An episode may carry `chapters`.\n\nUsually followed by: An episode's own `chapters` are the quickest way to a moment; get_transcript reads the words where a show publishes one. Then create_clip.", "inputSchema": { "additionalProperties": false, "properties": { "limit": { "default": 50, "description": "How many episodes to return, at most. Clamped to 60.", "maximum": 60, "minimum": 1, "type": "integer" }, "offset": { "default": 0, "description": "Skip this many episodes first, to page through a long feed.", "minimum": 0, "type": "integer" }, "url": { "description": "A show: its RSS feed or Apple Podcasts page.", "examples": [ "https://feeds.simplecast.com/l2i9YnTd" ], "type": "string" } }, "required": [ "url" ], "type": "object" }, "name": "list_episodes", "outputSchema": { "$defs": { "Chapter": { "description": "A moment the publisher named, from their own timestamp index.", "properties": { "startSeconds": { "description": "Seconds from the start of the episode. Pass it to create_clip as `start`.", "type": "number" }, "title": { "description": "The publisher's own words for this stretch.", "type": "string" } }, "required": [ "startSeconds", "title" ], "type": "object" }, "Clip": { "properties": { "clip": { "properties": { "artwork": { "format": "uri", "type": "string" }, "audioUrl": { "format": "uri", "type": "string" }, "durationSeconds": { "type": "number" }, "end": { "type": "number" }, "headline": { "description": "The title passed as `title`, cleaned and capped — what the clip is called wherever it appears. Absent when none was given, in which case the episode's own title is used.", "type": "string" }, "kind": { "enum": [ "audio" ], "type": "string" }, "lengthSeconds": { "type": "number" }, "show": { "type": "string" }, "showUrl": { "format": "uri", "type": "string" }, "sourceUrl": { "description": "Exactly what was passed in. Never rewritten — that's the promise.", "format": "uri", "type": "string" }, "start": { "type": "number" }, "title": { "description": "The episode, as resolved. Check it before you share the link.", "type": "string" } }, "required": [ "kind", "sourceUrl", "start", "end", "lengthSeconds" ], "type": "object" }, "links": { "properties": { "mp3": { "description": "The clip as a file. Audio only, 10 minutes at most.", "format": "uri", "type": "string" }, "page": { "description": "The clip, in a link that contains the whole clip.", "format": "uri", "type": "string" }, "short": { "format": "uri", "type": "string" }, "sourceAtMoment": { "description": "The publisher's own URL at that moment — no BitePods in the middle.", "format": "uri", "type": "string" } }, "required": [ "page", "sourceAtMoment" ], "type": "object" }, "note": { "type": "string" }, "plays": { "description": "Approximate: a per-clip counter, not an audit trail.", "type": "integer" }, "shareText": { "type": "string" }, "shortId": { "description": "The id in `/x/<id>`, when one was registered.", "type": "string" }, "shortened": { "type": "boolean" } }, "required": [ "clip", "links", "shareText" ], "type": "object" }, "Episode": { "properties": { "artwork": { "format": "uri", "type": "string" }, "audioUrl": { "description": "The publisher's audio file, for an audio episode.", "format": "uri", "type": "string" }, "chapters": { "description": "The publisher's own chapter marks, read from the episode notes. Absent when the show doesn't publish an index.", "items": { "$ref": "#/$defs/Chapter" }, "type": "array" }, "clipUrl": { "description": "Pass this back as `url` to create_clip or get_transcript.", "format": "uri", "type": "string" }, "durationSeconds": { "type": "number" }, "hasTranscript": { "description": "Whether get_transcript will have anything to read.", "type": "boolean" }, "kind": { "description": "How it plays back.", "enum": [ "audio" ], "type": "string" }, "pageUrl": { "description": "The episode's own web page, when it has one of its own.", "format": "uri", "type": "string" }, "publishedAt": { "description": "Unix seconds, when the source gave a date.", "type": "integer" }, "showUrl": { "description": "The show this came out of. Pass it to create_clip alongside `url`.", "format": "uri", "type": "string" }, "title": { "type": "string" }, "transcriptUrl": { "format": "uri", "type": "string" } }, "required": [ "title", "kind", "clipUrl", "hasTranscript" ], "type": "object" }, "EpisodeList": { "properties": { "episodes": { "items": { "$ref": "#/$defs/Episode" }, "type": "array" }, "hasMore": { "type": "boolean" }, "limit": { "type": "integer" }, "offset": { "type": "integer" }, "show": { "properties": { "artwork": { "format": "uri", "type": "string" }, "author": { "type": "string" }, "name": { "type": "string" }, "sourceUrl": { "format": "uri", "type": "string" } }, "type": "object" }, "total": { "description": "Episodes the source listed, up to the 60-item cap.", "type": "integer" } }, "required": [ "show", "episodes", "total", "offset", "limit", "hasMore" ], "type": "object" }, "Error": { "properties": { "docs": { "format": "uri", "type": "string" }, "error": { "properties": { "code": { "description": "The stable part. Branch on this, not on the wording.", "type": "string" }, "hint": { "description": "The call to make instead.", "type": "string" }, "message": { "type": "string" } }, "required": [ "code", "message" ], "type": "object" } }, "required": [ "error" ], "type": "object" }, "Resolution": { "description": "Read `type` first. All three are 200s: an unresolvable link is an answer, not a failure.", "oneOf": [ { "properties": { "episode": { "$ref": "#/$defs/ResolvedEpisode" }, "type": { "const": "episode" } }, "required": [ "type", "episode" ], "title": "episode", "type": "object" }, { "properties": { "episodeCount": { "type": "integer" }, "episodes": { "description": "The first few; list_episodes returns the rest.", "items": { "$ref": "#/$defs/Episode" }, "type": "array" }, "more": { "type": "string" }, "show": { "type": "object" }, "type": { "const": "show" } }, "required": [ "type", "show", "episodeCount", "episodes" ], "title": "show", "type": "object" }, { "properties": { "message": { "description": "Why nothing playable was found.", "type": "string" }, "type": { "const": "unresolved" }, "url": { "type": "string" } }, "required": [ "type", "url", "message" ], "title": "unresolved", "type": "object" } ] }, "ResolvedEpisode": { "description": "One playable episode. Nearly an `Episode`, but `sourceUrl` is the URL you passed in, unchanged — and a page that names nothing still resolves, so `title` can be absent.", "properties": { "artwork": { "format": "uri", "type": "string" }, "audioUrl": { "format": "uri", "type": "string" }, "clipUrl": { "description": "Pass this back as `url` to create_clip or get_transcript.", "format": "uri", "type": "string" }, "durationSeconds": { "type": "number" }, "hasTranscript": { "type": "boolean" }, "kind": { "enum": [ "audio" ], "type": "string" }, "show": { "type": "string" }, "showUrl": { "format": "uri", "type": "string" }, "sourceUrl": { "description": "Exactly what was passed in.", "format": "uri", "type": "string" }, "title": { "type": "string" }, "transcriptUrl": { "format": "uri", "type": "string" } }, "required": [ "kind", "sourceUrl", "clipUrl", "hasTranscript" ], "type": "object" }, "Show": { "description": "A show in the public podcast directory. Not playable on its own — resolve `sourceUrl` into episodes.", "properties": { "artwork": { "format": "uri", "type": "string" }, "author": { "description": "The publisher, as the directory names it.", "type": "string" }, "feedUrl": { "description": "The show's RSS feed, when the directory names one.", "format": "uri", "type": "string" }, "id": { "description": "Stable within one answer; Apple's collection id when Apple answered.", "type": "string" }, "name": { "type": "string" }, "pageUrl": { "description": "The show's Apple Podcasts page.", "format": "uri", "type": "string" }, "rank": { "description": "1-based chart position, on chart answers only.", "type": "integer" }, "sourceUrl": { "description": "What to pass to list_episodes: the feed, or the Apple page as a fallback.", "format": "uri", "type": "string" } }, "required": [ "id", "name" ], "type": "object" }, "ShowResults": { "properties": { "country": { "description": "Chart answers only: the country the chart is for.", "type": "string" }, "shows": { "items": { "$ref": "#/$defs/Show" }, "type": "array" } }, "required": [ "shows" ], "type": "object" }, "Transcript": { "description": "The publisher's own transcript, timed in seconds from the start of the episode.", "properties": { "available": { "type": "boolean" }, "episode": { "properties": { "clipUrl": { "type": "string" }, "durationSeconds": { "type": "number" }, "kind": { "type": "string" }, "show": { "type": "string" }, "title": { "type": "string" } }, "type": "object" }, "estimated": { "description": "True when long cues were split, so the split times are interpolated.", "type": "boolean" }, "lineCount": { "type": "integer" }, "lines": { "items": { "properties": { "end": { "type": "number" }, "speaker": { "description": "When the transcript says who's talking.", "type": "string" }, "start": { "description": "Seconds from the start of the episode — pass it to create_clip as-is.", "type": "number" }, "text": { "type": "string" } }, "required": [ "start", "end", "text" ], "type": "object" }, "type": "array" }, "reason": { "description": "Why there are no lines, when `available` is false.", "type": "string" }, "totalLines": { "type": "integer" }, "transcriptUrl": { "format": "uri", "type": "string" }, "truncated": { "description": "True when `limit` cut the answer; narrow the window or raise it.", "type": "boolean" }, "window": { "properties": { "end": { "type": [ "number", "null" ] }, "start": { "type": "number" } }, "type": "object" } }, "required": [ "available", "episode" ], "type": "object" } }, "properties": { "episodes": { "items": { "$ref": "#/$defs/Episode" }, "type": "array" }, "hasMore": { "type": "boolean" }, "limit": { "type": "integer" }, "offset": { "type": "integer" }, "show": { "properties": { "artwork": { "format": "uri", "type": "string" }, "author": { "type": "string" }, "name": { "type": "string" }, "sourceUrl": { "format": "uri", "type": "string" } }, "type": "object" }, "total": { "description": "Episodes the source listed, up to the 60-item cap.", "type": "integer" } }, "required": [ "show", "episodes", "total", "offset", "limit", "hasMore" ], "type": "object" } }, { "description": "Turns any pasted link into something clippable, and says which of three things it is: `episode` (one playable thing, ready for create_clip), `show` (a feed or channel — a preview of its episodes, with list_episodes for the rest), or `unresolved` (nothing playable was found, and why). Answering `unresolved` is a real answer, not a failure: clipping the wrong audio confidently is worse. Spotify links resolve to the same episode in the show's own feed, because nothing else can play Spotify.\n\nReturns `{ type: 'episode' | 'show' | 'unresolved', … }` — always 200; read `type`.\n\nUsually followed by: create_clip for an episode, list_episodes for a show.", "inputSchema": { "additionalProperties": false, "properties": { "url": { "description": "Anything that points at an episode: an Apple Podcasts or Spotify episode link, an episode's own web page, an RSS feed, or a direct .mp3/.m4a file.", "examples": [ "https://lexfridman.com/anthony-kaldellis/" ], "type": "string" } }, "required": [ "url" ], "type": "object" }, "name": "resolve_url", "outputSchema": { "$defs": { "Chapter": { "description": "A moment the publisher named, from their own timestamp index.", "properties": { "startSeconds": { "description": "Seconds from the start of the episode. Pass it to create_clip as `start`.", "type": "number" }, "title": { "description": "The publisher's own words for this stretch.", "type": "string" } }, "required": [ "startSeconds", "title" ], "type": "object" }, "Clip": { "properties": { "clip": { "properties": { "artwork": { "format": "uri", "type": "string" }, "audioUrl": { "format": "uri", "type": "string" }, "durationSeconds": { "type": "number" }, "end": { "type": "number" }, "headline": { "description": "The title passed as `title`, cleaned and capped — what the clip is called wherever it appears. Absent when none was given, in which case the episode's own title is used.", "type": "string" }, "kind": { "enum": [ "audio" ], "type": "string" }, "lengthSeconds": { "type": "number" }, "show": { "type": "string" }, "showUrl": { "format": "uri", "type": "string" }, "sourceUrl": { "description": "Exactly what was passed in. Never rewritten — that's the promise.", "format": "uri", "type": "string" }, "start": { "type": "number" }, "title": { "description": "The episode, as resolved. Check it before you share the link.", "type": "string" } }, "required": [ "kind", "sourceUrl", "start", "end", "lengthSeconds" ], "type": "object" }, "links": { "properties": { "mp3": { "description": "The clip as a file. Audio only, 10 minutes at most.", "format": "uri", "type": "string" }, "page": { "description": "The clip, in a link that contains the whole clip.", "format": "uri", "type": "string" }, "short": { "format": "uri", "type": "string" }, "sourceAtMoment": { "description": "The publisher's own URL at that moment — no BitePods in the middle.", "format": "uri", "type": "string" } }, "required": [ "page", "sourceAtMoment" ], "type": "object" }, "note": { "type": "string" }, "plays": { "description": "Approximate: a per-clip counter, not an audit trail.", "type": "integer" }, "shareText": { "type": "string" }, "shortId": { "description": "The id in `/x/<id>`, when one was registered.", "type": "string" }, "shortened": { "type": "boolean" } }, "required": [ "clip", "links", "shareText" ], "type": "object" }, "Episode": { "properties": { "artwork": { "format": "uri", "type": "string" }, "audioUrl": { "description": "The publisher's audio file, for an audio episode.", "format": "uri", "type": "string" }, "chapters": { "description": "The publisher's own chapter marks, read from the episode notes. Absent when the show doesn't publish an index.", "items": { "$ref": "#/$defs/Chapter" }, "type": "array" }, "clipUrl": { "description": "Pass this back as `url` to create_clip or get_transcript.", "format": "uri", "type": "string" }, "durationSeconds": { "type": "number" }, "hasTranscript": { "description": "Whether get_transcript will have anything to read.", "type": "boolean" }, "kind": { "description": "How it plays back.", "enum": [ "audio" ], "type": "string" }, "pageUrl": { "description": "The episode's own web page, when it has one of its own.", "format": "uri", "type": "string" }, "publishedAt": { "description": "Unix seconds, when the source gave a date.", "type": "integer" }, "showUrl": { "description": "The show this came out of. Pass it to create_clip alongside `url`.", "format": "uri", "type": "string" }, "title": { "type": "string" }, "transcriptUrl": { "format": "uri", "type": "string" } }, "required": [ "title", "kind", "clipUrl", "hasTranscript" ], "type": "object" }, "EpisodeList": { "properties": { "episodes": { "items": { "$ref": "#/$defs/Episode" }, "type": "array" }, "hasMore": { "type": "boolean" }, "limit": { "type": "integer" }, "offset": { "type": "integer" }, "show": { "properties": { "artwork": { "format": "uri", "type": "string" }, "author": { "type": "string" }, "name": { "type": "string" }, "sourceUrl": { "format": "uri", "type": "string" } }, "type": "object" }, "total": { "description": "Episodes the source listed, up to the 60-item cap.", "type": "integer" } }, "required": [ "show", "episodes", "total", "offset", "limit", "hasMore" ], "type": "object" }, "Error": { "properties": { "docs": { "format": "uri", "type": "string" }, "error": { "properties": { "code": { "description": "The stable part. Branch on this, not on the wording.", "type": "string" }, "hint": { "description": "The call to make instead.", "type": "string" }, "message": { "type": "string" } }, "required": [ "code", "message" ], "type": "object" } }, "required": [ "error" ], "type": "object" }, "Resolution": { "description": "Read `type` first. All three are 200s: an unresolvable link is an answer, not a failure.", "oneOf": [ { "properties": { "episode": { "$ref": "#/$defs/ResolvedEpisode" }, "type": { "const": "episode" } }, "required": [ "type", "episode" ], "title": "episode", "type": "object" }, { "properties": { "episodeCount": { "type": "integer" }, "episodes": { "description": "The first few; list_episodes returns the rest.", "items": { "$ref": "#/$defs/Episode" }, "type": "array" }, "more": { "type": "string" }, "show": { "type": "object" }, "type": { "const": "show" } }, "required": [ "type", "show", "episodeCount", "episodes" ], "title": "show", "type": "object" }, { "properties": { "message": { "description": "Why nothing playable was found.", "type": "string" }, "type": { "const": "unresolved" }, "url": { "type": "string" } }, "required": [ "type", "url", "message" ], "title": "unresolved", "type": "object" } ] }, "ResolvedEpisode": { "description": "One playable episode. Nearly an `Episode`, but `sourceUrl` is the URL you passed in, unchanged — and a page that names nothing still resolves, so `title` can be absent.", "properties": { "artwork": { "format": "uri", "type": "string" }, "audioUrl": { "format": "uri", "type": "string" }, "clipUrl": { "description": "Pass this back as `url` to create_clip or get_transcript.", "format": "uri", "type": "string" }, "durationSeconds": { "type": "number" }, "hasTranscript": { "type": "boolean" }, "kind": { "enum": [ "audio" ], "type": "string" }, "show": { "type": "string" }, "showUrl": { "format": "uri", "type": "string" }, "sourceUrl": { "description": "Exactly what was passed in.", "format": "uri", "type": "string" }, "title": { "type": "string" }, "transcriptUrl": { "format": "uri", "type": "string" } }, "required": [ "kind", "sourceUrl", "clipUrl", "hasTranscript" ], "type": "object" }, "Show": { "description": "A show in the public podcast directory. Not playable on its own — resolve `sourceUrl` into episodes.", "properties": { "artwork": { "format": "uri", "type": "string" }, "author": { "description": "The publisher, as the directory names it.", "type": "string" }, "feedUrl": { "description": "The show's RSS feed, when the directory names one.", "format": "uri", "type": "string" }, "id": { "description": "Stable within one answer; Apple's collection id when Apple answered.", "type": "string" }, "name": { "type": "string" }, "pageUrl": { "description": "The show's Apple Podcasts page.", "format": "uri", "type": "string" }, "rank": { "description": "1-based chart position, on chart answers only.", "type": "integer" }, "sourceUrl": { "description": "What to pass to list_episodes: the feed, or the Apple page as a fallback.", "format": "uri", "type": "string" } }, "required": [ "id", "name" ], "type": "object" }, "ShowResults": { "properties": { "country": { "description": "Chart answers only: the country the chart is for.", "type": "string" }, "shows": { "items": { "$ref": "#/$defs/Show" }, "type": "array" } }, "required": [ "shows" ], "type": "object" }, "Transcript": { "description": "The publisher's own transcript, timed in seconds from the start of the episode.", "properties": { "available": { "type": "boolean" }, "episode": { "properties": { "clipUrl": { "type": "string" }, "durationSeconds": { "type": "number" }, "kind": { "type": "string" }, "show": { "type": "string" }, "title": { "type": "string" } }, "type": "object" }, "estimated": { "description": "True when long cues were split, so the split times are interpolated.", "type": "boolean" }, "lineCount": { "type": "integer" }, "lines": { "items": { "properties": { "end": { "type": "number" }, "speaker": { "description": "When the transcript says who's talking.", "type": "string" }, "start": { "description": "Seconds from the start of the episode — pass it to create_clip as-is.", "type": "number" }, "text": { "type": "string" } }, "required": [ "start", "end", "text" ], "type": "object" }, "type": "array" }, "reason": { "description": "Why there are no lines, when `available` is false.", "type": "string" }, "totalLines": { "type": "integer" }, "transcriptUrl": { "format": "uri", "type": "string" }, "truncated": { "description": "True when `limit` cut the answer; narrow the window or raise it.", "type": "boolean" }, "window": { "properties": { "end": { "type": [ "number", "null" ] }, "start": { "type": "number" } }, "type": "object" } }, "required": [ "available", "episode" ], "type": "object" } }, "description": "Read `type` first. All three are 200s: an unresolvable link is an answer, not a failure.", "oneOf": [ { "properties": { "episode": { "$ref": "#/$defs/ResolvedEpisode" }, "type": { "const": "episode" } }, "required": [ "type", "episode" ], "title": "episode", "type": "object" }, { "properties": { "episodeCount": { "type": "integer" }, "episodes": { "description": "The first few; list_episodes returns the rest.", "items": { "$ref": "#/$defs/Episode" }, "type": "array" }, "more": { "type": "string" }, "show": { "type": "object" }, "type": { "const": "show" } }, "required": [ "type", "show", "episodeCount", "episodes" ], "title": "show", "type": "object" }, { "properties": { "message": { "description": "Why nothing playable was found.", "type": "string" }, "type": { "const": "unresolved" }, "url": { "type": "string" } }, "required": [ "type", "url", "message" ], "title": "unresolved", "type": "object" } ] } }, { "description": "Searches the public podcast directory by show name. Use it when you have a name rather than a link. Each hit carries the show's RSS feed as `sourceUrl` — hand that to `list_episodes`. It searches shows, never episodes: there is no index of episode titles to search, so finding one episode means listing a show's episodes and matching the title yourself. Shows Apple rates explicit are left out.\n\nReturns `{ shows }` — id, name, author, artwork, feed, and the `sourceUrl` to list episodes from.\n\nUsually followed by: list_episodes with a show's sourceUrl.", "inputSchema": { "additionalProperties": false, "properties": { "limit": { "default": 12, "description": "How many shows to return, at most. Clamped to 25.", "maximum": 25, "minimum": 1, "type": "integer" }, "q": { "description": "The show's name, or enough of it to be distinctive. Two characters minimum.", "examples": [ "hard fork" ], "type": "string" } }, "required": [ "q" ], "type": "object" }, "name": "search_shows", "outputSchema": { "$defs": { "Chapter": { "description": "A moment the publisher named, from their own timestamp index.", "properties": { "startSeconds": { "description": "Seconds from the start of the episode. Pass it to create_clip as `start`.", "type": "number" }, "title": { "description": "The publisher's own words for this stretch.", "type": "string" } }, "required": [ "startSeconds", "title" ], "type": "object" }, "Clip": { "properties": { "clip": { "properties": { "artwork": { "format": "uri", "type": "string" }, "audioUrl": { "format": "uri", "type": "string" }, "durationSeconds": { "type": "number" }, "end": { "type": "number" }, "headline": { "description": "The title passed as `title`, cleaned and capped — what the clip is called wherever it appears. Absent when none was given, in which case the episode's own title is used.", "type": "string" }, "kind": { "enum": [ "audio" ], "type": "string" }, "lengthSeconds": { "type": "number" }, "show": { "type": "string" }, "showUrl": { "format": "uri", "type": "string" }, "sourceUrl": { "description": "Exactly what was passed in. Never rewritten — that's the promise.", "format": "uri", "type": "string" }, "start": { "type": "number" }, "title": { "description": "The episode, as resolved. Check it before you share the link.", "type": "string" } }, "required": [ "kind", "sourceUrl", "start", "end", "lengthSeconds" ], "type": "object" }, "links": { "properties": { "mp3": { "description": "The clip as a file. Audio only, 10 minutes at most.", "format": "uri", "type": "string" }, "page": { "description": "The clip, in a link that contains the whole clip.", "format": "uri", "type": "string" }, "short": { "format": "uri", "type": "string" }, "sourceAtMoment": { "description": "The publisher's own URL at that moment — no BitePods in the middle.", "format": "uri", "type": "string" } }, "required": [ "page", "sourceAtMoment" ], "type": "object" }, "note": { "type": "string" }, "plays": { "description": "Approximate: a per-clip counter, not an audit trail.", "type": "integer" }, "shareText": { "type": "string" }, "shortId": { "description": "The id in `/x/<id>`, when one was registered.", "type": "string" }, "shortened": { "type": "boolean" } }, "required": [ "clip", "links", "shareText" ], "type": "object" }, "Episode": { "properties": { "artwork": { "format": "uri", "type": "string" }, "audioUrl": { "description": "The publisher's audio file, for an audio episode.", "format": "uri", "type": "string" }, "chapters": { "description": "The publisher's own chapter marks, read from the episode notes. Absent when the show doesn't publish an index.", "items": { "$ref": "#/$defs/Chapter" }, "type": "array" }, "clipUrl": { "description": "Pass this back as `url` to create_clip or get_transcript.", "format": "uri", "type": "string" }, "durationSeconds": { "type": "number" }, "hasTranscript": { "description": "Whether get_transcript will have anything to read.", "type": "boolean" }, "kind": { "description": "How it plays back.", "enum": [ "audio" ], "type": "string" }, "pageUrl": { "description": "The episode's own web page, when it has one of its own.", "format": "uri", "type": "string" }, "publishedAt": { "description": "Unix seconds, when the source gave a date.", "type": "integer" }, "showUrl": { "description": "The show this came out of. Pass it to create_clip alongside `url`.", "format": "uri", "type": "string" }, "title": { "type": "string" }, "transcriptUrl": { "format": "uri", "type": "string" } }, "required": [ "title", "kind", "clipUrl", "hasTranscript" ], "type": "object" }, "EpisodeList": { "properties": { "episodes": { "items": { "$ref": "#/$defs/Episode" }, "type": "array" }, "hasMore": { "type": "boolean" }, "limit": { "type": "integer" }, "offset": { "type": "integer" }, "show": { "properties": { "artwork": { "format": "uri", "type": "string" }, "author": { "type": "string" }, "name": { "type": "string" }, "sourceUrl": { "format": "uri", "type": "string" } }, "type": "object" }, "total": { "description": "Episodes the source listed, up to the 60-item cap.", "type": "integer" } }, "required": [ "show", "episodes", "total", "offset", "limit", "hasMore" ], "type": "object" }, "Error": { "properties": { "docs": { "format": "uri", "type": "string" }, "error": { "properties": { "code": { "description": "The stable part. Branch on this, not on the wording.", "type": "string" }, "hint": { "description": "The call to make instead.", "type": "string" }, "message": { "type": "string" } }, "required": [ "code", "message" ], "type": "object" } }, "required": [ "error" ], "type": "object" }, "Resolution": { "description": "Read `type` first. All three are 200s: an unresolvable link is an answer, not a failure.", "oneOf": [ { "properties": { "episode": { "$ref": "#/$defs/ResolvedEpisode" }, "type": { "const": "episode" } }, "required": [ "type", "episode" ], "title": "episode", "type": "object" }, { "properties": { "episodeCount": { "type": "integer" }, "episodes": { "description": "The first few; list_episodes returns the rest.", "items": { "$ref": "#/$defs/Episode" }, "type": "array" }, "more": { "type": "string" }, "show": { "type": "object" }, "type": { "const": "show" } }, "required": [ "type", "show", "episodeCount", "episodes" ], "title": "show", "type": "object" }, { "properties": { "message": { "description": "Why nothing playable was found.", "type": "string" }, "type": { "const": "unresolved" }, "url": { "type": "string" } }, "required": [ "type", "url", "message" ], "title": "unresolved", "type": "object" } ] }, "ResolvedEpisode": { "description": "One playable episode. Nearly an `Episode`, but `sourceUrl` is the URL you passed in, unchanged — and a page that names nothing still resolves, so `title` can be absent.", "properties": { "artwork": { "format": "uri", "type": "string" }, "audioUrl": { "format": "uri", "type": "string" }, "clipUrl": { "description": "Pass this back as `url` to create_clip or get_transcript.", "format": "uri", "type": "string" }, "durationSeconds": { "type": "number" }, "hasTranscript": { "type": "boolean" }, "kind": { "enum": [ "audio" ], "type": "string" }, "show": { "type": "string" }, "showUrl": { "format": "uri", "type": "string" }, "sourceUrl": { "description": "Exactly what was passed in.", "format": "uri", "type": "string" }, "title": { "type": "string" }, "transcriptUrl": { "format": "uri", "type": "string" } }, "required": [ "kind", "sourceUrl", "clipUrl", "hasTranscript" ], "type": "object" }, "Show": { "description": "A show in the public podcast directory. Not playable on its own — resolve `sourceUrl` into episodes.", "properties": { "artwork": { "format": "uri", "type": "string" }, "author": { "description": "The publisher, as the directory names it.", "type": "string" }, "feedUrl": { "description": "The show's RSS feed, when the directory names one.", "format": "uri", "type": "string" }, "id": { "description": "Stable within one answer; Apple's collection id when Apple answered.", "type": "string" }, "name": { "type": "string" }, "pageUrl": { "description": "The show's Apple Podcasts page.", "format": "uri", "type": "string" }, "rank": { "description": "1-based chart position, on chart answers only.", "type": "integer" }, "sourceUrl": { "description": "What to pass to list_episodes: the feed, or the Apple page as a fallback.", "format": "uri", "type": "string" } }, "required": [ "id", "name" ], "type": "object" }, "ShowResults": { "properties": { "country": { "description": "Chart answers only: the country the chart is for.", "type": "string" }, "shows": { "items": { "$ref": "#/$defs/Show" }, "type": "array" } }, "required": [ "shows" ], "type": "object" }, "Transcript": { "description": "The publisher's own transcript, timed in seconds from the start of the episode.", "properties": { "available": { "type": "boolean" }, "episode": { "properties": { "clipUrl": { "type": "string" }, "durationSeconds": { "type": "number" }, "kind": { "type": "string" }, "show": { "type": "string" }, "title": { "type": "string" } }, "type": "object" }, "estimated": { "description": "True when long cues were split, so the split times are interpolated.", "type": "boolean" }, "lineCount": { "type": "integer" }, "lines": { "items": { "properties": { "end": { "type": "number" }, "speaker": { "description": "When the transcript says who's talking.", "type": "string" }, "start": { "description": "Seconds from the start of the episode — pass it to create_clip as-is.", "type": "number" }, "text": { "type": "string" } }, "required": [ "start", "end", "text" ], "type": "object" }, "type": "array" }, "reason": { "description": "Why there are no lines, when `available` is false.", "type": "string" }, "totalLines": { "type": "integer" }, "transcriptUrl": { "format": "uri", "type": "string" }, "truncated": { "description": "True when `limit` cut the answer; narrow the window or raise it.", "type": "boolean" }, "window": { "properties": { "end": { "type": [ "number", "null" ] }, "start": { "type": "number" } }, "type": "object" } }, "required": [ "available", "episode" ], "type": "object" } }, "properties": { "country": { "description": "Chart answers only: the country the chart is for.", "type": "string" }, "shows": { "items": { "$ref": "#/$defs/Show" }, "type": "array" } }, "required": [ "shows" ], "type": "object" } }, { "description": "The most-subscribed shows in a country, ranked. Useful as a starting point when nothing specific was named, and as a way to check that a show is the well-known one rather than a similarly named feed. Country defaults to the one the request came from.\n\nReturns `{ country, shows }`, each show carrying its 1-based `rank`.\n\nUsually followed by: list_episodes with a show's sourceUrl.", "inputSchema": { "additionalProperties": false, "properties": { "country": { "description": "Two-letter ISO country code (`us`, `gb`, `de`). Defaults to the country the request arrives from, and to `us` when that is unknown.", "examples": [ "us" ], "type": "string" }, "limit": { "default": 20, "description": "How many shows to return, at most. Clamped to 100.", "maximum": 100, "minimum": 1, "type": "integer" } }, "type": "object" }, "name": "top_shows", "outputSchema": { "$defs": { "Chapter": { "description": "A moment the publisher named, from their own timestamp index.", "properties": { "startSeconds": { "description": "Seconds from the start of the episode. Pass it to create_clip as `start`.", "type": "number" }, "title": { "description": "The publisher's own words for this stretch.", "type": "string" } }, "required": [ "startSeconds", "title" ], "type": "object" }, "Clip": { "properties": { "clip": { "properties": { "artwork": { "format": "uri", "type": "string" }, "audioUrl": { "format": "uri", "type": "string" }, "durationSeconds": { "type": "number" }, "end": { "type": "number" }, "headline": { "description": "The title passed as `title`, cleaned and capped — what the clip is called wherever it appears. Absent when none was given, in which case the episode's own title is used.", "type": "string" }, "kind": { "enum": [ "audio" ], "type": "string" }, "lengthSeconds": { "type": "number" }, "show": { "type": "string" }, "showUrl": { "format": "uri", "type": "string" }, "sourceUrl": { "description": "Exactly what was passed in. Never rewritten — that's the promise.", "format": "uri", "type": "string" }, "start": { "type": "number" }, "title": { "description": "The episode, as resolved. Check it before you share the link.", "type": "string" } }, "required": [ "kind", "sourceUrl", "start", "end", "lengthSeconds" ], "type": "object" }, "links": { "properties": { "mp3": { "description": "The clip as a file. Audio only, 10 minutes at most.", "format": "uri", "type": "string" }, "page": { "description": "The clip, in a link that contains the whole clip.", "format": "uri", "type": "string" }, "short": { "format": "uri", "type": "string" }, "sourceAtMoment": { "description": "The publisher's own URL at that moment — no BitePods in the middle.", "format": "uri", "type": "string" } }, "required": [ "page", "sourceAtMoment" ], "type": "object" }, "note": { "type": "string" }, "plays": { "description": "Approximate: a per-clip counter, not an audit trail.", "type": "integer" }, "shareText": { "type": "string" }, "shortId": { "description": "The id in `/x/<id>`, when one was registered.", "type": "string" }, "shortened": { "type": "boolean" } }, "required": [ "clip", "links", "shareText" ], "type": "object" }, "Episode": { "properties": { "artwork": { "format": "uri", "type": "string" }, "audioUrl": { "description": "The publisher's audio file, for an audio episode.", "format": "uri", "type": "string" }, "chapters": { "description": "The publisher's own chapter marks, read from the episode notes. Absent when the show doesn't publish an index.", "items": { "$ref": "#/$defs/Chapter" }, "type": "array" }, "clipUrl": { "description": "Pass this back as `url` to create_clip or get_transcript.", "format": "uri", "type": "string" }, "durationSeconds": { "type": "number" }, "hasTranscript": { "description": "Whether get_transcript will have anything to read.", "type": "boolean" }, "kind": { "description": "How it plays back.", "enum": [ "audio" ], "type": "string" }, "pageUrl": { "description": "The episode's own web page, when it has one of its own.", "format": "uri", "type": "string" }, "publishedAt": { "description": "Unix seconds, when the source gave a date.", "type": "integer" }, "showUrl": { "description": "The show this came out of. Pass it to create_clip alongside `url`.", "format": "uri", "type": "string" }, "title": { "type": "string" }, "transcriptUrl": { "format": "uri", "type": "string" } }, "required": [ "title", "kind", "clipUrl", "hasTranscript" ], "type": "object" }, "EpisodeList": { "properties": { "episodes": { "items": { "$ref": "#/$defs/Episode" }, "type": "array" }, "hasMore": { "type": "boolean" }, "limit": { "type": "integer" }, "offset": { "type": "integer" }, "show": { "properties": { "artwork": { "format": "uri", "type": "string" }, "author": { "type": "string" }, "name": { "type": "string" }, "sourceUrl": { "format": "uri", "type": "string" } }, "type": "object" }, "total": { "description": "Episodes the source listed, up to the 60-item cap.", "type": "integer" } }, "required": [ "show", "episodes", "total", "offset", "limit", "hasMore" ], "type": "object" }, "Error": { "properties": { "docs": { "format": "uri", "type": "string" }, "error": { "properties": { "code": { "description": "The stable part. Branch on this, not on the wording.", "type": "string" }, "hint": { "description": "The call to make instead.", "type": "string" }, "message": { "type": "string" } }, "required": [ "code", "message" ], "type": "object" } }, "required": [ "error" ], "type": "object" }, "Resolution": { "description": "Read `type` first. All three are 200s: an unresolvable link is an answer, not a failure.", "oneOf": [ { "properties": { "episode": { "$ref": "#/$defs/ResolvedEpisode" }, "type": { "const": "episode" } }, "required": [ "type", "episode" ], "title": "episode", "type": "object" }, { "properties": { "episodeCount": { "type": "integer" }, "episodes": { "description": "The first few; list_episodes returns the rest.", "items": { "$ref": "#/$defs/Episode" }, "type": "array" }, "more": { "type": "string" }, "show": { "type": "object" }, "type": { "const": "show" } }, "required": [ "type", "show", "episodeCount", "episodes" ], "title": "show", "type": "object" }, { "properties": { "message": { "description": "Why nothing playable was found.", "type": "string" }, "type": { "const": "unresolved" }, "url": { "type": "string" } }, "required": [ "type", "url", "message" ], "title": "unresolved", "type": "object" } ] }, "ResolvedEpisode": { "description": "One playable episode. Nearly an `Episode`, but `sourceUrl` is the URL you passed in, unchanged — and a page that names nothing still resolves, so `title` can be absent.", "properties": { "artwork": { "format": "uri", "type": "string" }, "audioUrl": { "format": "uri", "type": "string" }, "clipUrl": { "description": "Pass this back as `url` to create_clip or get_transcript.", "format": "uri", "type": "string" }, "durationSeconds": { "type": "number" }, "hasTranscript": { "type": "boolean" }, "kind": { "enum": [ "audio" ], "type": "string" }, "show": { "type": "string" }, "showUrl": { "format": "uri", "type": "string" }, "sourceUrl": { "description": "Exactly what was passed in.", "format": "uri", "type": "string" }, "title": { "type": "string" }, "transcriptUrl": { "format": "uri", "type": "string" } }, "required": [ "kind", "sourceUrl", "clipUrl", "hasTranscript" ], "type": "object" }, "Show": { "description": "A show in the public podcast directory. Not playable on its own — resolve `sourceUrl` into episodes.", "properties": { "artwork": { "format": "uri", "type": "string" }, "author": { "description": "The publisher, as the directory names it.", "type": "string" }, "feedUrl": { "description": "The show's RSS feed, when the directory names one.", "format": "uri", "type": "string" }, "id": { "description": "Stable within one answer; Apple's collection id when Apple answered.", "type": "string" }, "name": { "type": "string" }, "pageUrl": { "description": "The show's Apple Podcasts page.", "format": "uri", "type": "string" }, "rank": { "description": "1-based chart position, on chart answers only.", "type": "integer" }, "sourceUrl": { "description": "What to pass to list_episodes: the feed, or the Apple page as a fallback.", "format": "uri", "type": "string" } }, "required": [ "id", "name" ], "type": "object" }, "ShowResults": { "properties": { "country": { "description": "Chart answers only: the country the chart is for.", "type": "string" }, "shows": { "items": { "$ref": "#/$defs/Show" }, "type": "array" } }, "required": [ "shows" ], "type": "object" }, "Transcript": { "description": "The publisher's own transcript, timed in seconds from the start of the episode.", "properties": { "available": { "type": "boolean" }, "episode": { "properties": { "clipUrl": { "type": "string" }, "durationSeconds": { "type": "number" }, "kind": { "type": "string" }, "show": { "type": "string" }, "title": { "type": "string" } }, "type": "object" }, "estimated": { "description": "True when long cues were split, so the split times are interpolated.", "type": "boolean" }, "lineCount": { "type": "integer" }, "lines": { "items": { "properties": { "end": { "type": "number" }, "speaker": { "description": "When the transcript says who's talking.", "type": "string" }, "start": { "description": "Seconds from the start of the episode — pass it to create_clip as-is.", "type": "number" }, "text": { "type": "string" } }, "required": [ "start", "end", "text" ], "type": "object" }, "type": "array" }, "reason": { "description": "Why there are no lines, when `available` is false.", "type": "string" }, "totalLines": { "type": "integer" }, "transcriptUrl": { "format": "uri", "type": "string" }, "truncated": { "description": "True when `limit` cut the answer; narrow the window or raise it.", "type": "boolean" }, "window": { "properties": { "end": { "type": [ "number", "null" ] }, "start": { "type": "number" } }, "type": "object" } }, "required": [ "available", "episode" ], "type": "object" } }, "properties": { "country": { "description": "Chart answers only: the country the chart is for.", "type": "string" }, "shows": { "items": { "$ref": "#/$defs/Show" }, "type": "array" } }, "required": [ "shows" ], "type": "object" } } ] }
Verify it yourselfcurl -s https://api.teppi.xyz/v1/evidence/sha256:169a601004c561c06c9bb12ef2378c8cae01aa281e6cb1c92d6ce06dbd385d15 | sha256sum