4chan-reader
// Browse 4chan boards and extract thread discussions into structured text files. Use when you need to fetch catalog information or specific thread content (including post text and file metadata) from 4chan boards like /a/, /vg/, /v/, etc.
$ git log --oneline --stat
stars:1,933
forks:367
updated:March 4, 2026
SKILL.mdreadonly
SKILL.md Frontmatter
name4chan-reader
descriptionBrowse 4chan boards and extract thread discussions into structured text files. Use when you need to fetch catalog information or specific thread content (including post text and file metadata) from 4chan boards like /a/, /vg/, /v/, etc.
4chan Reader
This skill allows you to catalog and extract threads from 4chan boards into structured text.
Workflows
1. View Board Catalog
To see active threads and their reply counts on a board:
python3 scripts/chan_extractor.py catalog <board>
Output format: ThreadID|PostCount|TeaserText
2. Extract Thread Content
To read a specific thread and optionally save it:
python3 scripts/chan_extractor.py thread <board> <thread_id> [output_root_dir] [word_limit]
output_root_dir(optional): If provided, saves content to<output_root_dir>/<board>_<timestamp>/<thread_id>.txt.word_limit(optional): Limits each line of post text to the specified number of words.
Details
- Scripts: Uses chan_extractor.py for all operations.