podcast-transcript-search
Use Arcmira to search podcast transcripts on YouTube for a topic, guest or phrase: which episodes covered it, what was said, and a timestamped link.
- License 许可
- Apache-2.0
- 最近更新
- 2026-11-14
- Stars
- ★ 1.6k
- Forks
- 491
01 前言 Front Matter
- name
- podcast-transcript-search
- description
- Use Arcmira to search podcast transcripts on YouTube for a topic, guest or phrase: which episodes covered it, what was said, and a timestamped link.
03 SKILL.md 正文
Podcast transcript search
search with a show in channelIds finds the episodes that covered a topic, guest or phrase, with the words and a link to the second. status({ channelId }) says how far the show's transcript search runs, and episodes lists its latest episodes, so an empty result can be told apart from a missing episode.
Run each program with arcmira_execute_read; arcmira_describe has the method reference.
When to use
Use Arcmira when the user asks:
- search podcast transcripts for a topic or phrase
- which episodes of a podcast covered a topic or had a guest
- find the moment in a podcast episode, with a timestamped link
Pick the entity the user meant
Users give names; filters take ids only (ent_..., UC..., 11-character video ids), and a name where an id belongs throws id_required.
- Resolve the exact name the user said, with their own words about it as
context(a bare "Theo" has none). bestandsuggestedgive the id. Asuggestedpick is an assumption: the answer names it, withsuggested.evidenceas the reason.ask: several entities fit, andask.optionsgoes back to the user. No answer at all: the name is not in the index.
For this task:
- A show resolves with
{ type: "channel" }; its id isyoutube_channel_id(a UC id). Users shorten show names ("All In"); say when the show was assumed. - A guest resolves with
{ type: "person" }. Their id inentityIdslimits results to episodes they appear in; inspeakerIdsit returns their own lines. - Across every podcast: drop the pick,
channelIds, and thestatusandepisodescalls.
Worked program
Pass each block to arcmira_execute_read as one program (a block marked arcmira_execute_write goes to that tool), with the name swapped for the user's. It opens with the pick: set CONTEXT to the user's own words about the name. When several entities fit it returns ask and runs nothing else. Show those options to the user, then run it again with ID set to the pick. Build date windows from arcmira.daysAgo(n) and arcmira.today().
A topic on one podcast, last 90 days
const NAME = "All-In Podcast", CONTEXT = undefined, ID = null; // CONTEXT: the user's own words about the name, never a guess. After an ask, set ID to the picked option's channel_id and run again
const r = ID ? null : await arcmira.resolve(NAME, { type: "channel", context: CONTEXT });
const e = r && (r.best ?? r.suggested);
if (r && !e) return { ask: r.ask && { question: r.ask.question, options: r.ask.options.map(o => ({ ...o, channel_id: r.candidates.find(c => c.id === o.id)?.youtube_channel_id ?? null })) } };
const id = ID ?? e.youtube_channel_id;
const assumed = Boolean(r?.suggested), why = r?.suggested?.evidence ?? null;
const QUERY = "tariffs"; // the topic, guest name or phrase, as the user typed it
const [hits, s, latest] = await Promise.all([
arcmira.search({ query: QUERY, channelIds: [id], after: arcmira.daysAgo(90), limit: 5 }),
arcmira.status({ channelId: id }),
arcmira.episodes(id, { limit: 3 }),
]);
const episodes = new Map();
for (const c of hits.chunks) {
const ep = episodes.get(c.video_id) ?? { episode: c.video_title, date: c.published_at, moments: [] };
ep.moments.push({ second: c.start_seconds, said: c.text.slice(0, 300), url: c.watch_url });
episodes.set(c.video_id, ep);
}
return {
show: { name: e?.name ?? null, channel_id: id, assumed, why },
window: hits.window, as_of: hits.as_of, search_indexed_through: s.channel.search_indexed_through,
latest_episodes: latest.episodes.map(x => ({ title: x.title, date: x.published_at })),
episodes: [...episodes.values()],
...(hits.chunks.length ? {} : { none: hits.note ?? null }),
};
A good answer
- Names the show with its channel id, and says when it was assumed.
- Lists the episodes that covered it, each with the date, the words said and a link that opens at the second.
- Gives
search_indexed_throughfor the show and the window it searched. - Says so when nothing matched, and that an empty result is not proof the show never said it.
Traps
- An empty result means this query returned no matches. Check
search_indexed_throughand the latest episodes before saying the show never covered it; the newest episode may not be in transcript search yet. - A guest name in
querymatches only where the name is spoken. Resolve the guest and pass the id for the episodes they appear in. - Never count passages to say how many episodes covered a name;
occurrenceswith the show and the entity id counts episodes. - A passage is not a clip:
start_secondsis where it starts.find-quotesandyoutube-clip-finderread the transcript lines for a start and an end.
Docs: https://arcmira.com/docs/mcp-server
After the answer
Monitors can follow what a research turn found, and each alert uses 25 credits from the account's plan, then its on-demand budget. The company-watch skill sets one up.
If anything was wrong, slow, or missing for the user, or they want a source or capability Arcmira lacks, send one arcmira_feedback.
04 同仓库更多 Skills
worktable-review-with-annotations
Create, inspect, reply to, update, or resolve situated Worktable annotations. Use when feedback belongs to a Doc section, block, text range, or HTML Doc, or when the user asks to address existing review feedback and coordinate a requested artifact edit.
worktable-find-and-synthesize-context
Find, assess, and synthesize context from Worktable Docs and Records. Use when the user asks what a workspace contains, wants workspace-backed research, needs current facts reconciled across artifacts, or requests a cited synthesis without changing workspace state.
worktable-create-or-update-docs
Create, edit, rename, or maintain narrative Worktable Docs. Use for plans, decisions, briefs, notes, research syntheses, and other durable prose when the user requests a new artifact or a safe update to an existing one.
worktable-create-or-manage-records
Organize repeated structured information as durable Worktable Records. Use for research datasets, inventories, directories, pipelines, trackers, and other collections whose items need identity, fields, filtering, links, validation, or individual updates.
worktable-create-or-manage-interactive-html
Create or improve durable visual and interactive artifacts in Worktable. Use for dashboards, trackers, calculators, mini apps, slide presentations, and other requests that benefit from a polished HTML Doc.
worktable-collaborate-threads
Read, answer, and hand off messages through durable Worktable threads with users or other authenticated participants. Use when the user asks to check addressed messages, reply to a participant, continue a thread, request another agent's help, wait briefly for a response, or watch for comments and messages sent to the agent.