# 에이전트를 위한 Exporter

스킬 다섯 개가 에이전트에게 Exporter로 내보내고, 백업하고, 검색하는 법을 가르칩니다.

## 스킬 다섯 개

위 명령은 이 사이트의 [스킬 목록](https://exporter.dev/.well-known/skills/index.json)에서 [skills CLI](https://github.com/vercel-labs/skills)로 다섯 개를 모두 설치합니다. 또는 아래 SKILL.md를 에이전트의 스킬 폴더에 저장하세요.

- [export-apple-notes](https://exporter.dev/.well-known/skills/export-apple-notes/SKILL.md): `exporter`로 Apple 메모를 Markdown 또는 HTML 파일로 내보내고, 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): Apple 메모를 Obsidian 보관소 안의 폴더에 넣고, 안전하게 동기화 상태로 유지합니다. (`.well-known/skills/apple-notes-to-obsidian/SKILL.md`)
- [backup-apple-notes](https://exporter.dev/.well-known/skills/backup-apple-notes/SKILL.md): 매일 밤 미러, 날짜가 붙은 스냅샷, 또는 백업 도구의 사전 단계, 그리고 마지막 백업이 실행됐는지 확인합니다. (`.well-known/skills/backup-apple-notes/SKILL.md`)
- [notes-as-claude-context](https://exporter.dev/.well-known/skills/notes-as-claude-context/SKILL.md): 로컬 MCP 서버로 메모, 연락처, 대화를 검색하고 읽습니다. (`.well-known/skills/notes-as-claude-context/SKILL.md`)
- [export-messages](https://exporter.dev/.well-known/skills/export-messages/SKILL.md): iMessage 대화를 Markdown으로, 대화마다 파일 하나, 첨부 파일까지. (`.well-known/skills/export-messages/SKILL.md`)

## 에이전트가 할 수 있는 일

- 내보내기: `exporter sync --source apple --json --quiet`로 앱의 내보내기 폴더에, 또는 `exporter export --dest <folder>`로 사람이 명령줄 카드에서 권한을 준 어떤 폴더에든 내보냅니다.
- 예약 백업: `exporter help cron`은 실제 경로가 들어간 crontab 줄을 출력합니다: 편집을 따라가는 미러, 또는 바뀌지 않는 날짜별 스냅샷.
- 결과 읽기: sync, export, list, status, log에서 `--json`. 종료 코드: 0 정상, 1 내보내기 실패, 2 설정 필요, 64 사용법 오류.
- 컨텍스트로 검색: MCP로 내보낸 파일에서 `search`, `read`, `list`, `get_recent`, `get_stats`, `get_metadata`. [도구 여섯 개](https://exporter.dev/docs/mcp).
- 상태 파악: `exporter status --json`은 각 앱, 마지막 내보내기, 무료 등급과 사용한 개수를 보여줍니다. `exporter list sources --json`은 무엇이 얼마나 있는지 셉니다.
- 한도 파악: 무료 한도를 넘은 실행도 0으로 종료하며, 건너뛴 것을 알려주는 `note:` 줄을 출력합니다. 해당 앱은 사람이 Exporter에서 한 번 잠금 해제합니다.

## 설정

앱이 샌드박스 안에 있으므로 처음 두 단계는 사람이 합니다. 나머지는 에이전트가 합니다.

1. 사람이 앱을 설치: Mac App Store에서 Exporter를 받아 한 번 엽니다. 앱을 연결하고 내보내기 폴더를 고르는 일은 앱에서만 할 수 있습니다.
2. 사람이 한 줄을 붙여넣기: 앱의 명령줄 카드에서 “설치 명령 복사”를 누르고 터미널에 한 번 붙여넣습니다. 샌드박스 안의 앱은 스스로 PATH에 쓸 수 없습니다. `exporter help install`은 그 Mac에 맞는 줄을 출력합니다.
3. 에이전트가 스킬을 익히기: `npx skills add https://exporter.dev`는 이 사이트의 스킬 목록에서 위의 스킬 다섯 개를 설치합니다.
4. 에이전트가 확인하고 실행: `exporter doctor`는 무엇이 빠졌는지 알려주며, 실패한 항목마다 아래에 `fix:` 줄을 붙입니다. 그다음 `exporter sync --json --quiet`가 내보내고 JSON 요약 하나를 출력합니다.
5. 에이전트가 컨텍스트로 읽기: 앱의 카드에서 MCP 서버를 시작하면, `claude mcp add --transport http exporter http://localhost:8744/mcp`가 Claude Code를 내보낸 파일에 연결합니다.

## 질문

### 에이전트가 할 수 없는 일은 무엇인가요?

앱 연결, 내보내기 폴더 선택, 폴더 권한 부여, MCP 서버 시작, 잠금 해제 구매입니다. 이런 일은 사람이 앱에서 합니다. 명령줄은 절대 확인을 요청하지 않습니다. 빠진 단계가 있으면 종료 코드 2와 해야 할 일을 알려주는 한 줄로 실행을 멈춥니다.

### 에이전트가 잠금 해제 비용을 낼 수 있나요?

아니요. 각 앱은 사람이 Exporter 안에서 하는 일회성 앱 내 구매로 잠금 해제됩니다. 웹 결제도, 라이선스 키도, 에이전트 결제도 없습니다. 사람에게 알려 주세요. 다음 실행부터 잠금 해제가 반영됩니다.

### 어떤 에이전트가 쓸 수 있나요?

셸 명령을 실행할 수 있다면 무엇이든 `exporter`를 다룰 수 있습니다. HTTP로 MCP를 쓸 수 있다면 무엇이든 서버에 연결할 수 있습니다: Claude Code는 명령 한 줄로, Cursor와 VS Code는 앱의 MCP 서버 카드에 있는 버튼으로, Claude Desktop은 복사한 `mcp-remote` 항목으로 연결합니다.

### 개인정보는 어떻게 보호되나요?

명령줄과 서버는 사람의 Mac에서 실행되며 그곳에 있는 내보낸 파일을 읽습니다. 서버는 127.0.0.1에서만 수신합니다. 스킬은 에이전트에게 개수와 경로를 보고하고, 메모나 메시지는 사람이 요청할 때만 인용하라고 가르칩니다. [개인정보 보호](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/ko/agents
every page: https://exporter.dev/llms.txt
