# Exporter para agentes

Cinco skills ensinam um agente a exportar, fazer backup e pesquisar com o Exporter.

## As cinco skills

O comando acima instala as cinco com a [skills CLI](https://github.com/vercel-labs/skills), a partir do [índice de skills](https://exporter.dev/.well-known/skills/index.json) deste site. Ou salve qualquer SKILL.md abaixo na pasta de skills do seu agente.

- [export-apple-notes](https://exporter.dev/.well-known/skills/export-apple-notes/SKILL.md): Exportar o Apple Notes para arquivos Markdown ou HTML com o `exporter` e ler o resumo em JSON. (`.well-known/skills/export-apple-notes/SKILL.md`)
- [apple-notes-to-obsidian](https://exporter.dev/.well-known/skills/apple-notes-to-obsidian/SKILL.md): Colocar o Apple Notes numa pasta de um cofre do Obsidian e mantê-la em sincronia, com segurança. (`.well-known/skills/apple-notes-to-obsidian/SKILL.md`)
- [backup-apple-notes](https://exporter.dev/.well-known/skills/backup-apple-notes/SKILL.md): Um espelho toda noite, cópias datadas ou uma etapa prévia de uma ferramenta de backup, e uma verificação de que a última rodou. (`.well-known/skills/backup-apple-notes/SKILL.md`)
- [notes-as-claude-context](https://exporter.dev/.well-known/skills/notes-as-claude-context/SKILL.md): Pesquisar e ler notas, contatos e conversas pelo servidor MCP local. (`.well-known/skills/notes-as-claude-context/SKILL.md`)
- [export-messages](https://exporter.dev/.well-known/skills/export-messages/SKILL.md): Conversas do iMessage em Markdown, um arquivo por conversa, com os anexos. (`.well-known/skills/export-messages/SKILL.md`)

## O que um agente pode fazer

- Exportar: `exporter sync --source apple --json --quiet` na pasta de exportação do app, ou `exporter export --dest <folder>` em qualquer pasta que a pessoa autorizou no cartão Linha de Comando.
- Fazer backup com agendamento: `exporter help cron` mostra as linhas do crontab com o caminho real: um espelho que acompanha as edições, ou cópias datadas que nunca mudam.
- Ler o resultado: `--json` em sync, export, list, status e log. Códigos de saída: 0 ok, 1 falhas na exportação, 2 falta configurar, 64 uso incorreto.
- Pesquisar como contexto: Por MCP: `search`, `read`, `list`, `get_recent`, `get_stats` e `get_metadata` sobre as exportações. [As seis ferramentas](https://exporter.dev/docs/mcp).
- Saber o estado: `exporter status --json` mostra cada fonte, a última exportação dela, a cota gratuita e quanto já foi usado. `exporter list sources --json` conta o que existe.
- Saber a cota: Uma execução que passa da cota gratuita ainda sai com 0 e mostra uma linha `note:` dizendo o que foi pulado. A pessoa desbloqueia aquele app uma vez, no Exporter.

## Configuração

Uma pessoa faz os dois primeiros passos, porque o app roda em sandbox. O agente faz o resto.

1. Uma pessoa instala o app: O Exporter pela Mac App Store, aberto uma vez. Conectar um app e escolher a pasta de exportação dele só acontece no app.
2. Uma pessoa cola uma linha: No cartão Linha de Comando do app, “copiar comando de instalação”, colado uma vez no Terminal. O app em sandbox não pode gravar no seu PATH sozinho. `exporter help install` mostra a linha para aquele Mac.
3. O agente aprende as skills: `npx skills add https://exporter.dev` instala as cinco skills acima a partir do índice de skills deste site.
4. O agente verifica e executa: `exporter doctor` diz o que está faltando, com uma linha `fix:` abaixo de cada falha. Depois `exporter sync --json --quiet` exporta e mostra um resumo em JSON.
5. O agente lê como contexto: Com o servidor MCP iniciado no cartão do app, `claude mcp add --transport http exporter http://localhost:8744/mcp` conecta o Claude Code às exportações.

## Perguntas

### O que um agente não pode fazer?

Conectar um app, escolher uma pasta de exportação, autorizar uma pasta, iniciar o servidor MCP ou comprar um desbloqueio. Isso acontece no app, feito por uma pessoa. A linha de comando nunca pergunta nada: um passo que falta interrompe a execução com o código de saída 2 e uma linha dizendo o que fazer.

### Um agente pode pagar um desbloqueio?

Não. Cada app é desbloqueado com uma compra única dentro do app, feita por uma pessoa no Exporter. Não há checkout na web, nem chave de licença, nem pagamento por agente. Avise a pessoa; a próxima execução já reconhece o desbloqueio.

### Quais agentes podem usar?

Qualquer coisa que rode comandos de shell pode comandar o `exporter`. Qualquer coisa que fale MCP por HTTP pode se conectar ao servidor: o Claude Code com um comando, o Cursor e o VS Code pelos botões do cartão Servidor MCP do app, o Claude Desktop por uma entrada `mcp-remote` copiada.

### Quão privado é?

A linha de comando e o servidor rodam no Mac da pessoa e leem as exportações dela ali; o servidor escuta só em 127.0.0.1. As skills dizem ao agente para informar contagens e caminhos, e para citar notas ou mensagens só quando a pessoa pedir. [Privacidade](https://exporter.dev/privacy).

## Related

- [CLI](https://exporter.dev/docs/cli): Every command, flag and exit code
- [MCP server](https://exporter.dev/docs/mcp): Connect Claude and other agents
- [Apple Notes in Claude](https://exporter.dev/guides/notes/apple-notes-in-claude): Claude searches your notes, on your Mac

---

human version: https://exporter.dev/pt-br/agents
every page: https://exporter.dev/llms.txt
