Simple shunga clients
2025-01-27 04:12:46 +09:00
.vscode feat: add scraper script 2025-01-19 21:54:40 +09:00
01-research feat(research): add research scripts 2025-01-19 20:26:52 +09:00
02-dirty feat(dirty): add dirty scripts 2025-01-19 20:27:07 +09:00
03-clean feat(dump_ids): add txt file support 2025-01-27 04:12:46 +09:00
.gitignore feat: add scraper script 2025-01-19 21:54:40 +09:00
LICENSE docs: add LICENSE 2025-01-19 20:28:13 +09:00
README.md docs(README): update installation 2025-01-21 22:58:10 +09:00

Shunga Lib

Python scraping library for NicoShunga.

Warning

  • This library requires a valid user session cookie at NicoShunga.
  • YOU MUST NOT use this library to scrape NicoShunga excessively.
  • USE AT YOUR OWN RISK.

Requirements

  • Python 3.10 or later
  • httpx
  • lxml

Installation

  • pip install httpx lxml
  • cd 03-clean
  • (modify scraper.py)
  • python scraper.py

Usage

from nicoseiga import NicoSeigaClient

# Input cookies grabbed from Chrome browser DevTools
cookies = "user_session=xxx; user=xxx"
client = NicoSeigaClient(cookies=cookies)

results = client.search_by_tag("香風智乃", target="shunga")
for item in results.items:
    print(f"Title: {item.title}")
    print(f"Author: {item.author}")
    print(f"URL: {item.url}")

detail = client.get_image_detail("im4866036")
print(f"Title: {detail.title}")
print(f"Description: {detail.description}")
print(f"Author: {detail.author_name}")
print(f"View Count: {detail.view_count}")

comments = client.get_comments("im4866036")
for comment in comments:
    print(f"User: {comment.user}")
    print(f"Text: {comment.text}")
    print(f"Date: {comment.date}")

tags = client.get_tags("im4866036")
for tag in tags:
    print(f"Name: {tag.name}")
    print(f"Locked: {tag.is_locked}")

url = client.get_full_size_image_url("im4866036")
print(f"Full size image URL: {url}")

License

MIT License