# Youtube Search Api Skill

> Extrae automáticamente datos estructurados de resultados de búsqueda de YouTube (videos, shorts, canales, playlists) usando la API de BrowserAct.

Fuente: https://skillsagentes.com/skills/browser-act/skills/youtube-search-api-skill
Markdown: https://skillsagentes.com/skills/browser-act/skills/youtube-search-api-skill.md

Repositorio: https://github.com/browser-act/skills
Autor: browser-act
Licencia: MIT
Actualizado: hace 5 meses
Coste de contexto: 180 tok instalada, 1.5k tok al activarse, 2.6k tok con todos los archivos del bundle
Bundle: 2 archivos, 10 KB
Permisos que pide: ninguno declarado

## Instalación

Un skill son archivos markdown: los mismos archivos valen para cualquier agente y lo único que cambia es el directorio de destino, es decir la bandera `--agent`. Añade `-g` para instalarlo en todos los proyectos de la máquina.

```bash
# Claude Code
npx -y skills add browser-act/skills --skill youtube-search-api-skill --agent claude-code
# Cursor
npx -y skills add browser-act/skills --skill youtube-search-api-skill --agent cursor
# Codex
npx -y skills add browser-act/skills --skill youtube-search-api-skill --agent codex
# Gemini CLI
npx -y skills add browser-act/skills --skill youtube-search-api-skill --agent gemini
# Windsurf
npx -y skills add browser-act/skills --skill youtube-search-api-skill --agent windsurf
# Cline
npx -y skills add browser-act/skills --skill youtube-search-api-skill --agent cline
```

## Qué hace

- Ejecuta un script Python que llama a la BrowserAct YouTube Search API para extraer datos estructurados de resultados de búsqueda de YouTube
- Extrae videos, shorts, canales o playlists según el parámetro Video_type
- Imprime en terminal logs de estado con timestamp mientras la tarea corre en segundo plano
- Devuelve campos como title, description, view_count, published_at y url
- Reintenta automáticamente una sola vez si falla la ejecución, salvo error de autorización

## Cuándo usarla

- Buscar videos de YouTube por palabras clave
- Encontrar los últimos YouTube Shorts sobre un tema
- Recopilar datos de canales de YouTube para análisis de competencia
- Monitorear playlists de YouTube en tendencia o buscar videos tutoriales automáticamente

## Qué la activa

- "Busca en YouTube videos sobre 'automation' y dame los primeros 50"
- "Encuentra los Shorts más recientes sobre 'n8n'"
- "Extrae canales de YouTube relacionados con 'web scraping'"
- "Monitorea playlists de YouTube sobre inteligencia artificial"

## Antes de instalar

- Requiere Python y la variable de entorno BROWSERACT_API_KEY configurada con una clave obtenida en la consola de BrowserAct.
- Necesita en el PATH: python
- Variables de entorno: BROWSERACT_API_KEY
- makes network requests
- needs API credentials

## Archivos

- SKILL.md — 6 KB
- scripts/youtube_search_api.py — 4 KB

## SKILL.md

Reproducido tal cual desde browser-act/skills bajo MIT. Esta sección es el documento original y está en inglés.

# YouTube Search API Skill

## 📖 Introduction
This skill provides users with a one-stop YouTube search data extraction service through BrowserAct's YouTube Search API template. It can extract structured fields directly from the YouTube search results list. Simply provide the search keywords and limit conditions to get clean, usable video, shorts, channel, or playlist data.

## ✨ Features
1. **No hallucinations, ensuring stable and accurate data extraction**: Pre-set workflows avoid AI generative hallucinations.
2. **No CAPTCHA issues**: No need to handle reCAPTCHA or other verification challenges.
3. **No IP access limits or geo-fencing**: No need to deal with regional IP restrictions.
4. **More agile execution speed**: Compared to pure AI-driven browser automation solutions, task execution is faster.
5. **Extremely high cost-effectiveness**: Significantly reduces data acquisition costs compared to AI solutions that consume a large number of tokens.

## 🔑 API Key Setup Flow
Before running, you must first check the `BROWSERACT_API_KEY` environment variable. If it is not set, do not take any other actions; you should request and wait for the user's collaboration to provide it.
**The Agent must inform the user at this time**:
> "Since you have not configured the BrowserAct API Key, please go to the [BrowserAct Console](https://www.browseract.com/reception/integrations) first to get your Key."

## 🛠️ Input Parameters
When calling the script, the Agent should flexibly configure the following parameters based on the user's needs:

1. **KeyWords**
   - **Type**: `string`
   - **Description**: Search keywords used on YouTube. Can be any keyword or phrase.
   - **Example**: `AI`, `automation`, `n8n`, `web scraping`

2. **Video_type**
   - **Type**: `string`
   - **Description**: Which results tab to extract from.
   - **Supported values**: `Videos`, `Shorts`, `Channels`, `Playlists`
   - **Default**: `Videos`

3. **Date_limit**
   - **Type**: `number`
   - **Description**: Maximum number of items to extract from the search results list.
   - **Example**: `20`, `50`, `100`
   - **Default**: `100`

## 🚀 Usage (Recommended)
The Agent should achieve "one-command results" by executing the following independent script:

```bash
# Call example
python -u ./scripts/youtube_search_api.py "KeyWords" "Video_type" Date_limit
```

### ⏳ Execution Status Monitoring
Because this task involves automated browser operations, it may take a long time (several minutes). The script will **continuously output status logs with timestamps** (e.g., `[14:30:05] Task Status: running`) while running.
**Notice to Agent**:
- While waiting for the script to return results, please keep paying attention to the terminal output.
- As long as the terminal is still outputting new status logs, it means the task is running normally. Please do not mistakenly judge it as a deadlock or unresponsiveness.
- Only if the status remains unchanged for a long time or the script stops outputting and no result is returned, can you consider triggering the retry mechanism.

