**Check lastest version [here](https://github.com/ilotoki0804/WebtoonScraper).**
# WebtoonScraper
[](https://github.com/ilotoki0804/WebtoonScraper/releases)
[](https://pypi.org/project/WebtoonScraper/)
[](https://github.com/ilotoki0804/WebtoonScraper)
[](https://toss.me/ilotoki)
**English documentation is available [here](https://github.com/ilotoki0804/WebtoonScraper/blob/master/docs/README_eng.md).**
최대 규모 오픈 소스 웹툰 스크래퍼입니다.
**네이버 웹툰(베스트 도전, 도전만화 포함), webtoons.com, 버프툰, 네이버 포스트, 네이버 게임, 레진 코믹스, 카카오페이지, 네이버 블로그, 티스토리, 카카오 웹툰**을 지원하고, 계속해서 지원 목록을 확대할 계획입니다.
저작권과 책임에 대한 내용을 더욱 자세히 알고 싶다면 [이 문서](https://github.com/ilotoki0804/WebtoonScraper/blob/master/docs/copyright.md)를 참고해 주세요.
## 실행 파일로 이용하기
이 패키지는 Windows, macOS, Linux에서 실행 파일 형태로 사용할 수 있습니다.
1. [릴리즈 페이지](https://github.com/ilotoki0804/WebtoonScraper/releases)로 가세요.
1. 최신 릴리즈 아래에서 자신의 운영 체제와 일치하는 이름이 적힌 zip 파일을 클릭해 다운로드하세요.
1. zip파일을 풀고 사용하세요.
> [!WARNING]
> 윈도우의 경우 "Windows의 PC 보호" 창이 뜨면서 실행이 안 될 수 있습니다. 그런 경우에는 `추가 정보`(왼쪽 중간에 있습니다.)를 클릭하고 `실행`을 누르세요.
## Installation
1. 파이썬(3.10 이상, 최신 버전 권장)을 설치합니다. 꼭 PATH에 파이썬이 포함되도록 설치하세요.
1. 터미널에서 다음과 같은 명령어를 실행합니다.
```console
pip install -U WebtoonScraper[full]
```
잘 설치되었는지를 확인하려면 다음의 명령어를 사용해 보세요.
```console
webtoon --version
```
> 만약 `webtoon` 명령어가 잘 실행되지 않는다면 다음의 코드를 사용해 보세요.
>
> ```console
> python -m WebtoonScraper --version
> ```
>
> 자신의 환경에 따라 `python` 대신 `python3`나 `py -3.12`과 같은 코드를 적절히 사용해야 할 수 있습니다.
아래와 같거나 비슷한 메시지가 출력된다면 제대로 설치된 것입니다.
```console
WebtoonScraper 3.2.2 of Python 3.11.4 ... at ...
✅ All extra dependencies are installed!
```
> 다음과 같은 경고 메시지가 나올 수 있습니다.
>
> ```console
> WebtoonScraper 3.2.2 of Python 3.11.4 ... at ...
> ⚠️ Extra dependencies 'kakao_webtoon', 'lezhin_comics', 'naver_post' are not installed.
> You won't be able to download webtoons from following platforms: 'Kakao Webtoon', 'Lezhin Comics (partially)', 'Naver Post'.
> ```
>
> 이 경우 표시된 플랫폼들(이 오류 메시지의 경우 카카오 웹툰, 레진 코믹스(부분적), 네이버 포스트)에 대한 추가적인 의존성이 설치되지 않는 것인데, 따라서 이 플랫폼들의 웹툰을 다운로드할 수 없게 됩니다.
>
> 다음과 같이 명령어를 짜면 모든 플랫폼에서 웹툰을 다운로드할 수 있습니다.
>
> ```console
> pip install -U WebtoonScraper[full]
> ```
## How to use
대부분의 웹툰은 다음과 같이 터미널에 `webtoon download`를 치고 큰따옴표로 감싼 URL을 뒤에 위치하면 작동합니다.
```console
webtoon download "https://comic.naver.com/webtoon/list?titleId=819217"
```
만약 더 많은 WebtoonScraper의 기능(범위 설정 다운로드, 모아서 보기, 다운로드할 디렉토리 설정, 에피소드 리스팅, 파이썬으로 사용 등)을 알고 싶거나 위에서 소개한 방식으로는 잘 작동하지 않는 경우(특히 버프툰, 레진코믹스의 경우 추가적인 설정이 필수적입니다.)에는 [`사용 방법` 문서](https://github.com/ilotoki0804/WebtoonScraper/blob/master/docs/how_to_use.md)를 참고해 주세요.
## 이 라이브러리가 다운로드 가능한 웹툰/에피소드의 종류
[이 라이브러리가 다운로드 가능한 웹툰/에피소드의 종류 문서](https://github.com/ilotoki0804/WebtoonScraper/blob/master/docs/download_availability.md)를 참고하세요.
## Build from source
우선 git과 python을 설치하고 레포지토리를 클론하세요.
```console
git clone https://github.com/ilotoki0804/WebtoonScraper.git
```
그런 다음 가상 환경을 생성하고 활성화하세요.
```console
echo 윈도우의 경우
py -3.12 -m venv .venv
.venv\Scripts\activate
echo UNIX인 경우
python3.12 -m venv .venv
.venv/Scripts/activate
```
poetry를 설치하고 의존성을 설치하세요.
```console
pip install poetry
poetry install --extras full --no-root
```
`build.py`를 실행하세요.
```console
python build.py
```
이제 `dist`에 빌드된 `whl` 파일과 `tar.gz` 파일이 나타납니다.
## Relese Note
[Relese Note 문서](https://github.com/ilotoki0804/WebtoonScraper/blob/master/docs/releases.md)를 참고하세요.
Raw data
{
"_id": null,
"home_page": null,
"name": "WebtoonScraper",
"maintainer": null,
"docs_url": null,
"requires_python": "<3.13,>=3.10",
"maintainer_email": null,
"keywords": "Webtoon, Webtoon Scraper, Naver Webtoon, Webtoon Downloader, Download Webtoon",
"author": "ilotoki0804",
"author_email": "ilotoki0804@gmail.com",
"download_url": "https://files.pythonhosted.org/packages/c3/70/11aad710e19f31dda663e8f3cd621a0c9b09679dec9f87db2e71247950c4/webtoonscraper-3.3.0.tar.gz",
"platform": null,
"description": "**Check lastest version [here](https://github.com/ilotoki0804/WebtoonScraper).**\n# WebtoonScraper\n\n[](https://github.com/ilotoki0804/WebtoonScraper/releases)\n[](https://pypi.org/project/WebtoonScraper/)\n[](https://github.com/ilotoki0804/WebtoonScraper)\n[](https://toss.me/ilotoki)\n\n**English documentation is available [here](https://github.com/ilotoki0804/WebtoonScraper/blob/master/docs/README_eng.md).**\n\n\ucd5c\ub300 \uaddc\ubaa8 \uc624\ud508 \uc18c\uc2a4 \uc6f9\ud230 \uc2a4\ud06c\ub798\ud37c\uc785\ub2c8\ub2e4.\n\n**\ub124\uc774\ubc84 \uc6f9\ud230(\ubca0\uc2a4\ud2b8 \ub3c4\uc804, \ub3c4\uc804\ub9cc\ud654 \ud3ec\ud568), webtoons.com, \ubc84\ud504\ud230, \ub124\uc774\ubc84 \ud3ec\uc2a4\ud2b8, \ub124\uc774\ubc84 \uac8c\uc784, \ub808\uc9c4 \ucf54\ubbf9\uc2a4, \uce74\uce74\uc624\ud398\uc774\uc9c0, \ub124\uc774\ubc84 \ube14\ub85c\uadf8, \ud2f0\uc2a4\ud1a0\ub9ac, \uce74\uce74\uc624 \uc6f9\ud230**\uc744 \uc9c0\uc6d0\ud558\uace0, \uacc4\uc18d\ud574\uc11c \uc9c0\uc6d0 \ubaa9\ub85d\uc744 \ud655\ub300\ud560 \uacc4\ud68d\uc785\ub2c8\ub2e4.\n\n\uc800\uc791\uad8c\uacfc \ucc45\uc784\uc5d0 \ub300\ud55c \ub0b4\uc6a9\uc744 \ub354\uc6b1 \uc790\uc138\ud788 \uc54c\uace0 \uc2f6\ub2e4\uba74 [\uc774 \ubb38\uc11c](https://github.com/ilotoki0804/WebtoonScraper/blob/master/docs/copyright.md)\ub97c \ucc38\uace0\ud574 \uc8fc\uc138\uc694.\n\n## \uc2e4\ud589 \ud30c\uc77c\ub85c \uc774\uc6a9\ud558\uae30\n\n\uc774 \ud328\ud0a4\uc9c0\ub294 Windows, macOS, Linux\uc5d0\uc11c \uc2e4\ud589 \ud30c\uc77c \ud615\ud0dc\ub85c \uc0ac\uc6a9\ud560 \uc218 \uc788\uc2b5\ub2c8\ub2e4.\n\n1. [\ub9b4\ub9ac\uc988 \ud398\uc774\uc9c0](https://github.com/ilotoki0804/WebtoonScraper/releases)\ub85c \uac00\uc138\uc694.\n1. \ucd5c\uc2e0 \ub9b4\ub9ac\uc988 \uc544\ub798\uc5d0\uc11c \uc790\uc2e0\uc758 \uc6b4\uc601 \uccb4\uc81c\uc640 \uc77c\uce58\ud558\ub294 \uc774\ub984\uc774 \uc801\ud78c zip \ud30c\uc77c\uc744 \ud074\ub9ad\ud574 \ub2e4\uc6b4\ub85c\ub4dc\ud558\uc138\uc694.\n1. zip\ud30c\uc77c\uc744 \ud480\uace0 \uc0ac\uc6a9\ud558\uc138\uc694.\n\n> [!WARNING]\n> \uc708\ub3c4\uc6b0\uc758 \uacbd\uc6b0 \"Windows\uc758 PC \ubcf4\ud638\" \ucc3d\uc774 \ub728\uba74\uc11c \uc2e4\ud589\uc774 \uc548 \ub420 \uc218 \uc788\uc2b5\ub2c8\ub2e4. \uadf8\ub7f0 \uacbd\uc6b0\uc5d0\ub294 `\ucd94\uac00 \uc815\ubcf4`(\uc67c\ucabd \uc911\uac04\uc5d0 \uc788\uc2b5\ub2c8\ub2e4.)\ub97c \ud074\ub9ad\ud558\uace0 `\uc2e4\ud589`\uc744 \ub204\ub974\uc138\uc694.\n\n## Installation\n\n1. \ud30c\uc774\uc36c(3.10 \uc774\uc0c1, \ucd5c\uc2e0 \ubc84\uc804 \uad8c\uc7a5)\uc744 \uc124\uce58\ud569\ub2c8\ub2e4. \uaf2d PATH\uc5d0 \ud30c\uc774\uc36c\uc774 \ud3ec\ud568\ub418\ub3c4\ub85d \uc124\uce58\ud558\uc138\uc694.\n1. \ud130\ubbf8\ub110\uc5d0\uc11c \ub2e4\uc74c\uacfc \uac19\uc740 \uba85\ub839\uc5b4\ub97c \uc2e4\ud589\ud569\ub2c8\ub2e4.\n\n ```console\n pip install -U WebtoonScraper[full]\n ```\n\n\uc798 \uc124\uce58\ub418\uc5c8\ub294\uc9c0\ub97c \ud655\uc778\ud558\ub824\uba74 \ub2e4\uc74c\uc758 \uba85\ub839\uc5b4\ub97c \uc0ac\uc6a9\ud574 \ubcf4\uc138\uc694.\n\n```console\nwebtoon --version\n```\n\n> \ub9cc\uc57d `webtoon` \uba85\ub839\uc5b4\uac00 \uc798 \uc2e4\ud589\ub418\uc9c0 \uc54a\ub294\ub2e4\uba74 \ub2e4\uc74c\uc758 \ucf54\ub4dc\ub97c \uc0ac\uc6a9\ud574 \ubcf4\uc138\uc694.\n>\n> ```console\n> python -m WebtoonScraper --version\n> ```\n>\n> \uc790\uc2e0\uc758 \ud658\uacbd\uc5d0 \ub530\ub77c `python` \ub300\uc2e0 `python3`\ub098 `py -3.12`\uacfc \uac19\uc740 \ucf54\ub4dc\ub97c \uc801\uc808\ud788 \uc0ac\uc6a9\ud574\uc57c \ud560 \uc218 \uc788\uc2b5\ub2c8\ub2e4.\n\n\uc544\ub798\uc640 \uac19\uac70\ub098 \ube44\uc2b7\ud55c \uba54\uc2dc\uc9c0\uac00 \ucd9c\ub825\ub41c\ub2e4\uba74 \uc81c\ub300\ub85c \uc124\uce58\ub41c \uac83\uc785\ub2c8\ub2e4.\n\n```console\nWebtoonScraper 3.2.2 of Python 3.11.4 ... at ...\n\u2705 All extra dependencies are installed!\n```\n\n> \ub2e4\uc74c\uacfc \uac19\uc740 \uacbd\uace0 \uba54\uc2dc\uc9c0\uac00 \ub098\uc62c \uc218 \uc788\uc2b5\ub2c8\ub2e4.\n>\n> ```console\n> WebtoonScraper 3.2.2 of Python 3.11.4 ... at ...\n> \u26a0\ufe0f Extra dependencies 'kakao_webtoon', 'lezhin_comics', 'naver_post' are not installed.\n> You won't be able to download webtoons from following platforms: 'Kakao Webtoon', 'Lezhin Comics (partially)', 'Naver Post'.\n> ```\n>\n> \uc774 \uacbd\uc6b0 \ud45c\uc2dc\ub41c \ud50c\ub7ab\ud3fc\ub4e4(\uc774 \uc624\ub958 \uba54\uc2dc\uc9c0\uc758 \uacbd\uc6b0 \uce74\uce74\uc624 \uc6f9\ud230, \ub808\uc9c4 \ucf54\ubbf9\uc2a4(\ubd80\ubd84\uc801), \ub124\uc774\ubc84 \ud3ec\uc2a4\ud2b8)\uc5d0 \ub300\ud55c \ucd94\uac00\uc801\uc778 \uc758\uc874\uc131\uc774 \uc124\uce58\ub418\uc9c0 \uc54a\ub294 \uac83\uc778\ub370, \ub530\ub77c\uc11c \uc774 \ud50c\ub7ab\ud3fc\ub4e4\uc758 \uc6f9\ud230\uc744 \ub2e4\uc6b4\ub85c\ub4dc\ud560 \uc218 \uc5c6\uac8c \ub429\ub2c8\ub2e4.\n>\n> \ub2e4\uc74c\uacfc \uac19\uc774 \uba85\ub839\uc5b4\ub97c \uc9dc\uba74 \ubaa8\ub4e0 \ud50c\ub7ab\ud3fc\uc5d0\uc11c \uc6f9\ud230\uc744 \ub2e4\uc6b4\ub85c\ub4dc\ud560 \uc218 \uc788\uc2b5\ub2c8\ub2e4.\n>\n> ```console\n> pip install -U WebtoonScraper[full]\n> ```\n\n## How to use\n\n\ub300\ubd80\ubd84\uc758 \uc6f9\ud230\uc740 \ub2e4\uc74c\uacfc \uac19\uc774 \ud130\ubbf8\ub110\uc5d0 `webtoon download`\ub97c \uce58\uace0 \ud070\ub530\uc634\ud45c\ub85c \uac10\uc2fc URL\uc744 \ub4a4\uc5d0 \uc704\uce58\ud558\uba74 \uc791\ub3d9\ud569\ub2c8\ub2e4.\n\n```console\nwebtoon download \"https://comic.naver.com/webtoon/list?titleId=819217\"\n```\n\n\ub9cc\uc57d \ub354 \ub9ce\uc740 WebtoonScraper\uc758 \uae30\ub2a5(\ubc94\uc704 \uc124\uc815 \ub2e4\uc6b4\ub85c\ub4dc, \ubaa8\uc544\uc11c \ubcf4\uae30, \ub2e4\uc6b4\ub85c\ub4dc\ud560 \ub514\ub809\ud1a0\ub9ac \uc124\uc815, \uc5d0\ud53c\uc18c\ub4dc \ub9ac\uc2a4\ud305, \ud30c\uc774\uc36c\uc73c\ub85c \uc0ac\uc6a9 \ub4f1)\uc744 \uc54c\uace0 \uc2f6\uac70\ub098 \uc704\uc5d0\uc11c \uc18c\uac1c\ud55c \ubc29\uc2dd\uc73c\ub85c\ub294 \uc798 \uc791\ub3d9\ud558\uc9c0 \uc54a\ub294 \uacbd\uc6b0(\ud2b9\ud788 \ubc84\ud504\ud230, \ub808\uc9c4\ucf54\ubbf9\uc2a4\uc758 \uacbd\uc6b0 \ucd94\uac00\uc801\uc778 \uc124\uc815\uc774 \ud544\uc218\uc801\uc785\ub2c8\ub2e4.)\uc5d0\ub294 [`\uc0ac\uc6a9 \ubc29\ubc95` \ubb38\uc11c](https://github.com/ilotoki0804/WebtoonScraper/blob/master/docs/how_to_use.md)\ub97c \ucc38\uace0\ud574 \uc8fc\uc138\uc694.\n\n## \uc774 \ub77c\uc774\ube0c\ub7ec\ub9ac\uac00 \ub2e4\uc6b4\ub85c\ub4dc \uac00\ub2a5\ud55c \uc6f9\ud230/\uc5d0\ud53c\uc18c\ub4dc\uc758 \uc885\ub958\n\n[\uc774 \ub77c\uc774\ube0c\ub7ec\ub9ac\uac00 \ub2e4\uc6b4\ub85c\ub4dc \uac00\ub2a5\ud55c \uc6f9\ud230/\uc5d0\ud53c\uc18c\ub4dc\uc758 \uc885\ub958 \ubb38\uc11c](https://github.com/ilotoki0804/WebtoonScraper/blob/master/docs/download_availability.md)\ub97c \ucc38\uace0\ud558\uc138\uc694.\n\n## Build from source\n\n\uc6b0\uc120 git\uacfc python\uc744 \uc124\uce58\ud558\uace0 \ub808\ud3ec\uc9c0\ud1a0\ub9ac\ub97c \ud074\ub860\ud558\uc138\uc694.\n\n```console\ngit clone https://github.com/ilotoki0804/WebtoonScraper.git\n```\n\n\uadf8\ub7f0 \ub2e4\uc74c \uac00\uc0c1 \ud658\uacbd\uc744 \uc0dd\uc131\ud558\uace0 \ud65c\uc131\ud654\ud558\uc138\uc694.\n\n```console\necho \uc708\ub3c4\uc6b0\uc758 \uacbd\uc6b0\npy -3.12 -m venv .venv\n.venv\\Scripts\\activate\n\necho UNIX\uc778 \uacbd\uc6b0\npython3.12 -m venv .venv\n.venv/Scripts/activate\n```\n\npoetry\ub97c \uc124\uce58\ud558\uace0 \uc758\uc874\uc131\uc744 \uc124\uce58\ud558\uc138\uc694.\n\n```console\npip install poetry\npoetry install --extras full --no-root\n```\n\n`build.py`\ub97c \uc2e4\ud589\ud558\uc138\uc694.\n\n```console\npython build.py\n```\n\n\uc774\uc81c `dist`\uc5d0 \ube4c\ub4dc\ub41c `whl` \ud30c\uc77c\uacfc `tar.gz` \ud30c\uc77c\uc774 \ub098\ud0c0\ub0a9\ub2c8\ub2e4.\n\n## Relese Note\n\n[Relese Note \ubb38\uc11c](https://github.com/ilotoki0804/WebtoonScraper/blob/master/docs/releases.md)\ub97c \ucc38\uace0\ud558\uc138\uc694.\n",
"bugtrack_url": null,
"license": "Apache-2.0",
"summary": "Scraping webtoons with ease.",
"version": "3.3.0",
"project_urls": {
"Changelog": "https://github.com/ilotoki0804/WebtoonScraper#relese-note",
"Documentation": "https://github.com/ilotoki0804/WebtoonScraper",
"Homepage": "https://ilotoki0804.gitbook.io/webtoonscraper/",
"Issues": "https://github.com/ilotoki0804/WebtoonScraper/issues",
"Repository": "https://github.com/ilotoki0804/WebtoonScraper"
},
"split_keywords": [
"webtoon",
" webtoon scraper",
" naver webtoon",
" webtoon downloader",
" download webtoon"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "85e684ea54a06662aca6fdc645bc05e7aee3bf771268ba931cb0d0c0cb0e97fe",
"md5": "23bd06d5563af542816cabfdf4f5877c",
"sha256": "7938684b93a1b41c09275033be2d199e6a6b1dba208ae41c8df18f05fa98140b"
},
"downloads": -1,
"filename": "webtoonscraper-3.3.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "23bd06d5563af542816cabfdf4f5877c",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<3.13,>=3.10",
"size": 71043,
"upload_time": "2024-05-01T05:30:25",
"upload_time_iso_8601": "2024-05-01T05:30:25.620531Z",
"url": "https://files.pythonhosted.org/packages/85/e6/84ea54a06662aca6fdc645bc05e7aee3bf771268ba931cb0d0c0cb0e97fe/webtoonscraper-3.3.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "c37011aad710e19f31dda663e8f3cd621a0c9b09679dec9f87db2e71247950c4",
"md5": "ef2ac0ffe0afda2339c74a676a61fadf",
"sha256": "0101139339176f31a9b3cb2dd8db86887ae8b439769a1ab5a2e89fe54ffba1bd"
},
"downloads": -1,
"filename": "webtoonscraper-3.3.0.tar.gz",
"has_sig": false,
"md5_digest": "ef2ac0ffe0afda2339c74a676a61fadf",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<3.13,>=3.10",
"size": 59522,
"upload_time": "2024-05-01T05:31:16",
"upload_time_iso_8601": "2024-05-01T05:31:16.673731Z",
"url": "https://files.pythonhosted.org/packages/c3/70/11aad710e19f31dda663e8f3cd621a0c9b09679dec9f87db2e71247950c4/webtoonscraper-3.3.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-05-01 05:31:16",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "ilotoki0804",
"github_project": "WebtoonScraper#relese-note",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "webtoonscraper"
}
JSON
