pdf

name	pdf
description	마케팅 PDF 문서 제작 및 처리를 위한 종합 도구
version	1.0.0
author	Dante Labs
tags	["pdf","document","marketing","report"]

Marketing PDF Toolkit

마케팅 리포트, 브로슈어, 제안서 등 전문 PDF 문서를 제작하고 처리하는 도구입니다.

주요 기능

기능	설명	용도
텍스트 추출	PDF → 텍스트/마크다운	경쟁사 자료 분석
테이블 추출	PDF 테이블 → CSV/DataFrame	데이터 분석
PDF 병합	여러 PDF → 하나로	캠페인 패키지
PDF 분할	하나 → 여러 PDF	섹션별 배포
PDF 생성	텍스트/HTML → PDF	리포트 생성

Workflow 1: 텍스트 추출

기본 텍스트 추출

import pdfplumber

def extract_text(pdf_path):
    """PDF에서 텍스트 추출"""
    text_content = []

    with pdfplumber.open(pdf_path) as pdf:
        for page in pdf.pages:
            text = page.extract_text()
            if text:
                text_content.append(text)

    return "\n\n".join(text_content)

# 사용
text = extract_text("competitor_report.pdf")

마크다운 변환

def pdf_to_markdown(pdf_path, output_path):
    """PDF를 구조화된 마크다운으로 변환"""
    with pdfplumber.open(pdf_path) as pdf:
        markdown_lines = []

        for i, page in enumerate(pdf.pages, 1):
            markdown_lines.append(f"## Page {i}\n")

            # 텍스트 추출
            text = page.extract_text() or ""
            markdown_lines.append(text)

            # 테이블 추출
            tables = page.extract_tables()
            for table in tables:
                markdown_lines.append(table_to_markdown(table))

            markdown_lines.append("\n---\n")

    with open(output_path, 'w') as f:
        f.write("\n".join(markdown_lines))

Workflow 2: 테이블 추출

CSV로 테이블 추출

import pdfplumber
import pandas as pd

def extract_tables(pdf_path, output_dir):
    """PDF의 모든 테이블을 CSV로 추출"""
    with pdfplumber.open(pdf_path) as pdf:
        table_count = 0

        for page_num, page in enumerate(pdf.pages, 1):
            tables = page.extract_tables()

            for idx, table in enumerate(tables):
                if table and len(table) > 1:
                    df = pd.DataFrame(table[1:], columns=table[0])
                    output_path = f"{output_dir}/table_p{page_num}_{idx+1}.csv"
                    df.to_csv(output_path, index=False, encoding='utf-8-sig')
                    table_count += 1

    return table_count

Workflow 3: PDF 병합/분할

PDF 병합

from pypdf import PdfReader, PdfWriter

def merge_pdfs(pdf_list, output_path):
    """여러 PDF를 하나로 병합"""
    writer = PdfWriter()

    for pdf_path in pdf_list:
        reader = PdfReader(pdf_path)
        for page in reader.pages:
            writer.add_page(page)

    with open(output_path, 'wb') as f:
        writer.write(f)

    return output_path

# 캠페인 패키지 생성 예시
merge_pdfs([
    "brand_intro.pdf",
    "campaign_proposal.pdf",
    "budget_breakdown.pdf"
], "campaign_package.pdf")

PDF 분할

def split_pdf(pdf_path, output_dir, pages_per_file=1):
    """PDF를 여러 파일로 분할"""
    reader = PdfReader(pdf_path)
    total_pages = len(reader.pages)

    outputs = []
    for start in range(0, total_pages, pages_per_file):
        writer = PdfWriter()
        end = min(start + pages_per_file, total_pages)

        for page_num in range(start, end):
            writer.add_page(reader.pages[page_num])

        output_path = f"{output_dir}/section_{start//pages_per_file + 1}.pdf"
        with open(output_path, 'wb') as f:
            writer.write(f)
        outputs.append(output_path)

    return outputs

Workflow 4: 마케팅 PDF 생성

ReportLab을 사용한 PDF 생성

