# Exporter per gli agenti

Cinque skill insegnano a un agente a esportare, fare backup e cercare con Exporter.

## Le cinque skill

Il comando qui sopra le installa tutte e cinque con la [CLI skills](https://github.com/vercel-labs/skills) dall'[indice delle skill](https://exporter.dev/.well-known/skills/index.json) di questo sito. Oppure salvi uno qualsiasi dei SKILL.md qui sotto nella cartella delle skill del suo agente.

- [export-apple-notes](https://exporter.dev/.well-known/skills/export-apple-notes/SKILL.md): Esporta Apple Notes in file Markdown o HTML con `exporter` e legge il riepilogo 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): Mette le note di Apple Notes in una cartella di un vault di Obsidian e la mantiene sincronizzata, in sicurezza. (`.well-known/skills/apple-notes-to-obsidian/SKILL.md`)
- [backup-apple-notes](https://exporter.dev/.well-known/skills/backup-apple-notes/SKILL.md): Uno specchio notturno, istantanee con data o un passaggio preliminare per uno strumento di backup, e un controllo che l'ultimo sia stato eseguito. (`.well-known/skills/backup-apple-notes/SKILL.md`)
- [notes-as-claude-context](https://exporter.dev/.well-known/skills/notes-as-claude-context/SKILL.md): Cerca e legge note, contatti e conversazioni tramite il server MCP locale. (`.well-known/skills/notes-as-claude-context/SKILL.md`)
- [export-messages](https://exporter.dev/.well-known/skills/export-messages/SKILL.md): Le conversazioni iMessage in Markdown, un file per conversazione, con gli allegati. (`.well-known/skills/export-messages/SKILL.md`)

## Cosa può fare un agente

- Esportare: `exporter sync --source apple --json --quiet` nella cartella di esportazione dell'app, oppure `exporter export --dest <folder>` in qualsiasi cartella che la persona ha autorizzato sulla scheda Riga di comando.
- Fare backup a orari fissi: `exporter help cron` stampa le righe di crontab con il percorso reale: uno specchio che segue le modifiche, o istantanee con data che non cambiano mai.
- Leggere il risultato: `--json` su sync, export, list, status e log. Codici di uscita: 0 ok, 1 esportazioni non riuscite, 2 configurazione necessaria, 64 uso errato.
- Cercare come contesto: Via MCP: `search`, `read`, `list`, `get_recent`, `get_stats` e `get_metadata` sulle esportazioni. [I sei strumenti](https://exporter.dev/docs/mcp).
- Conoscere lo stato: `exporter status --json` mostra ogni sorgente, la sua ultima esportazione, il suo livello gratuito e il numero di elementi usati. `exporter list sources --json` conta ciò che c'è.
- Conoscere la quota: Un'esecuzione oltre la quota gratuita termina comunque con 0 e stampa una riga `note:` che indica cosa è stato saltato. La persona sblocca quell'app una volta, in Exporter.

## Configurazione

Una persona fa i primi due passaggi, perché l'app è in sandbox. L'agente fa il resto.

1. Una persona installa l'app: Exporter dal Mac App Store, aperto una volta. Collegare un'app e scegliere la sua cartella di esportazione si fa solo nell'app.
2. Una persona incolla una riga: Sulla scheda Riga di comando dell'app, “copia il comando di installazione”, poi incollato una volta nel Terminale. L'app in sandbox non può scrivere da sola nel suo PATH. `exporter help install` stampa la riga per quel Mac.
3. L'agente impara le skill: `npx skills add https://exporter.dev` installa le cinque skill qui sopra dall'indice delle skill di questo sito.
4. L'agente controlla ed esegue: `exporter doctor` dice cosa manca, con una riga `fix:` sotto ogni errore. Poi `exporter sync --json --quiet` esporta e stampa un unico riepilogo JSON.
5. L'agente legge come contesto: Con il server MCP avviato sulla scheda dell'app, `claude mcp add --transport http exporter http://localhost:8744/mcp` collega Claude Code alle esportazioni.

## Domande

### Cosa non può fare un agente?

Collegare un'app, scegliere una cartella di esportazione, autorizzare una cartella, avviare il server MCP o acquistare uno sblocco. Queste cose avvengono nell'app, per mano di una persona. La riga di comando non chiede mai nulla: un passaggio mancante interrompe l'esecuzione con codice di uscita 2 e una riga che dice cosa fare.

### Un agente può pagare uno sblocco?

No. Ogni app si sblocca con un acquisto in-app una tantum che una persona fa dentro Exporter. Non c'è un pagamento sul web, né una chiave di licenza, né un pagamento da parte dell'agente. Lo dica alla persona; l'esecuzione successiva rileva lo sblocco.

### Quali agenti possono usarlo?

Tutto ciò che esegue comandi della shell può usare `exporter`. Tutto ciò che parla MCP su HTTP può collegarsi al server: Claude Code con un comando, Cursor e VS Code dai pulsanti sulla scheda Server MCP dell'app, Claude Desktop tramite una voce `mcp-remote` copiata.

### Quanto è privato?

La riga di comando e il server girano sul Mac della persona e leggono lì le sue esportazioni; il server ascolta solo su 127.0.0.1. Le skill dicono all'agente di riportare conteggi e percorsi, e di citare note o messaggi solo quando la persona lo chiede. [Privacy](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/it/agents
every page: https://exporter.dev/llms.txt
