ytt-mcp: ferramenta de servidor para obter e processar legendas para vídeos do YouTube

O ytt-mcp é uma ferramenta de servidor MCP (Model Context Protocol) de código aberto projetada especificamente para capturar legendas de vídeos do YouTube e processá-las. Desenvolvida pela equipe cottongeeks e hospedada no GitHub, ela foi projetada para ajudar os usuários a extrair rapidamente legendas de vídeo com comandos simples ou ferramentas de IA, além de oferecer suporte à análise e ao resumo de conteúdo adicional. Os usuários podem invocar a ferramenta diretamente por meio de plataformas como o Raycast, tornando-a adequada para criadores de conteúdo, pesquisadores ou usuários que precisam de conteúdo de vídeo. O código do projeto é aberto, fácil de instalar e estender, adequado para desenvolvedores ou entusiastas de tecnologia.

Lista de funções

• Extraia legendas geradas automaticamente ou legendas carregadas pelo usuário para vídeos do YouTube.
• Oferece suporte à chamada da função de aquisição de legendas a partir da linha de comando ou por meio da extensão Raycast.
• Oferece uma função de resumo do conteúdo do subtítulo que gera análises sucintas dos principais pontos e temas.
• Compatível com o protocolo MCP, ele pode ser integrado a ferramentas de IA para aprimorar o processamento de legendas.
• Oferece suporte a dicas personalizadas, permitindo que o usuário manipule o conteúdo da legenda sob demanda.
• Projeto de código aberto que permite aos usuários contribuir com código ou personalizar recursos.

Usando a Ajuda

Processo de instalação

Para usar o ytt-mcp, primeiro é preciso garantir que o ambiente do sistema atenda aos requisitos básicos. Veja a seguir as etapas detalhadas da instalação:

1. Preparação do ambiente
   • Certifique-se de que o Node.js esteja instalado (versão recomendada 16 ou superior).
   • Instale o Python 3.8+, pois algumas das dependências podem exigir suporte ao Python.
   • Se estiver usando o Raycast, instale o aplicativo Raycast e ative a extensão MCP.
   • Certifique-se de que você tenha ferramentas Git para clonar repositórios de código.
2. Clonagem do código do projeto
   Abra um terminal e execute o seguinte comando para clonar o repositório ytt-mcp:

   git clone https://github.com/cottongeeks/ytt-mcp.git
   

   Vá para o catálogo de projetos:

   cd ytt-mcp
   

3. Instalação de dependências
   Execute o seguinte comando no diretório do projeto para instalar as dependências necessárias:

   npm install
   

   Se o projeto exigir dependências do Python, execute:

   pip install -r requirements.txt
   

