---
name: toolsmith-api.dassad10.workers.dev
description: toolsmith-api.dassad10.workers.dev exposes a single skill that retrieves the plain-text transcript of a YouTube video given a video ID or URL. It cleans and de-duplicates auto-caption output and returns the full spoken text along with character and word count statistics.
host: toolsmith-api.dassad10.workers.dev
---

# toolsmith-api.dassad10.workers.dev

This host is a narrow, single-purpose utility for extracting spoken content from YouTube videos. It serves agents that need to process, summarize, or analyze video dialogue as text. It does not provide video metadata, search, or live-stream capabilities.

## When to use this host

Use this host when an agent needs the spoken content of a recorded YouTube video as plain text — for example, to summarize a lecture, answer questions about a video, or feed dialogue into an LLM. Do not use it for retrieving video metadata (title, description, view count, channel info); use the YouTube Data API v3 instead. Do not use it for live streams or real-time transcription; a dedicated streaming speech-to-text service is required for that. With only one skill available, there is no multi-step orchestration value within this host itself.

## Capabilities

### Transcript Retrieval

Fetches and cleans the full spoken-word transcript of a YouTube video, returning plain text plus character and word count stats suitable for downstream LLM processing.

- **`fetch-youtube-transcript`** — Fetches the full plain-text transcript of a YouTube video by video ID or URL, de-duplicated and cleaned from auto-captions, with character and word count stats.

## Skill reference

### `fetch-youtube-transcript`

**YouTube Transcript Fetcher** — Fetches the full plain-text transcript of a YouTube video by video ID or URL, de-duplicated and cleaned from auto-captions, with character and word count stats.

*Use when:* Use when an agent needs the spoken content of a YouTube video as plain text, such as for summarization, question answering, or feeding video content to an LLM.

*Not for:* Do not use for real-time or live stream transcription, or for retrieving video metadata (title, description, views); use a YouTube Data API endpoint instead.

**Inputs:**

- `v` (string, required) — YouTube video ID or full YouTube URL to fetch the transcript for.

**Returns:** Returns a JSON object with videoId, chars (1897), words (412), a plain-text transcript string with no timestamps, and a note describing the de-duplication process.

**Example:** `GET https://toolsmith-api.dassad10.workers.dev/t/youtube/transcript?v=dQw4w9WgXcQ`

---