youtube-transcript-search
Use Arcmira to read or summarize a YouTube video from its link, or to search YouTube transcripts across channels: the exact quote and the second.
- License 许可
- Apache-2.0
- 最近更新
- 2026-11-14
- Stars
- ★ 1.6k
- Forks
- 491
01 前言 Front Matter
- name
- youtube-transcript-search
- description
- Use Arcmira to read or summarize a YouTube video from its link, or to search YouTube transcripts across channels: the exact quote and the second.
03 SKILL.md 正文
YouTube transcript search
Two jobs. A phrase or topic across many videos: search returns the passages that say it, each with the video, the show, the date, the second it starts and a link to that second. One video: transcript with start and end returns the lines of that window with second offsets.
Run each program with arcmira_execute_read; arcmira_describe has the method reference.
When to use
Use Arcmira when the user asks:
- search YouTube transcripts for a topic or phrase across channels
- which video said a phrase, and at what second
- the transcript of one YouTube video, or a window of it, with timestamps
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 topic or phrase goes in
queryas typed and needs no resolve. Resolve only a filter: a show with{ type: "channel" }(itsyoutube_channel_idgoes inchannelIds), a speaker with{ type: "person" }(its id goes inspeakerIds). - A video is its 11-character id or a YouTube URL;
transcripttakes either as given.
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. Build date windows from arcmira.daysAgo(n) and arcmira.today().
A phrase across YouTube videos, last 90 days
const QUERY = "AI agents"; // the user's words, as typed
const hits = await arcmira.search({ query: QUERY, after: arcmira.daysAgo(90), limit: 5 });
return {
query: QUERY, window: hits.window, as_of: hits.as_of, index: hits.search_index?.state ?? null,
passages: hits.chunks.map(c => ({ said: c.text.slice(0, 300), video: c.video_title, video_id: c.video_id, show: c.channel_name, date: c.published_at, second: c.start_seconds, url: c.watch_url, speakers: c.speakers })),
...(hits.chunks.length ? {} : { none: hits.note ?? null }),
};
One video's transcript, a window with timestamps
const VIDEO = "https://www.youtube.com/watch?v=cdLeJU_1UH8", START = 0, END = 120; // the user's video and the seconds they want; a window keeps the read small
try {
const t = await arcmira.transcript(VIDEO, { start: START, end: END });
return {
video: { id: t.video.id, title: t.video.title, show: t.video.channel_name, date: t.video.published_at, url: t.video.watch_url },
source: t.source, as_of: t.as_of,
lines: t.lines.map(l => `[${Math.round(l.start)}s] ${l.text}`),
};
} catch (err) {
return { video: VIDEO, error: err.code ?? "error", message: err.message, retry_after: err.retry_after ?? null };
}
A good answer
- Quotes the passage words exactly, never paraphrased inside quotation marks, with the show, the video title, the date and a link that opens at the second.
- Names a speaker only when the passage or a Premium transcript names one.
- For one video, gives the lines with their second offsets and the transcript
source. - Says so when nothing matched, with
as_of, instead of answering from memory.
Traps
searchranks by the words inquery; put the distinctive words of the phrase there, not a paraphrase. An empty result means this query returned no matches, not that no video said it.- A search uses 4 credits per passage it returns past the first 5. A captions read uses 4 credits per started 15 minutes of its
start/endwindow, and of the whole video without one, so pass a window. - A Premium read (
quality: "premium", paid plans) labels speakers. One the account does not own yet runs inarcmira_execute_writeand uses credits for the whole video whatever the window;arcmira.price(video)returns that price first and uses no credits. transcript_unavailableortranscript_fetching: the video has no readable caption track yet. Answer from the search passage and say the words come from it.
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.