# CleanScript

> Clean transcripts, and the fields you ask for with a quote for each, from YouTube, TikTok and Instagram posts. One HTTP API, an MCP server and SDKs for Python and TypeScript.

- API base URL: https://api.cleanscript.ai
- Auth: `Authorization: Bearer $CLEANSCRIPT_API_KEY`. Keys: https://cleanscript.ai/dashboard/api-keys (100 free credits, no card).
- MCP server: https://api.cleanscript.ai/mcp (OAuth sign-in, or the same Bearer key).

Get a transcript (`text`, plus paragraphs in `sections`):

```bash
curl -G https://api.cleanscript.ai/v1/transcript \
  -H "Authorization: Bearer $CLEANSCRIPT_API_KEY" \
  --data-urlencode "url=https://youtu.be/jwnez8HdN7E"
```

Ask a question, or send a `preset` or JSON `schema` (returns `data` and `citations`, a quote for each value):

```bash
curl https://api.cleanscript.ai/v1/extract \
  -H "Authorization: Bearer $CLEANSCRIPT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url": "https://youtu.be/jwnez8HdN7E", "prompt": "What does it say about pricing?"}'
```

SDKs: `pip install cleanscript-ai` (`from cleanscript_ai import CleanScript`) or `npm install cleanscript` (`import { CleanScript } from "cleanscript"`); both read `CLEANSCRIPT_API_KEY`.

## Docs

### Start

- [CleanScript docs](https://cleanscript.ai/docs/index.md): Turn a YouTube, TikTok or Instagram post into a clean transcript, or into the fields you ask for, each with the quote and the moment it came from.
- [Quickstart](https://cleanscript.ai/docs/quickstart.md): Create a key, send one request, read the transcript.
- [Agents & MCP](https://cleanscript.ai/docs/agents.md): Connect Claude, ChatGPT, Cursor, Codex or Claude Code to CleanScript, or let a coding agent build it into your project.

### Guides

- [Transcripts](https://cleanscript.ai/docs/transcripts.md): Get a post's words as clean text, paragraphs and sections, in the language you read.
- [Extract fields](https://cleanscript.ai/docs/extract.md): Ask a question, pick a preset or send your own JSON Schema; get JSON back with a quote and a moment for every value.
- [Creator posts](https://cleanscript.ai/docs/posts.md): List a creator's recent posts, and check for new ones on a schedule.
- [Batches & automations](https://cleanscript.ai/docs/automations.md): Run CleanScript from n8n, Make or Zapier, and process many posts from code.

### Reference

- [Credits & limits](https://cleanscript.ai/docs/credits.md): What each request costs, what is free, the limits, and every error code with what to do.
- [API reference](https://cleanscript.ai/docs/api-reference.md): Every route, parameter and field, with request and response examples.

## Guides

- [Guides](https://cleanscript.ai/blog): how-tos for common jobs. Each is also Markdown at `/blog/<slug>.md`.

## Machine-readable

- [OpenAPI](https://cleanscript.ai/openapi.json): routes, parameters and examples.
- [integration.json](https://cleanscript.ai/integration.json): routes, presets, credits and links as JSON.
- [SKILL.md](https://cleanscript.ai/SKILL.md): a skill for coding agents adding CleanScript to a project.
- [llms-full.txt](https://cleanscript.ai/llms-full.txt): every docs page in one file.