4. Configuração do servidor MCP
   Localize o arquivo de configuração no diretório do projeto (geralmente o diretórioconfig.json(ou arquivo semelhante). Siga as instruções para definir a chave de API do YouTube (opcional, para extração aprimorada de legendas). Exemplo de arquivo de configuração:

   {
   "mcpServers": {
   "ytt-mcp": {
   "command": "uvx",
   "args": ["ytt-mcp"]
   }
   }
   }
   

5. Iniciar o servidor
   Execute o seguinte comando para iniciar o servidor ytt-mcp:

   npm start
   

   Ou, se estiver usando o Raycast, abra o Raycast e executeInstall Servercomando, digite@youtube-transcriptVocê pode registrar o servidor.

6. Verificar a instalação
   Após a inicialização, acesse ohttp://localhost:端口号(o número da porta é especificado no arquivo de configuração e o padrão é 3000) para confirmar que o servidor está funcionando corretamente.

Uso

A principal função do ytt-mcp é extrair as legendas de vídeos do YouTube e processá-las. Aqui estão as etapas específicas para fazer isso:

extração de legendas

• Usado via Raycast
  Em Raycast, digite@youtube-transcripte, em seguida, cole o URL do vídeo do YouTube (por exemplohttps://www.youtube.com/watch?v=视频IDO Raycast chamará automaticamente o servidor ytt-mcp para extrair as legendas e exibi-las.
  Exemplo de comando:

  @youtube-transcript fetch the Youtube transcript of the video: https://www.youtube.com/watch?v=aO1-6X_f74M
  

• Usado na linha de comando
  Execute o seguinte comando no terminal:

  uvx ytt-mcp --url https://www.youtube.com/watch?v=视频ID
  

  Após a execução, as legendas serão salvas em um arquivo de texto ou exibidas diretamente no terminal.

Resumo do conteúdo da legenda

O ytt-mcp suporta a geração de resumos de legendas a partir de palavras-chave personalizadas. Por exemplo, use a seguinte palavra-chave:

@youtube-transcript fetch the Youtube transcript of the video: {clipboard | raw}
Comprehensively summarize the transcript with the following format:
"""
### Key Takeaways
- 关键点1
- 关键点2
- 关键点3
"""
### Theme Wise Breakdown
- 主题1：内容概述
- 主题2：内容概述
"""

Copie o URL do vídeo do YouTube para a área de transferência e execute os prompts acima no Raycast. O ytt-mcp extrai as legendas e gera um resumo estruturado com três pontos principais e análise de conteúdo por tópico.

Integração de ferramentas de IA

O ytt-mcp é compatível com o protocolo MCP e pode ser integrado a ferramentas de IA, como Claude ou Cursor. Os usuários podem invocar o ytt-mcp por meio de clientes MCP para executar tarefas complexas. Por exemplo:

• Configure o URL do servidor MCP no Cursor para serhttp://localhost:3000.
• Use comandos de linguagem natural, como "extrair legendas de vídeo e resumir os pontos principais" para acionar o processamento do ytt-mcp.

Extensões personalizadas

Os desenvolvedores podem modificar o código-fonte do ytt-mcp para adicionar novos recursos. Por exemplo, adicionar suporte a outras plataformas de vídeo ou otimizar a lógica de formatação de legendas. Após a modificação, envie o código para o repositório do GitHub para participar do desenvolvimento da comunidade.

advertência

• Certifique-se de que o vídeo do YouTube tenha legendas automáticas ativadas ou que as legendas tenham sido carregadas; caso contrário, a extração poderá falhar.
• A extensão Raycast precisa manter uma conexão de rede para acessar o servidor MCP.
• Se estiver usando a API do YouTube, aplicam-se restrições de cota de uso da API.

cenário do aplicativo

1. criador de conteúdo
   Os criadores de conteúdo podem usar o ytt-mcp para extrair legendas de vídeos do YouTube e gerar rapidamente resumos de conteúdo de vídeo para redação de mídia social ou postagens de blog. Por exemplo, extrair legendas de vídeos instrutivos e agrupá-las em tópicos importantes para publicação no Weibo.
2. Pesquisa educacional
   Estudantes ou pesquisadores podem extrair legendas de vídeos de palestras acadêmicas para gerar anotações estruturadas para facilitar a revisão ou a citação. Por exemplo, agrupando os tópicos e o conteúdo principal de uma palestra TED.
3. tradução multilíngue
   Após a extração da legenda, os usuários podem combinar com ferramentas de IA para traduzir o conteúdo da legenda e gerar versões em vários idiomas, adequadas para equipes multinacionais ou distribuição de conteúdo em vários idiomas.
4. Fluxos de trabalho automatizados
   Os desenvolvedores podem integrar o ytt-mcp em scripts de automação para processar em lote várias legendas de vídeo para análise de dados ou arquivamento de conteúdo.

QA

1. Qual plataforma de vídeo é compatível com o ytt-mcp?
   Atualmente, ele só oferece suporte à extração de legendas para vídeos do YouTube e pode oferecer suporte a outras plataformas por meio de contribuições da comunidade no futuro.
2. Precisa de uma chave de API do YouTube?
   Não é obrigatório, mas a configuração da chave de API pode melhorar a estabilidade e a precisão da extração de legendas.
3. Como lidar com a falha na extração de legendas?
   Verifique se as legendas estão ativadas para o vídeo, certifique-se de que a conexão com a Internet esteja funcionando ou tente atualizar o ytt-mcp para a versão mais recente.
4. Como instalar a extensão Raycast?
   Procure a extensão MCP no Raycast, execute o comandoInstall Servercomando, digite@youtube-transcripte configure-o conforme solicitado.