# privacy-parser-pii-extraction

Находит в тексте персональные данные и возвращает их с меткой, значением и позицией в строке. Пригодится, когда нужно разобрать лог или документ перед отправкой наружу.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 310 установок · ★ 88
- Автор: reason-machines
- Лицензия: не указана · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/reason-machines/trending-skills/tree/HEAD/skills/privacy-parser-pii-extraction/SKILL.md
- Обновлён: 2026-10-09
- HTML: https://affpapa.org/nevibecode/skills/privacy-parser-pii-extraction

## Что делает

Скилл работает поверх библиотеки privacy-parser — это обратная сторона OpenAI Privacy Filter. Фильтр заменяет PII на `<REDACTED>`, а здесь вы получаете структурированные спаны: метку, сам фрагмент и смещения символов в исходной строке. Модель та же — `opf` 1.5B с той же таксономией меток.

Внутри три бэкенда на выбор. `PIIParser` обходится без весов и ловит данные известного формата регулярками за микросекунды. `ModelPIIParser` гоняет только модель. `HybridPIIParser` добавляет к модели склейку соседних спанов и regex-подстраховку на секреты, номера счетов и URL — именно его стоит брать для рабочего кода. Метки: `private_person`, `private_email`, `private_phone`, `private_address`, `private_url`, `private_date`, `account_number`, `secret`.

Первый запуск скачивает чекпоинт `opf` 1.5B примерно на 3 ГБ в `~/.opf/privacy_filter/`, дальше он берётся из кеша. На GPU модели нужно около 3 ГБ видеопамяти, иначе переключайтесь на `device="cpu"` — на процессоре разбор идёт порядка 600 мс. Смещения считаются по той строке, которую вы передали в `parse()`, поэтому не чистите и не обрезайте текст заранее, если позиции нужны точные.

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add reason-machines/trending-skills --skill privacy-parser-pii-extraction -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/privacy-parser-pii-extraction/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/privacy-parser-pii-extraction/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add reason-machines/trending-skills --skill privacy-parser-pii-extraction -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/privacy-parser-pii-extraction/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add reason-machines/trending-skills --skill privacy-parser-pii-extraction -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/privacy-parser-pii-extraction/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install reason-machines/trending-skills privacy-parser-pii-extraction
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/privacy-parser-pii-extraction/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add reason-machines/trending-skills --skill privacy-parser-pii-extraction -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/reason-machines/trending-skills --path skills/privacy-parser-pii-extraction
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/privacy-parser-pii-extraction/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add reason-machines/trending-skills --skill privacy-parser-pii-extraction -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/reason-machines/trending-skills/tree/HEAD/skills/privacy-parser-pii-extraction/SKILL.md

## Когда брать
- вытащить из лога письма, телефоны и номера счетов со смещениями
- разметить датасет персональных данных для обучения
- проверить, не утекли ли токены и пароли в тексте тикета
- собрать JSON со всеми PII из документа перед публикацией
- замаскировать найденные фрагменты уже после просмотра

## Примеры запросов агенту
- Прогони этот текст через privacy-parser и покажи все найденные PII со смещениями
- Найди в `dump.txt` секреты и номера счетов, выведи результат в JSON
- Разбери строку на персональные данные и замени каждый спан на метку в квадратных скобках

## Похожие
- [pii-detect](https://affpapa.org/nevibecode/skills/pii-detect.md) — скилл · 762 установки
- [privacy-policy](https://affpapa.org/nevibecode/skills/privacy-policy.md) — скилл · 3500 установок
- [privacy-engineering](https://affpapa.org/nevibecode/skills/privacy-engineering.md) — скилл · 352 установки
- [pdf-extraction](https://affpapa.org/nevibecode/skills/pdf-extraction.md) — скилл · 9300 установок
- [gdpr-compliance](https://affpapa.org/nevibecode/skills/gdpr-compliance.md) — скилл · 365 установок
- [azure-ai-textanalytics-py](https://affpapa.org/nevibecode/skills/azure-ai-textanalytics-py.md) — скилл · 2 установки

Из того же набора: [reason-machines/trending-skills](https://affpapa.org/nevibecode/by/reason-machines/trending-skills.md) — 199 карточек

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md