## 📊 Data Output
After successful execution, the script will parse and print the result directly from the API response. The extracted data includes:
- `title`: Title shown in search results
- `description`: Short description snippet (when available)
- `view_count`: View count displayed in results
- `published_at`: Publish time displayed in results
- `url`: Result item URL

## ⚠️ Error Handling & Retry Mechanism
During the execution of the script, if an error occurs (such as network fluctuation or task failure), the Agent should follow this logic:

1. **Check the output content**:
   - If the output **contains** `"Invalid authorization"`, it means the API Key is invalid or expired. At this time, **do not retry**, and you should guide the user to recheck and provide the correct API Key.
   - If the output **does not contain** `"Invalid authorization"` but the task execution fails (for example, the output starts with `Error:` or the returned result is empty), the Agent should **automatically try to execute the script again**.

2. **Retry limit**:
   - Automatic retry is limited to **only once**. If the second attempt still fails, stop retrying and report the specific error message to the user.

## 🌟 Typical Use Cases
1. **Keyword-first discovery**: Build topic pools and content datasets directly from search intent.
2. **Competitor scanning**: Search for competitor brand names and extract top related videos.
3. **Content monitoring**: Regularly extract search results for specific industry keywords to see what's trending.
4. **Channel research**: Search for channels within a specific niche and gather their URLs.
5. **Tutorial aggregation**: Find and extract educational videos for specific software or tools.
6. **Shorts tracking**: Monitor YouTube Shorts for trending hashtags or topics.
7. **Playlist extraction**: Find curated playlists for specific subjects.
8. **Market research**: Build structured datasets of search results for market analysis.
9. **Creator outreach**: Find emerging creators in a particular field for collaboration.
10. **View count analysis**: Compare view counts of the top videos for various keywords.

## Dónde encaja

- Categoría: [Datos y analítica](https://skillsagentes.com/categorias/datos-analitica.md) — Consulta, limpia y visualiza datos sin salir del agente.
- Creador: [browser-act](https://skillsagentes.com/creators/browser-act.md) — 102 skills en el directorio
- [Todas las skills](https://skillsagentes.com/skills.md)
- [Ranking de instalaciones](https://skillsagentes.com/ranking.md)

## Otras skills del mismo repositorio

- [Browser Act Skill Forge](https://skillsagentes.com/skills/browser-act/skills/browser-act-skill-forge.md): Forja paquetes Skill reutilizables (SKILL.md + scripts) a partir de la exploración de sitios web vía browser-act, evitando volver a explorar más tarde.
- [1688 Product Detail](https://skillsagentes.com/skills/browser-act/skills/1688-product-detail.md): Extrae datos completos de producto mayorista de páginas de detalle en 1688.com: título, precios por escalones, variantes SKU, imágenes, vendedor, puntuaciones de tienda, protección al comprador, atributos, cupones y estadísticas de reseñas.
- [Browser Act](https://skillsagentes.com/skills/browser-act/skills/browser-act.md): CLI de automatización de navegador para agentes de IA: nunca ejecutes comandos browser-act directamente vía Bash, invoca siempre este skill primero.
- [Ebay Sold Listings Search](https://skillsagentes.com/skills/browser-act/skills/ebay-sold-listings-search.md): Scraper de listados vendidos en eBay en 8 marketplaces (.com/.co.uk/.de/.fr/.it/.es/.ca/.com.au) con filtros de keyword, categoría, precio, condición, ubicación y orden, que devuelve ventas reales paginadas.
- [Threads Profile Search](https://skillsagentes.com/skills/browser-act/skills/threads-profile-search.md): Descubre cuentas de usuario de Threads por palabra clave, extrayendo datos de perfil como username, nombre visible, verificación, biografía y número de seguidores.

## Skills relacionadas

- [1688 Product Detail](https://skillsagentes.com/skills/browser-act/skills/1688-product-detail.md): Extrae datos completos de producto mayorista de páginas de detalle en 1688.com: título, precios por escalones, variantes SKU, imágenes, vendedor, puntuaciones de tienda, protección al comprador, atributos, cupones y estadísticas de reseñas.
- [Airbnb Listing Detail](https://skillsagentes.com/skills/browser-act/skills/airbnb-listing-detail.md): Obtiene el detalle completo de un listing de Airbnb por su ID numérico vía la API interna GraphQL: título, tipo de habitación, descripción, amenities, fotos, coordenadas, ciudad, reglas, ratings y dormitorios.
- [Amazon Asin Lookup Api Skill](https://skillsagentes.com/skills/browser-act/skills/amazon-asin-lookup-api-skill.md): Extrae detalles estructurados de un producto de Amazon (título, precio, calificaciones, marca, descripción) a partir de su ASIN mediante la API de BrowserAct.
- [Amazon Best Selling Products Finder Api Skill](https://skillsagentes.com/skills/browser-act/skills/amazon-best-selling-products-finder-api-skill.md): Extrae datos estructurados de productos más vendidos de Amazon mediante la API de BrowserAct: títulos, precios, ratings, reseñas, ventas y promociones.
- [Amazon Bestseller Listing](https://skillsagentes.com/skills/browser-act/skills/amazon-bestseller-listing.md): Scraper de listados Amazon Best Sellers: extrae rank, asin, title, url, image, price, stars, reviewCount por producto, más categoría y paginación, en todos los TLDs regionales de Amazon.

---

Skills Agentes · [Índice de páginas en markdown](https://skillsagentes.com/sitemap.md) · [Inicio](https://skillsagentes.com/index.md)