n8n-nodes-youtube-search

Nó customizado do n8n para buscar vídeos no YouTube usando a biblioteca yt-search. Não requer API key!

Instalação

1. Clone este repositório ou copie os arquivos para o diretório de nodes customizados do n8n
2. Execute npm install para instalar as dependências
3. Execute npm run build para compilar o projeto

Configuração

Não é necessária nenhuma configuração de credenciais! A biblioteca yt-search funciona sem API key, fazendo scraping direto do YouTube.

Uso

Operação: Search

Busca vídeos no YouTube com base em uma query.

Parâmetros:

• Query (obrigatório): Termo de busca
• Max Results: Número máximo de resultados (1-100, padrão: 10)

Saída:

O nó retorna um array de objetos com as seguintes propriedades:

{
  "videoId": "dQw4w9WgXcQ",
  "title": "Título do vídeo",
  "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ",
  "description": "Descrição do vídeo",
  "duration": "3:33",
  "durationSeconds": 213,
  "views": 1234567890,
  "uploadedAt": "2 years ago",
  "author": {
    "name": "Nome do Canal",
    "url": "https://www.youtube.com/channel/...",
    "channelId": "UC..."
  },
  "thumbnail": "https://i.ytimg.com/vi/.../default.jpg",
  "image": "https://i.ytimg.com/vi/.../hqdefault.jpg"
}

Vantagens

• ✅ Sem API Key: Não precisa de credenciais do Google Cloud
• ✅ Gratuito: Sem limites de quota da API
• ✅ Simples: Fácil de usar e configurar
• ✅ Rápido: Busca direta no YouTube
• ✅ Confiável: Funciona mesmo quando outras bibliotecas falham

Desenvolvimento

Estrutura do Projeto

.
├── nodes/
│   └── YoutubeSearch/
│       ├── YoutubeSearch.node.ts
│       └── youtube.svg
├── package.json
├── tsconfig.json
└── README.md

Scripts Disponíveis

• npm run build: Compila o projeto TypeScript
• npm run dev: Compila em modo watch
• npm run lint: Executa o linter
• npm run format: Formata o código com Prettier

Dependências

• yt-search: Biblioteca para buscar vídeos no YouTube sem API key
• n8n-workflow: Tipos e interfaces do n8n (devDependency)

Licença

MIT