smartest-tv: reproduza um título pelo nome na TV ou no navegador

Para quem

Se você quer dizer um título no terminal ou num agente e a TV abrir Netflix, Apple TV+, YouTube ou Spotify, esta ferramenta combina. Também pode lançar uma URL, fazer áudio em vários cômodos e, como servidor MCP, deixar um assistente cuidar da sala. Não é firmware de TV e não contrata assinatura por você.

Notas oficiais:

https://github.com/Hybirdss/smartest-tv

O pré-requisito mais importante: dá para tentar sem TV; o comando então abre no navegador. Com TV, faça primeiro stv setup e depois conecte. O texto oficial diz sem chave de API, sem dependência de nuvem e que não é automação de navegador. O título do repositório também menciona LG, Samsung, Roku e Android.

Primeira tentativa em 3 minutos

Siga só o caminho oficial: instale o pacote stv com pip e reproduza um título de exemplo oficial.

Pré-requisitos: Python / pip instalados. TV é opcional. A primeira reprodução abre o app correspondente no navegador ou na TV — efeito colateral visível. Confirme que aceita interromper a tela atual.

Comando de instalação:

pip install stv

Onde configurar: no cliente MCP, mcpServers.tv tem command uvx e args stv. Essa é a forma MCP oficial de uma linha. A evidência nomeia Claude Code, Codex, Antigravity. pip é para a linha de comando, uvx para MCP; não acrescente um terceiro instalador.

Primeira chamada de baixo risco: execute stv play "Frieren". Sem TV, o texto oficial diz que abre no navegador. Não é somente leitura: resolve o título, obtém um content ID e faz deep-link no app. Confirme que a tela atual pode ser ocupada. Depois de ligar o MCP, só repita este play por nome; não invente outros nomes de ferramenta.

Sinal de sucesso: o navegador ou a TV começa aquele título, ou diz com clareza que o setup ainda não foi feito. Repetições devem ser mais rápidas porque o texto oficial diz que os resultados ficam em cache.

Casos de uso

Caso 1: sem TV, use stv play mais o título de exemplo oficial Frieren para conferir resolução e deep-link. O texto oficial escreve No TV? Opens in your browser. Você pode conferir se o navegador abre o conteúdo correspondente. A evidência não escreve outros interruptores de play; não invente o que falta.

Caso 2: com TV, conecte primeiro com stv setup e depois reproduza por nome. O texto oficial diz que você dá um nome, o stv resolve um content ID e faz deep-link no app da TV. Combina com um aparelho de sala que já terminou o setup. No MCP o texto oficial só diz que há 21 ferramentas e não as nomeia. Até aqui só se confirmam play por nome e setup. Lançar URL e áudio em vários cômodos são mencionados sem comandos; não invente subcomandos.

Limites de uso

Reproduzir muda o estado da TV ou do navegador; não é risco zero. O texto oficial diz sem chave e sem nuvem, mas ainda resolve títulos no local e faz deep-link — não é «sem tocar a tela». O alcance de controle de um aparelho real antes do setup não está escrito.

As 21 ferramentas MCP não têm relação de nomes. O cache acelera as repetições, mas não há diretório de cache nem comando de limpeza. Este guia cobre só a instalação pip, a configuração MCP uvx, stv play e stv setup. Outras capacidades de sala sem comando não devem ser extrapoladas.