{"id":50718456,"url":"https://github.com/jeongph/pdf-toolkit","last_synced_at":"2026-06-09T21:03:31.229Z","repository":{"id":353925580,"uuid":"1221446375","full_name":"jeongph/pdf-toolkit","owner":"jeongph","description":"범용 PDF 수정 도구 - 페이지 회전·삭제·순서변경·추출, PDF 병합·분할, 메타데이터 편집 (Claude Code plugin)","archived":false,"fork":false,"pushed_at":"2026-04-26T08:15:09.000Z","size":17,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-26T10:11:45.619Z","etag":null,"topics":["claude-code","claude-code-plugin","claude-plugin","pdf","pdf-merge","pdf-rotate","pdf-split","pdf-toolkit","pdf-tools","pymupdf"],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jeongph.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-04-26T08:06:46.000Z","updated_at":"2026-04-26T08:15:13.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/jeongph/pdf-toolkit","commit_stats":null,"previous_names":["jeongph/pdf-toolkit"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/jeongph/pdf-toolkit","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jeongph%2Fpdf-toolkit","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jeongph%2Fpdf-toolkit/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jeongph%2Fpdf-toolkit/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jeongph%2Fpdf-toolkit/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jeongph","download_url":"https://codeload.github.com/jeongph/pdf-toolkit/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jeongph%2Fpdf-toolkit/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34125332,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-09T02:00:06.510Z","response_time":63,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["claude-code","claude-code-plugin","claude-plugin","pdf","pdf-merge","pdf-rotate","pdf-split","pdf-toolkit","pdf-tools","pymupdf"],"created_at":"2026-06-09T21:03:30.227Z","updated_at":"2026-06-09T21:03:31.220Z","avatar_url":"https://github.com/jeongph.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# pdf-toolkit\n\n\u003e 범용 PDF 수정 도구 — 페이지 회전·삭제·순서변경·추출, PDF 병합·분할, 메타데이터 편집을 안전한 비파괴 방식으로 수행합니다.\n\nPyMuPDF 기반으로 일반인이 쓰는 PDF 작업의 90%를 cover하는 Claude Code 플러그인입니다. 자연어로 호출하거나 슬래시 명령으로 정밀 제어할 수 있고, **원본은 항상 보존**됩니다.\n\n## 설치\n\n마켓플레이스 등록(최초 1회):\n\n```\n/plugin marketplace add jeongph/claude-plugins\n```\n\n플러그인 설치:\n\n```\n/plugin install pdf-toolkit@jeongph-claude-plugins\n```\n\n## 사용 예\n\n자연어:\n```\n이 PDF 54페이지 회전시켜줘\n1, 2 페이지 삭제해줘\nbook1.pdf와 book2.pdf 합쳐줘\nbook.pdf를 1-100, 101-200으로 나눠줘\n```\n\n슬래시 명령:\n```\n/pdf-rotate book.pdf 54 180\n/pdf-delete book.pdf 1,2,28\n/pdf-extract book.pdf 100-200 -o samples.pdf\n/pdf-merge cover.pdf body.pdf -o full.pdf\n/pdf-split book.pdf 1-100,101-200,201-end\n/pdf-reorder book.pdf swap:54,55\n/pdf-meta book.pdf --title \"...\" --author \"...\"\n```\n\n## 지원 작업\n\n| 작업 | slash command | 설명 |\n|---|---|---|\n| 페이지 회전 | `/pdf-rotate` | 단일/범위/전체 페이지 90·180·270° 회전 |\n| 페이지 삭제 | `/pdf-delete` | 지정 페이지 제거 |\n| 페이지 순서 변경 | `/pdf-reorder` | 새 순서 명시 또는 두 페이지 swap |\n| 페이지 추출 | `/pdf-extract` | 지정 페이지만 새 PDF로 |\n| PDF 병합 | `/pdf-merge` | 여러 PDF를 하나로 |\n| PDF 분할 | `/pdf-split` | 페이지 범위로 여러 PDF로 분할 |\n| 메타데이터 편집 | `/pdf-meta` | title·author·subject·keywords 표시·편집 |\n\n## 페이지 지정 문법\n\n- 단일: `5`\n- 범위: `5-10`\n- 다중: `1,3,5,10-12`\n- 전체: `all`\n- 끝까지: `15-` 또는 `15-end`\n\n## 안전 원칙\n\n| 원칙 | 구현 |\n|---|---|\n| 원본 절대 보존 | 모든 작업은 새 파일에 출력 |\n| 출력 경로 명시 | `-o`로 지정. 미지정 시 `\u003c원본\u003e.modified.pdf` 자동 생성 |\n| in-place 명시적 | `--in-place` 옵션이 있어야만 원본 덮어쓰기 |\n| 검증 후 실행 | 페이지 인자·순서 등을 사전 검증, 잘못된 입력은 거부 |\n\n## 의존성\n\n- Python 3.8+\n- [PyMuPDF](https://pymupdf.readthedocs.io/) (`pip install pymupdf`)\n\n## 디렉토리 구조\n\n```\npdf-toolkit/\n├── .claude-plugin/plugin.json\n├── skills/pdf-toolkit/\n│   ├── SKILL.md\n│   ├── scripts/\n│   │   ├── _util.py\n│   │   ├── rotate.py\n│   │   ├── delete.py\n│   │   ├── reorder.py\n│   │   ├── extract.py\n│   │   ├── merge.py\n│   │   ├── split.py\n│   │   └── meta.py\n│   └── references/\n│       ├── safety.md\n│       └── examples.md\n├── commands/\n│   ├── pdf-rotate.md\n│   ├── pdf-delete.md\n│   ├── pdf-reorder.md\n│   ├── pdf-extract.md\n│   ├── pdf-merge.md\n│   ├── pdf-split.md\n│   └── pdf-meta.md\n├── requirements.txt\n└── README.md\n```\n\n## 향후 확장 (v0.2.0+)\n\n- 페이지 크기 정규화·마진 크롭\n- DPI 다운샘플·이미지 재압축·워터마크\n- OCR 레이어 재생성 (별도 plugin 가능성)\n\n## 라이선스\n\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjeongph%2Fpdf-toolkit","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjeongph%2Fpdf-toolkit","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjeongph%2Fpdf-toolkit/lists"}