O que a CLI do Speak AI faz e para quem é

A CLI do Speak AI é uma interface de linha de comando que oferece aos desenvolvedores, pesquisadores e usuários avançados acesso direto ao terminal completo Fale com a IA plataforma. Em vez de carregar arquivos através de um navegador web, navegar painéis e clicar através de menus, você executa um único comando. Carregue uma gravação, obtenha uma transcrição, procure em sua biblioteca, faça perguntas de AI sobre seus dados e exporte resultados em qualquer formato. Tudo do seu terminal, tudo programável, tudo com saída JSON para redirecionar para outras ferramentas.

A CLI é fornecida como parte do @speakai/mcp-server pacote npm. Instale-o globalmente com npm install -g @speakai/mcp-server, execute speakai-mcp init para definir sua chave API, e você terá 26 comandos prontos para usar. O mesmo pacote também inclui servidor MCP with 83 tools for AI assistants like Claude, ChatGPT, Cursor, and Windsurf. Both the CLI and MCP server share the same API key and access the same workspace data.

Como a CLI difere da interface web

A interface web do Speak AI em app.speakai.co é projetado para uso interativo: navegue sua biblioteca, reproduza gravações, leia transcrições e explore insights visualmente. A CLI é projetada para automação e eficiência. Ela se destaca em operações em lote, scripts e integração com outras ferramentas. Carregue 200 arquivos em um loop. Procure em toda sua biblioteca e redirecione resultados para grep. Exporte cada gravação em uma pasta como PDF. Esses fluxos de trabalho são impraticáveis ou impossíveis através de uma interface web, mas diretos da linha de comando.

Todo comando suporta --json saída, tornando fácil integrar com jq, Python, Node.js ou qualquer outra ferramenta em seu stack. A CLI também oferece suporte a --plain saída para resultados legíveis por humanos quando você está trabalhando de forma interativa. Você pode misturar ambas as abordagens: use a interface web para exploração visual e a CLI para automação e trabalho em lote.

Como a CLI se relaciona com o servidor MCP

A CLI e a servidor MCP are complementary tools packaged together. The MCP server provides 83 tools that AI assistants call during conversation. You describe what you want in natural language, and your AI assistant orchestrates the right tool calls. The CLI provides 26 commands that you invoke directly. You type the exact command, pass the exact arguments, and get deterministic results. Use the MCP server when you want your AI to figure out the workflow. Use the CLI when you already know exactly what you want to do and need it to happen the same way every time.

Suporte de idiomas e transcrição

A CLI suporta transcrição em mais de 70 idiomas com detecção automática de idioma. A diarização de falantes identifica quem disse o quê. Os timestamps de nível de palavra permitem alinhamento preciso. Quando você carrega um arquivo com speakai-mcp upload, a plataforma transcreve automaticamente e executa análise NLP: sentimento, palavras-chave, temas e entidades nomeadas. Você pode recuperar esses resultados com get-transcript e get-insights, ou consulte-os com perguntar usando AI Chat powered by Claude, Gemini, ou GPT.

Exemplos de scripts e automação

As equipes usam a CLI para criar fluxos de trabalho automatizados que seriam impraticáveis através de uma GUI. Um time de pesquisa pode escrever um script bash que carrega todas as gravações de entrevistas de uma unidade compartilhada, aguarda o processamento e depois procura em transcrições por temas específicos e exporta os resultados em CSV. Um time de DevOps pode adicionar uma etapa ao seu pipeline CI/CD que transcreve gravações de demonstração de produtos e envia resumos para Slack. Uma empresa de consultoria pode executar um trabalho cron toda segunda-feira que extrai as gravações de reuniões da semana anterior, gera resumos via perguntar, e envia um resumo consolidado por email para o time. O --json sinalizador em cada comando significa que a CLI se integra perfeitamente em qualquer linguagem de script ou ferramenta de automação.

Começando

Instale a CLI com npm install -g @speakai/mcp-server. Execute speakai-mcp init para inserir sua chave API. Depois tente speakai-mcp ls para ver sua biblioteca de mídia, speakai-mcp upload ./file.mp3 --wait para transcrever uma gravação, e speakai-mcp ask “Summarize this recording” para consultá-la com AI. Documentação completa e código-fonte estão em GitHubA CLI é gratuita e código aberto sob a licença MIT. Você precisa de uma conta do Speak AI para autenticar. Acesso total Documentação da API está em docs.speakai.co. Veja a página de desenvolvedores para a história completa de integração da plataforma, incluindo a REST API, webhooks, widgets incorporáveis e opções de marca branca.