Используйте этот навык всякий раз, когда пользователю нужно выполнить какие-либо действия с файлами PDF. Сюда входит чтение или извлечение текста/таблиц из PDF-файлов, объединение нескольких PDF-файлов в один, разделение PDF-файлов на части, поворот страниц, добавление водяных знаков, создание новых PDF-файлов, заполнение PDF-форм, шифрование/дешифрование PDF-файлов, извлечение изображений и распознавание текста (OCR) в отсканированных PDF-файлах для обеспечения возможности поиска по тексту. Если пользователь упоминает файл .pdf или просит создать такой файл, используйте этот навык.
...Расширить всеPDF Руководство по обработке
Обзор
В данном руководстве описаны основные операции по обработке данных PDF с использованием библиотек Python и инструментов командной строки. Информацию о расширенных функциях, библиотеках JavaScript и подробных примерах см. в файле REFERENCE.md. Если вам необходимо заполнить форму PDF, ознакомьтесь с файлом FORMS.md и следуйте приведенным в нем инструкциям.
Быстрый старт
from pypdf import PdfReader, Pdf Writer# Чтение файла PDF
reader = PdfReader("document.pdf")
print(f"Страниц: {len(reader.pages)}")# Извлечение текста
text = ""
for page in reader.pages:
text += page.extract_text()
Библиотеки Python
pypdf — основные операции
Объединение файлов PDF
from pypdf import PdfWriter, PdfReader writer = PdfWriter()
for pdf_file in ["doc1.pdf", "doc2.pdf", "doc3.pdf"]:
reader = PdfReader(pdf_file)
for page in reader.pages:
writer.add_page(page)with open("merged.pdf", "wb") as output:
writer.write(output)
Разделение PDF
reader = PdfReader("input.pdf")
for i, page in enumerate(reader.pages):
writer = PdfWriter()
writer.add_page(page)
with open(f"page_{i+1}.pdf", "wb") as output:
writer.write(output)
Извлечение метаданных
reader = PdfReader("document.pdf")
meta = reader.metadata
print(f"Название: {meta.title}")
print(f"Автор: {meta.author}")
print(f"Тема: {meta.subject}")
print(f"Создатель: {meta.creator}")
Поворот страниц
reader = PdfReader("input.pdf")
writer = PdfWriter()page = reader.pages[0]
page.rotate(90) # Поворот на 90 градусов по часовой стрелке
writer.add_page(page)with open("rotated.pdf", "wb") as output:
writer.write(output)
pdfplumber — извлечение текста и таблиц
Извлечение текста с сохранением макета
import pdfplumberwith pdfplumber.open("document.pdf") as pdf:
for page in pdf.pages:
text = page.extract_text()
print(text)
Извлечение таблиц
с помощью pdfplumber.open("document.pdf") as pdf:
for i, page in enumerate(pdf.pages):
tables = page.extract_tables()
for j, table in enumerate(tables):
print(f"Таблица {j+1} на странице {i+1}:")
for row in table:
print(row)
Расширенное извлечение таблиц
import pandas aspdwith pdfplumber.open("document.pdf") as pdf:
all_tables = []
for page in pdf.pages:
tables = page.extract_tables()
for table in tables:
if table: # Проверка, не пуста ли таблица
df = pd.DataFrame(table[1:], columns=table[0])
all_tables.append(df)# Объединение всех таблиц
if all_tables:
combined_df = pd.concat(all_tables,ignore_index=True)
combined_df.to_excel("extracted_tables.xlsx",index=False)
reportlab — Создание файлов PDF
Создание базового документа формата « PDF »
from reportlab.lib.pagesizes import letter
from reportlab.pdfgen import canvas
c = canvas.Canvas("hello.pdf", pagesize=letter)
width, height = letter
# Добавление текста
c.drawString(100, height - 100, "Hello World!")
c.drawString(100, height - 120, "This is a PDF created with reportlab")# Добавление линии
c.line(100, height - 140, 400, height - 140)# Сохранение
c.save()
Создание документа формата « PDF » с несколькими страницами
from reportlab.lib.pagesizes import letter
from reportlab.platypus import SimpleDocTemplate, Paragraph, Spacer, PageBreak
from reportlab.lib.styles import getSampleStyleSheetdoc = SimpleDocTemplate("report.pdf", pagesize=letter)
styles = getSampleStyleSheet()
story = []# Добавление содержимого
title = Paragraph("Название отчета", styles['Title'])
story.append(title)
story.append(Spacer(1, 12))body = Paragraph("Это основной текст отчета. " * 20, styles['Normal'])
story.append(body)
story.append(PageBreak())# Страница 2
story.append(Paragraph("Страница 2", styles['Heading1']))
story.append(Paragraph("Содержание страницы 2", styles['Normal']))# Сборка документа PDF
doc.build(story)
Индексы и надстрочные индексы
ВАЖНО: Никогда не используйте символы нижнего и верхнего индекса в формате Unicode (₀₁₂₃₄₅₆₇₈₉, ⁰¹²³⁴⁵⁶⁷⁸⁹) в документах ReportLab PDF. Встроенные шрифты не содержат этих глифов, в результате чего они отображаются в виде сплошных чёрных квадратов.
Вместо этого используйте теги XML-разметки ReportLab в объектах Paragraph:
from reportlab.platypus import Paragraph
from reportlab.lib.styles import getSampleStyleSheetstyles = getSampleStyleSheet()# Нижние индексы: используйте тег chemical = Paragraph("H2O", styles['Normal'])# Надстрочные индексы: используйте тег squared = Paragraph("x2 +y2 ", styles['Normal'])
Для текста, нарисованного на холсте (а не объектов Paragraph), вручную настройте размер и положение шрифта, а не используйте нижние и верхние индексы Unicode.
Инструменты командной строки
pdftotext (poppler-utils)
# Извлечение текста
pdftotext input.pdf output.txt# Извлечение текста с сохранением верстки
pdftotext -layout input.pdf output.txt# Извлечение определённых страниц
pdftotext -f 1 -l 5 input.pdf output.txt # Страницы 1–5
qpdf
# Объединение PDFs
qpdf --empty --pages file1.pdf file2.pdf -- merged.pdf# Разделение страниц
qpdf input.pdf --pages . 1-5 -- pages1-5.pdf
qpdf input.pdf --pages . 6-10 -- pages6-10.pdf# Поворот страниц
qpdf input.pdf output.pdf --rotate=+90:1 # Поворот страницы 1 на 90 градусов# Удаление пароля
qpdf --password=mypassword --decrypt encrypted.pdf decrypted.pdf
pdftk (если доступно)
# Объединение
pdftk file1.pdf file2.pdf cat output merged.pdf# Разделение
pdftk input.pdf burst# Поворот
pdftk input.pdf rotate 1east output rotated.pdf
Распространенные задачи
Извлечение текста из отсканированных изображений PDF
# Требуется: pip install pytesseract pdf2image
import pytesseract
from pdf2image import convert_from_path# Преобразование PDF в изображения
images = convert_from_path('scanned.pdf')# Оптическое распознавание текста (OCR) каждой страницы
text = ""
for i, image in enumerate(images):
text += f"Страница {i+1}:\n"
text += pytesseract.image_to_string(image)
text += "\n\n"print(text)
Добавить водяной знак
from pypdf import PdfReader, Pdf Writer# Создать водяной знак (или загрузить существующий)
watermark = PdfReader("watermark.pdf").pages[0]# Применить ко всем страницам
reader = PdfReader("document.pdf")
writer = PdfWriter()for page in reader.pages:
page.merge_page(watermark)
writer.add_page(page)with open("watermarked.pdf", "wb") as output:
writer.write(output)
Извлечение изображений
# Использование команды « pdf» (poppler-utils)
pdfimages -j input.pdf output_prefix# При этом все изображения будут извлечены с именами output_prefix-000.jpg, output_prefix-001.jpg и т. д.
Защита паролем
from pypdf import PdfReader, PdfWriterreader = PdfReader("input.pdf")
writer = PdfWriter()for page in reader.pages:
writer.add_page(page)# Добавление пароля
writer.encrypt("userpassword", "ownerpassword")with open("encrypted.pdf", "wb") as output:
writer.write(output)
Краткое руководство
Следующие шаги
- Для получения информации о расширенных возможностях библиотеки pypdfium2 см. файл REFERENCE.md
- Информацию о библиотеках JavaScript (pdf-lib) см. в файле REFERENCE.md
- Если вам нужно заполнить форму PDF, следуйте инструкциям в файле FORMS.md
- Руководства по устранению неполадок см. в файле REFERENCE.md
PDF Processing Guide
Overview
This guide covers essential PDF processing operations using Python libraries and command-line tools. For advanced features, JavaScript libraries, and detailed examples, see REFERENCE.md. If you need to fill out a PDF form, read FORMS.md and follow its instructions.
Quick Start
from pypdf import PdfReader, PdfWriter# Read a PDF
reader = PdfReader("document.pdf")
print(f"Pages: {len(reader.pages)}")# Extract text
text = ""
for page in reader.pages:
text += page.extract_text()
Python Libraries
pypdf - Basic Operations
Merge PDFs
from pypdf import PdfWriter, PdfReaderwriter = PdfWriter()
for pdf_file in ["doc1.pdf", "doc2.pdf", "doc3.pdf"]:
reader = PdfReader(pdf_file)
for page in reader.pages:
writer.add_page(page)with open("merged.pdf", "wb") as output:
writer.write(output)
Split PDF
reader = PdfReader("input.pdf")
for i, page in enumerate(reader.pages):
writer = PdfWriter()
writer.add_page(page)
with open(f"page_{i+1}.pdf", "wb") as output:
writer.write(output)
Extract Metadata
reader = PdfReader("document.pdf")
meta = reader.metadata
print(f"Title: {meta.title}")
print(f"Author: {meta.author}")
print(f"Subject: {meta.subject}")
print(f"Creator: {meta.creator}")
Rotate Pages
reader = PdfReader("input.pdf")
writer = PdfWriter()page = reader.pages[0]
page.rotate(90) # Rotate 90 degrees clockwise
writer.add_page(page)with open("rotated.pdf", "wb") as output:
writer.write(output)
pdfplumber - Text and Table Extraction
Extract Text with Layout
import pdfplumberwith pdfplumber.open("document.pdf") as pdf:
for page in pdf.pages:
text = page.extract_text()
print(text)
Extract Tables
with pdfplumber.open("document.pdf") as pdf:
for i, page in enumerate(pdf.pages):
tables = page.extract_tables()
for j, table in enumerate(tables):
print(f"Table {j+1} on page {i+1}:")
for row in table:
print(row)
Advanced Table Extraction
import pandas as pdwith pdfplumber.open("document.pdf") as pdf:
all_tables = []
for page in pdf.pages:
tables = page.extract_tables()
for table in tables:
if table: # Check if table is not empty
df = pd.DataFrame(table[1:], columns=table[0])
all_tables.append(df)# Combine all tables
if all_tables:
combined_df = pd.concat(all_tables, ignore_index=True)
combined_df.to_excel("extracted_tables.xlsx", index=False)
reportlab - Create PDFs
Basic PDF Creation
from reportlab.lib.pagesizes import letter
from reportlab.pdfgen import canvasc = canvas.Canvas("hello.pdf", pagesize=letter)
width, height = letter# Add text
c.drawString(100, height - 100, "Hello World!")
c.drawString(100, height - 120, "This is a PDF created with reportlab")# Add a line
c.line(100, height - 140, 400, height - 140)# Save
c.save()
Create PDF with Multiple Pages
from reportlab.lib.pagesizes import letter
from reportlab.platypus import SimpleDocTemplate, Paragraph, Spacer, PageBreak
from reportlab.lib.styles import getSampleStyleSheetdoc = SimpleDocTemplate("report.pdf", pagesize=letter)
styles = getSampleStyleSheet()
story = []# Add content
title = Paragraph("Report Title", styles['Title'])
story.append(title)
story.append(Spacer(1, 12))body = Paragraph("This is the body of the report. " * 20, styles['Normal'])
story.append(body)
story.append(PageBreak())# Page 2
story.append(Paragraph("Page 2", styles['Heading1']))
story.append(Paragraph("Content for page 2", styles['Normal']))# Build PDF
doc.build(story)
Subscripts and Superscripts
IMPORTANT: Never use Unicode subscript/superscript characters (₀₁₂₃₄₅₆₇₈₉, ⁰¹²³⁴⁵⁶⁷⁸⁹) in ReportLab PDFs. The built-in fonts do not include these glyphs, causing them to render as solid black boxes.
Instead, use ReportLab's XML markup tags in Paragraph objects:
from reportlab.platypus import Paragraph
from reportlab.lib.styles import getSampleStyleSheetstyles = getSampleStyleSheet()# Subscripts: use <sub> tag
chemical = Paragraph("H<sub>2</sub>O", styles['Normal'])# Superscripts: use <super> tag
squared = Paragraph("x<super>2</super> + y<super>2</super>", styles['Normal'])
For canvas-drawn text (not Paragraph objects), manually adjust font the size and position rather than using Unicode subscripts/superscripts.
Command-Line Tools
pdftotext (poppler-utils)
# Extract text
pdftotext input.pdf output.txt# Extract text preserving layout
pdftotext -layout input.pdf output.txt# Extract specific pages
pdftotext -f 1 -l 5 input.pdf output.txt # Pages 1-5
qpdf
# Merge PDFs
qpdf --empty --pages file1.pdf file2.pdf -- merged.pdf# Split pages
qpdf input.pdf --pages . 1-5 -- pages1-5.pdf
qpdf input.pdf --pages . 6-10 -- pages6-10.pdf# Rotate pages
qpdf input.pdf output.pdf --rotate=+90:1 # Rotate page 1 by 90 degrees# Remove password
qpdf --password=mypassword --decrypt encrypted.pdf decrypted.pdf
pdftk (if available)
# Merge
pdftk file1.pdf file2.pdf cat output merged.pdf# Split
pdftk input.pdf burst# Rotate
pdftk input.pdf rotate 1east output rotated.pdf
Common Tasks
Extract Text from Scanned PDFs
# Requires: pip install pytesseract pdf2image
import pytesseract
from pdf2image import convert_from_path# Convert PDF to images
images = convert_from_path('scanned.pdf')# OCR each page
text = ""
for i, image in enumerate(images):
text += f"Page {i+1}:\n"
text += pytesseract.image_to_string(image)
text += "\n\n"print(text)
Add Watermark
from pypdf import PdfReader, PdfWriter# Create watermark (or load existing)
watermark = PdfReader("watermark.pdf").pages[0]# Apply to all pages
reader = PdfReader("document.pdf")
writer = PdfWriter()for page in reader.pages:
page.merge_page(watermark)
writer.add_page(page)with open("watermarked.pdf", "wb") as output:
writer.write(output)
Extract Images
# Using pdfimages (poppler-utils)
pdfimages -j input.pdf output_prefix# This extracts all images as output_prefix-000.jpg, output_prefix-001.jpg, etc.
Password Protection
from pypdf import PdfReader, PdfWriterreader = PdfReader("input.pdf")
writer = PdfWriter()for page in reader.pages:
writer.add_page(page)# Add password
writer.encrypt("userpassword", "ownerpassword")with open("encrypted.pdf", "wb") as output:
writer.write(output)
Quick Reference
Next Steps
- For advanced pypdfium2 usage, see REFERENCE.md
- For JavaScript libraries (pdf-lib), see REFERENCE.md
- If you need to fill out a PDF form, follow the instructions in FORMS.md
- For troubleshooting guides, see REFERENCE.md
Установить pdf
Скачайте файлы навыков и распакуйте их в каталог .claude/skills/.
Скачать ZIPКлонируйте репозиторий и скопируйте файлы навыка в свой проект.
git clone https://github.com/anthropics/skills/tree/main/skills/pdf # Copy the skill folder to .claude/skills/ or .codex/skills/
Копировать





Дом
