Metadata-Version: 2.5
Name: crewai-getyoutubetranscript
Version: 0.1.0
Summary: YouTube transcript tools for CrewAI agents: get YouTube video transcripts with timestamps, search YouTube, and list channel videos, via the GetYouTubeTranscript API.
Project-URL: Homepage, https://getyoutubetranscript.com
Project-URL: Documentation, https://github.com/tubeagentkit/crewai-getyoutubetranscript#readme
Project-URL: Repository, https://github.com/tubeagentkit/crewai-getyoutubetranscript
Project-URL: API reference, https://getyoutubetranscript.com/docs
Project-URL: Get an API key, https://getyoutubetranscript.com/dashboard
Author: tubeagentkit
License: MIT
License-File: LICENSE
Keywords: agents,agents-tools,captions,crewai,crewai-tools,llm,rag,subtitles,tools,transcript,youtube,youtube-search,youtube-transcript
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Multimedia :: Video
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Python: >=3.10
Requires-Dist: crewai>=0.80.0
Requires-Dist: getyoutubetranscript<1.0.0,>=0.3.0
Provides-Extra: test
Requires-Dist: pytest>=7.0; extra == 'test'
Description-Content-Type: text/markdown

# crewai-getyoutubetranscript

YouTube transcript tools for [CrewAI](https://www.crewai.com) agents, powered by the [GetYouTubeTranscript](https://getyoutubetranscript.com) API. Let your crew read any YouTube video's transcript (optionally with `[m:ss]` timestamps), search YouTube, and list a channel's videos.

The API fetches transcripts on its own servers, so it works from cloud servers without proxies, and without `RequestBlocked` / `IpBlocked` errors.

## Install

```bash
pip install crewai-getyoutubetranscript
```

Get an API key at [getyoutubetranscript.com/dashboard](https://getyoutubetranscript.com/dashboard) (free tier included):

```bash
export GETYOUTUBETRANSCRIPT_API_KEY=sk_live_...
```

Or pass `api_key="..."` to any tool.

## Tools

| Class | What it does |
| --- | --- |
| `GetYouTubeTranscriptTool` | Transcript of a video (URL or ID) with title and channel. `timestamps=True` gives `[m:ss]` lines. |
| `YouTubeSearchTool` | Search YouTube for videos or channels. JSON with a `continuation_token` for the next page. |
| `YouTubeChannelVideosTool` | A channel's videos (by @handle, URL or ID), newest first, page by page. |

API errors (no captions, invalid video, out of credits) come back to the agent as `Error: ...` text instead of raising.

## Example

```python
from crewai import Agent, Crew, Task
from crewai_getyoutubetranscript import GetYouTubeTranscriptTool, YouTubeSearchTool

researcher = Agent(
    role="Video researcher",
    goal="Find the best YouTube talks on a topic and summarize them with timestamps",
    backstory="You turn long videos into short, cited notes.",
    tools=[YouTubeSearchTool(), GetYouTubeTranscriptTool()],
)

task = Task(
    description="Find a talk about vector databases and summarize its key points with [m:ss] timestamps.",
    expected_output="A bullet list of key points, each with a timestamp.",
    agent=researcher,
)

print(Crew(agents=[researcher], tasks=[task]).kickoff())
```

Use a tool directly:

```python
print(GetYouTubeTranscriptTool().run(video="https://youtu.be/jNQXAC9IVRw", timestamps=True))
```

## Pricing

Each transcript, search or channel page uses one credit from your GetYouTubeTranscript account. Failed requests are not charged.

## Links

- [GetYouTubeTranscript API docs](https://getyoutubetranscript.com/docs)
- [Python SDK](https://pypi.org/project/getyoutubetranscript/) (this package is built on it)
- [License: MIT](LICENSE)
