pdfcpu CLI
pdfcpu проверяет, объединяет и разделяет PDF, извлекает содержимое и управляет страницами через отдельный командный интерфейс.
- 8 897 ★ репозитория
- Последний коммит
- Apache-2.0
Расширенный доступ
Почему такой уровень
- Команды изменяют документы и могут затронуть подписи, шифрование и доступные локальные изображения.
Установка
Ручная установка
Направь к официальной инструкции CLI из README. Начни с validate, уточни действие и пути, сохрани отдельный результат и открой его для сверки.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Команды изменяют документы и могут затронуть подписи, шифрование и доступные локальные изображения.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Пользователь выбирает операцию и входные документы: от проверки структуры до сборки нескольких PDF. В pdfcpu есть команды разделения, поворота страниц и извлечения изображений, шрифтов и метаданных. Одинаковую последовательность можно повторять для пакета файлов. Отдельные операции работают с шифрованием, формами, вложениями и целостностью подписей. CLI запускается независимо от библиотечного Go API. Обработанный файл сохраняют отдельно от исходника и открывают в просмотрщике: успешное завершение команды само по себе не подтверждает правильность внешнего вида и порядка страниц.
Для кого. Операторам документооборота, которые собирают PDF-пакеты, меняют состав страниц и сохраняют исходники для сравнения.
Подходит, если
- Оператор объединяет несколько PDF в согласованном порядке.
- Автор делит большой документ на части для отдельных получателей.
- Перед передачей инженер проверяет структуру файла.
- Из собственного документа пользователь извлекает изображения, шрифты или метаданные.
Не подходит, если
- Нужен полноценный визуальный редактор сложной верстки.
- Результат должен считаться идентичным исходнику без визуального сравнения.
- Файл нельзя изменять по правилам документооборота или целостности подписи.
Пример запроса к агенту
Проверь структуру двух моих PDF, предложи порядок объединения и сохрани результат отдельно, не меняя исходники.Ограничения
Поддержка проверки PDF 2.0 пока базовая и продолжает развиваться. Сложный или поврежденный файл может не обработаться, даже если выбранная операция подходит по названию; сначала проверьте его открытие обычным просмотрщиком. Любое изменение документа может затронуть подпись или порядок страниц, поэтому исходник нужен до завершения сравнения. Локальные изображения для создания и заполнения форм ограничены разрешенным корневым каталогом, который задается отдельно.
Как отключить. Остановите пакетную обработку и сохраните исходники отдельно от результатов. Удаление pdfcpu не отменяет уже измененные документы.
Частые вопросы
С какой команды начать проверку?
`pdfcpu validate input.pdf` выводит результат проверки структуры и найденные проблемы.
Что происходит при объединении?
`pdfcpu merge merged.pdf in1.pdf in2.pdf` создаст merged.pdf из in1.pdf и in2.pdf в этом порядке. Для результата используйте отдельное имя.
Придется писать программу на Go?
Нет. Готовый CLI выполняет операции без подключения библиотеки к своему коду.
PDF 2.0 проверяется целиком?
Нет. Базовая поддержка не охватывает все возможности стандарта.
Почему команда формы не видит картинку?
Изображение может находиться вне разрешенного корня. Задайте папку через `localImageRoot` в config.yml, затем повторите операцию с файлом внутри этой папки.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
CLI-инструментыMCP PDF от ComPDF: агент конвертирует PDF и изображения в Word, Excel, Markdown и JSON, объединяет, режет, защищает и сравнивает файлы через облачный API
MCP PDF для больших документов: агент ищет по смыслу и по ключевым словам в одном файле или папке и читает только нужные страницы, таблицы и сканы
Docling — CLI для смешанного архива: PDF, документы и таблицы можно привести к общему формату для поиска и ИИ.
Перевод научных PDF с сохранением формул, таблиц и верстки: CLI, Docker и MCP-сервер для агентов
MinerU — CLI с библиотекой документов: уже разобранный отчет можно искать и читать повторно из локального кеша.
PyPDFForm CLI сохраняет заполненную форму отдельным PDF: поля можно оставить редактируемыми или перевести в режим чтения.
Коротко о README
Если pdfcpu не обрабатывает файл, `pdfcpu validate -vv <file.pdf>` выводит подробную диагностику. Перед передачей такого журнала другим людям удалите из него сведения закрытого документа.