# youtube

> Search YouTube videos via Invidious API. Use when the user wants to find, search for, or look up videos, or asks for video recommendations on a topic.

- Author: devskale
- Repository: devskale/skale-skills
- Version: 20260127125813
- Stars: 0
- Forks: 0
- Last Updated: 2026-02-06
- Source: https://github.com/devskale/skale-skills
- Web: https://mule.run/skillshub/@@devskale/skale-skills~youtube:20260127125813

---

---
name: youtube
description: Search YouTube videos via Invidious API. Use when the user wants to find, search for, or look up videos, or asks for video recommendations on a topic.
---

# YouTube Video Search

Search YouTube videos using the Invidious API at `https://yt.tarka.dev`.

## How to Search

Run the included python script to search and get formatted results:

```bash
python3 search.py "<query>" [--num <number>] [--rank <relevance|date|views|rating>]
```

Options:

- `--num`: Number of results to return (default: 3)
- `--rank`: Sort order (default: relevance). Choices: `relevance`, `date`, `views`, `rating`, `ranking`

The script will output a markdown list of videos.

## Example

When user asks "find me a video about Clojure macros":

```bash
python3 search.py "Clojure macros"
```

When user asks "show me the most viewed videos about rust":

```bash
python3 search.py "rust lang" --rank views
```

When user asks "show me 3 recent videos about AI":

```bash
python3 search.py "artificial intelligence" --num 3 --rank date
```

Output:

- [**Clojure Tutorial**](https://yt.tarka.dev/watch?v=ciGyHkDuPAE) by Derek Banas - 175K views - 8 years ago - Duration: 1:11:23

## Notes

- If the script fails, check your internet connection.
- If no results are found, the script will output "No results found."