Files must live in <SOURCE_DIR>/<书名>/ and be named with leading numeric prefix for sorting:

01-第1章-章节标题.md
02-第2章-章节标题.md

Or standard format:

001 第1章 章节标题.md
002 第2章 章节标题.md

Supports .md and .txt. .md files are auto-converted to plain text on publish.

The script extracts chapter number from leading digits in the filename, and chapter title from the # 第N章标题 heading inside the file.

⚠️ CRITICAL: Strict Chapter Ordering

番茄小说 has a bug: once a chapter number is assigned, it CANNOT be changed or reordered. If you accidentally publish Chapter 2 before Chapter 1, Chapter 1 will forever appear AFTER Chapter 2 in the book's table of contents. There is no way to fix this in the web UI.

Rules:

ALWAYS publish chapters in strict numeric order: 第1章 → 第2章 → 第3章 → ...
NEVER skip a chapter number
If a chapter fails to publish, FIX the issue and retry that chapter BEFORE moving to the next one
Before starting a batch publish, verify the first chapter is truly Chapter 1
If a published chapter needs to be deleted from the website, also clean the archive directory and re-publish from Chapter 1 onward

When retrying after a partial failure:

Delete any incorrectly published chapters from the 番茄小说 website
Move archived files back from ARCHIVE_DIR to CHAPTER_DIR
Clear the ARCHIVE_DIR directory
Re-run batch_publish.py starting fresh from Chapter 1

Batch Publish (primary method)

Edit the three constants at the top of batch_publish.py:

CHAPTER_DIR = "/path/to/chapters/书名"
ARCHIVE_DIR = "/path/to/chapters/uploaded/书名"
BOOK_ID     = "7640498714590579774"   # from fanqienovel.com writer URL

Run:

DISPLAY=:0 uv run python batch_publish.py              # all chapters
DISPLAY=:0 uv run python batch_publish.py --count 5    # first 5 only
DISPLAY=:0 uv run python batch_publish.py --headless   # headless (less reliable)

Published files are moved to ARCHIVE_DIR automatically. Failed chapters stay in CHAPTER_DIR.

Retrying Failed Chapters

Move files back from archive to source, then re-run:

mv /path/to/uploaded/书名/NNN*.md /path/to/chapters/书名/
DISPLAY=:0 uv run python batch_publish.py

Getting BOOK_ID

Open the book in the writer backend. Extract the numeric ID from the URL:

https://fanqienovel.com/main/writer/7640498714590579774/manage/

Known Failure Modes & Fixes

See references/publish-flow.md for the full browser automation flow, popup sequence, and known failure patterns.

MCP Server (alternative)

mcp_server.py exposes publish_chapters, list_books, preview_chapters, read_chapter_content, and check_login_status as MCP tools. See references/mcp-usage.md.

fanqie-publish

fanqie-publish

Prerequisites

Chapter File Naming