from reportlab.lib.pagesizes import A4
from reportlab.lib.styles import getSampleStyleSheet, ParagraphStyle
from reportlab.lib.units import mm
from reportlab.platypus import SimpleDocTemplate, Paragraph, Spacer, Table, Image
from reportlab.lib.colors import HexColor

def create_marketing_report(content, output_path):
    """마케팅 리포트 PDF 생성"""
    doc = SimpleDocTemplate(
        output_path,
        pagesize=A4,
        rightMargin=20*mm,
        leftMargin=20*mm,
        topMargin=25*mm,
        bottomMargin=20*mm
    )

    # 스타일 정의
    styles = getSampleStyleSheet()

    title_style = ParagraphStyle(
        'CustomTitle',
        parent=styles['Heading1'],
        fontSize=24,
        spaceAfter=30,
        textColor=HexColor('#1a365d')
    )

    heading_style = ParagraphStyle(
        'CustomHeading',
        parent=styles['Heading2'],
        fontSize=16,
        spaceBefore=20,
        spaceAfter=10,
        textColor=HexColor('#2b6cb0')
    )

    body_style = ParagraphStyle(
        'CustomBody',
        parent=styles['Normal'],
        fontSize=11,
        leading=16,
        textColor=HexColor('#2d3748')
    )

    # 콘텐츠 구성
    story = []

    # 제목
    story.append(Paragraph(content['title'], title_style))
    story.append(Spacer(1, 20))

    # 섹션들
    for section in content['sections']:
        story.append(Paragraph(section['heading'], heading_style))
        story.append(Paragraph(section['body'], body_style))
        story.append(Spacer(1, 10))

    doc.build(story)
    return output_path

Markdown → PDF 변환

import markdown
from weasyprint import HTML

def markdown_to_pdf(md_path, output_path):
    """마크다운을 스타일링된 PDF로 변환"""
    # 마크다운 읽기
    with open(md_path, 'r') as f:
        md_content = f.read()

    # HTML 변환
    html_content = markdown.markdown(
        md_content,
        extensions=['tables', 'fenced_code']
    )

    # 스타일 추가
    styled_html = f"""
    <!DOCTYPE html>
    <html>
    <head>
        <meta charset="UTF-8">
        <style>
            @import url('https://fonts.googleapis.com/css2?family=Noto+Sans+KR:wght@300;400;500;700&display=swap');

            body {{
                font-family: 'Noto Sans KR', sans-serif;
                line-height: 1.6;
                color: #2d3748;
                max-width: 210mm;
                padding: 20mm;
            }}

            h1 {{
                color: #1a365d;
                border-bottom: 2px solid #ed8936;
                padding-bottom: 10px;
            }}

            h2 {{
                color: #2b6cb0;
                margin-top: 30px;
            }}

            table {{
                width: 100%;
                border-collapse: collapse;
                margin: 20px 0;
            }}

            th, td {{
                border: 1px solid #e2e8f0;
                padding: 10px;
                text-align: left;
            }}

            th {{
                background-color: #f7fafc;
                color: #1a365d;
            }}
        </style>
    </head>
    <body>
        {html_content}
    </body>
    </html>
    """

    # PDF 생성
    HTML(string=styled_html).write_pdf(output_path)
    return output_path

마케팅 PDF 디자인 가이드

컬러 팔레트

리포트용 (공식적/전문적)

Header:     #1a365d (Navy)
Accent:     #ed8936 (Orange)
Body Text:  #2d3748 (Dark Gray)
Background: #ffffff (White)
Borders:    #e2e8f0 (Light Gray)

브로슈어용 (활기찬/매력적)

Primary:    #2b6cb0 (Blue)
Accent:     #38a169 (Green)
Highlight:  #f6e05e (Yellow)
Text:       #1a202c (Black)

레이아웃 원칙

