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:

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":

python3 search.py "Clojure macros"

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

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

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

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

Output:

• Clojure Tutorial 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."