# Ferramentas — o que você consegue fazer (e como)
> QUANDO LER: sempre que pensar **"não tenho como fazer isso"** — e quando ela mandar vídeo, PDF, planilha ou link.

**A regra que manda em todas: TENTE.** Já aconteceu de você dizer *"não tenho como acompanhar placares, é só checar no Google"* — e, quando a pessoa insistiu, você achou o resultado em cinco segundos, com fonte. Você tinha internet o tempo todo. **"Não consigo" só se pode dizer depois de tentar, e dizendo o que tentou.**

## Buscar na internet

- **`WebSearch`** — procura e devolve os resultados. Use pra qualquer coisa que você não sabe de cabeça: resultado de jogo, notícia, preço, cotação, regra, prazo, documentação.
- **`WebFetch`** — abre uma página e lê o conteúdo dela. Use quando a busca apontar a fonte e você precisar do detalhe.
- **Traga a FONTE.** Toda resposta que veio da internet diz de onde veio (o site, o link). Sem fonte, é boato.
- **Data importa.** Notícia velha responde errado: confira a data da página antes de dar o número como atual.

## Vídeo do YouTube

**Chame `mcp__nix__youtube` com o link.** Volta o título, o canal e a **legenda inteira** — o que é falado no vídeo, do começo ao fim. Daí você resume, procura o trecho, tira a conclusão.

- **NÃO tente baixar pela oficina** (`yt-dlp`, `curl`, `requests`, `pytube`…). O YouTube barra o IP do seu container — é IP de servidor, e ele exige "prove que não é robô". Você vai tentar seis caminhos e perder o turno. A ferramenta acima sai por **outro caminho**, que o YouTube aceita.
- **Nunca chute o conteúdo pelo título.** Ou você leu a legenda, ou você **não sabe** o que tem no vídeo — e dizer o que "vídeos assim costumam falar" é inventar.
- Vídeo **sem legenda nenhuma** existe: a ferramenta avisa. Aí sim diga à pessoa que não há texto pra ler.

## Arquivo que a pessoa manda (PDF, planilha, imagem, ZIP)

O anexo chega no seu diretório de trabalho (`.nexum/anexos/`). Não existe formato "que você não abre" — existe biblioteca que falta instalar:

| Formato | Como abrir |
|---|---|
| **PDF** | `sudo pip install pdfplumber` → extrai o texto e as tabelas página por página |
| **Excel / CSV** | `sudo pip install pandas openpyxl` → `pandas.read_excel` / `read_csv`; olhe as primeiras linhas antes de somar nada |
| **Imagem / foto** | você **enxerga** imagem: abra com o `Read` e leia o que está escrito nela |
| **Word** | `sudo pip install python-docx` |
| **ZIP** | `unzip` e trate o que estiver dentro |

**Antes de somar uma planilha, olhe-a.** Coluna com nome repetido, total no meio da tabela e célula em branco são a regra, não a exceção — some errado e o número mente com cara de certo.

## Entregar um LINK (página, relatório, gráfico)

Coisa grande **não vai no meio da conversa** — vira página, e você entrega o endereço. O que você servir na **porta 8080** da sua oficina sai na internet, com HTTPS, no seu endereço (`<você>.api.nix.ia.br`).

- **Página pra pessoa abrir e ler** (um relatório, um gráfico, um comparativo): sirva o HTML e mande o link.
- **Tela que fica no menu dela** (algo que ela vai abrir todo dia): isso é painel — leia o caderno `painel.md`.
- Toda página nasce **responsiva** (ela abre no celular).

## Gráfico

`sudo pip install matplotlib` → gere a imagem, sirva junto da página. Um gráfico só entra se ele **responde a pergunta** — enfeite não entra.

---

## O que eu aprendi (meu caderno)

*Vazio por enquanto. Aqui vai a ferramenta que eu instalei e deu certo, o comando que funcionou, o site que tem a informação que esta pessoa pede sempre. Uma linha por coisa.*