┌─────────────────────────────────────┐
│  [로고]              마케팅 리포트  │ ← 헤더
├─────────────────────────────────────┤
│                                     │
│  Executive Summary                  │
│  ─────────────────                  │
│                                     │
│  요약 내용...                        │
│                                     │
├─────────────────────────────────────┤
│  1. 분석 개요                        │
│                                     │
│  상세 내용...                        │
│                                     │
│  [데이터 테이블]                     │
│  ┌───────┬───────┬───────┐         │
│  │       │       │       │         │
│  └───────┴───────┴───────┘         │
│                                     │
├─────────────────────────────────────┤
│           Page 1                    │ ← 푸터
└─────────────────────────────────────┘

타이포그래피

요소	폰트	크기	색상
문서 제목	Noto Sans KR Bold	24pt	#1a365d
섹션 제목	Noto Sans KR Bold	16pt	#2b6cb0
소제목	Noto Sans KR Medium	13pt	#4a5568
본문	Noto Sans KR Regular	11pt	#2d3748
캡션	Noto Sans KR Light	9pt	#718096

마케팅 PDF 유형별 템플릿

1. 캠페인 리포트

# 캠페인 성과 리포트

## Executive Summary
- 주요 성과 지표
- 핵심 인사이트

## 캠페인 개요
- 목표
- 기간
- 예산

## 채널별 성과
| 채널 | 도달 | 참여 | 전환 |
|------|------|------|------|
| ... | ... | ... | ... |

## 인사이트 및 제언

## 다음 단계

2. 브랜드 브로슈어

# [브랜드명]

## 우리의 스토리
브랜드 탄생 배경...

## 핵심 가치
- 가치 1
- 가치 2
- 가치 3

## 제품/서비스
[이미지 + 설명]

## 연락처

3. 경쟁사 분석 리포트

# 경쟁사 분석 리포트

## 분석 대상
- 경쟁사 A
- 경쟁사 B
- 경쟁사 C

## 포지셔닝 맵
[차트]

## 상세 분석
### 경쟁사 A
- 강점
- 약점
- 위협 요소

## 전략적 시사점

File Storage

PDF 문서는 프로젝트의 표준 디렉토리 구조에 저장합니다.

{project}/
├── reports/
│   ├── pdf/                 # 최종 PDF 문서
│   │   ├── campaign-report-20240115.pdf
│   │   ├── brand-brochure-20240115.pdf
│   │   └── competitor-analysis-20240115.pdf
│   └── exports/             # PDF에서 추출한 데이터
│       ├── tables/          # 추출된 테이블 (CSV)
│       └── text/            # 추출된 텍스트
├── assets/
│   └── pdf-resources/       # PDF 리소스
│       ├── templates/       # PDF 템플릿
│       └── images/          # 삽입용 이미지
└── tmp/
    └── pdf-drafts/          # 초안 및 작업 파일

파일 명명 규칙

{project}/reports/pdf/{type}-{subject}-{date}.pdf

예시:
reports/pdf/campaign-report-q1-20240115.pdf
reports/pdf/brand-brochure-dante-coffee-20240115.pdf
reports/pdf/competitor-analysis-20240115.pdf

패키지 설치

# 필수 패키지
pip install pypdf pdfplumber reportlab

# 선택적 패키지 (고급 기능)
pip install weasyprint markdown  # MD → PDF 변환
pip install pytesseract pdf2image  # OCR

스크립트 및 레퍼런스

레퍼런스 문서

문서	경로	설명
PDF 폼 가이드	forms.md	Fillable Fields 및 Annotations 폼 작업 가이드

스크립트

스크립트	경로	설명
extract_form_field_info.py	scripts/	Fillable 필드 정보 추출
check_fillable_fields.py	scripts/	Fillable 필드 존재 확인
fill_fillable_fields.py	scripts/	Fillable 필드 값 채우기
fill_pdf_form_with_annotations.py	scripts/	주석으로 텍스트 오버레이
convert_pdf_to_images.py	scripts/	PDF → 이미지 변환
check_bounding_boxes.py	scripts/	바운딩 박스 시각화
create_validation_image.py	scripts/	결과 검증 이미지 생성

Usage

이 스킬은 brand-strategist, competitive-analyst 에이전트가 리포트 생성 및 경쟁사 자료 분석 시 참조합니다.