Modulo 1.3 - Primeiros passos

⚽ pp-espn — placares ao vivo

CLI de esportes que cobre 10 ligas (NFL, NBA, MLB, NHL, NCAA, MLS, EPL, WNBA, etc), com placar ao vivo, classificacoes, head-to-head e box score completo.

Exemplo direto no terminal

$ espn-pp-cli games --league nba --date today

[NBA] Hoje (3 jogos):
  Lakers 112  @ Celtics 109   FINAL
  Warriors 98  @ Knicks 104   FINAL
  Heat 99     @ Mavericks 110 4Q 2:14

$ espn-pp-cli summary --game 401584893
Box score, top scorers, lances de pontuacao e odds...

🗣️ No Claude Code

"qual o placar do Lakers hoje?" → invoca pp-espn
"box score do jogo dos Mavericks de ontem"
"classificacao da NBA leste"
"Chiefs vs Eagles head to head"

✈️ pp-flight-goat — voos baratos

Agrega Google Flights, Kayak e FlightAware em uma unica CLI. Combina browser-sniff (Google) com API oficial (FlightAware AeroAPI).

Buscar voo

$ flight-goat-pp-cli search --from GRU --to LIS --date 2026-07-15

3 melhores opcoes:
  1. TAP TP088   GRU 23:50 -> LIS 12:35+1  9h45  R$ 4.120
  2. LATAM LA729 GRU 18:25 -> LIS 07:00+1 10h35  R$ 4.380
  3. KLM KL702   GRU 16:40 -> AMS+LIS    14h20  R$ 3.890

✓ Sem API key

✓Search basico (Google Flights + Kayak)
✓Comparacao de tarifas
✓Scan de rotas long-haul

🔑 Com AeroAPI key

·Tracking ao vivo do voo
·Alertas de atraso
·Confiabilidade historica do voo

🎬 pp-movie-goat — filmes + watchlist

Combina TMDb (descoberta) com OMDb (multi-source ratings) e adiciona uma watchlist em SQLite que sinaliza o que esta nos servicos que voce assina.

Caso de uso real

# Onde assistir
$ movie-goat-pp-cli where "Dune Part Two"
Streaming: Max (assinado), Amazon Prime (rent R$ 14,90)
IMDb 8.5  RT 92%  Metacritic 79

# Adicionar a watchlist
$ movie-goat-pp-cli watchlist add "The Brutalist"
Adicionado. Indicara quando entrar em Max, Netflix ou Disney+.

💡 Por que e exemplo interessante

Mostra que uma CLI pode ter estado proprio (watchlist persiste entre sessoes) e preferencias do usuario (servicos assinados configurados via auth).

🍳 pp-recipe-goat — receitas ranqueadas

Busca a melhor versao de qualquer receita em 37 sites confiaveis (NYT Cooking, Serious Eats, Bon Appetit, etc), com cookbook offline e match contra sua despensa.

Pantry match

$ recipe-goat-pp-cli search "risoto de cogumelos" --pantry-match

Top 3 (com base na sua despensa):
  1. Risoto de cogumelos (Serious Eats)     ★ 4.8  faltam: 0
  2. Risoto cremoso (NYT Cooking)           ★ 4.6  faltam: parmesao
  3. Risoto vegano (Bon Appetit)            ★ 4.5  faltam: caldo legumes

🔍 Browser-sniff em larga escala

Sites de receita raramente tem API publica. O recipe-goat foi gerado via browser-sniff: o factory inspecionou o HTML/JSON-LD de cada site e gerou um parser dedicado.

📊 Medir tokens com /context

O comando /context do Claude Code mostra quantos tokens cada skill e MCP server consome. E o jeito mais direto de provar o ganho ao migrar de MCP para CLI.

Antes vs depois

# Antes (com MCP server espn)
/context
> MCP: espn-mcp           18.420 tokens
> Skills: (nenhuma)              0 tokens
> Total overhead:           18.420 tokens

# Depois (so com pp-espn CLI + skill)
/context
> MCP:                            0 tokens
> Skills: pp-espn              420 tokens
> Total overhead:              420 tokens

44x menos overhead so no exemplo de uma CLI.

💡 Defenda no time

Tire um print do /context antes e depois da migracao. E o argumento mais concreto para convencer engenharia/financeiro a adotar CLIs.

🗣️ Triggers em linguagem natural

Cada skill define trigger phrases em PT-BR e ingles. Voce nao precisa decorar comando — o agente roteia pelo que voce digita.

⚽ pp-espn

"placar dos Lakers hoje"
"jogos da NFL essa semana"
"classificacao da MLB leste"
"AP poll college football"

✈️ pp-flight-goat

"voos baratos GRU LIS julho"
"rastreia voo TAP088"
"long haul de Sao Paulo para Asia"

🎬 pp-movie-goat

"onde assistir Oppenheimer"
"o que assistir hoje"
"filmografia de Christopher Nolan"

🍳 pp-recipe-goat

"melhor receita de carbonara"
"o que cozinhar com frango e limao"
"adiciona ao cookbook"

⚠️ Cuidado

Se voce tiver MCP server e CLI cobrindo o mesmo dominio, o agente pode escolher o MCP (que esta sempre carregado). Desinstale MCP duplicados antes para garantir que a CLI ganhe.

✅ Resumo do Modulo

✓

4 CLIs do starter-pack na ponta — espn, flight-goat, movie-goat, recipe-goat.

✓

Cada CLI tem skill correspondente — agente invoca via linguagem natural.

✓

/context mede o ganho — antes vs depois da migracao para CLI.

✓

Triggers em PT-BR funcionam — voce pergunta em portugues, agente roteia.

Proximo Modulo:

1.4 — Criando sua propria CLI

← Modulo anterior Proximo Modulo →