How do I install the Fanqie Publish skill?

Run npx skillmds@latest add aresbit/fanqie-publish in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Fanqie Publish safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Fanqie Publish?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Fanqie Publish free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Fanqie Publish?

aresbit (@aresbit) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Fanqie Publish by aresbit — Agent Skill

Name: Fanqie Publish
Author: aresbit

Fanqie Publish

Automates publishing novel chapters to 番茄小说 (fanqienovel.com) via Playwright browser automation. Use when the user wants to publish, batch-upload, or retry uploading novel chapters from a local directory to 番茄小说. Handles login state, ProseMirror editor injection, popup dismissal (错别字检测/仅基础检测/AI声明/确认发布), and auto-archives successfully published files. Triggers on requests like "发布章节到番茄", "上传小说", "batch publish chapters", or retrying failed chapters.

aresbit Updated Sep 17, 2026

File contents

fanqie-publish

Prerequisites

cd /home/ares/ares/llm/fanqie_auto_publish
uv sync                          # install deps
playwright install chromium      # first time only

DISPLAY=:0 uv run python login.py
# Follow on-screen prompt: log in, then press Enter

Chapter File Naming

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.

---name: fanqie-publishdescription: Automates publishing novel chapters to 番茄小说 (fanqienovel.com) via Playwright browser automation. Use when the user wants to publish, batch-upload, or retry uploading novel chapters from a local directory to 番茄小说. Handles login state, ProseMirror editor injection, popup dismissal (错别字检测/仅基础检测/AI声明/确认发布), and auto-archives successfully published files. Triggers on requests like "发布章节到番茄", "上传小说", "batch publish chapters", or retrying failed chapters.---# fanqie-publish## Prerequisites```bashcd /home/ares/ares/llm/fanqie_auto_publishuv sync # install depsplaywright install chromium # first time only```Login (one-time, saves cookies to `state.json`):```bashDISPLAY=:0 uv run python login.py# Follow on-screen prompt: log in, then press Enter```## Chapter File NamingFiles must live in `<SOURCE_DIR>/<书名>/` and be named with leading numeric prefix for sorting:```01-第1章-章节标题.md02-第2章-章节标题.md```Or standard format:```001 第1章章节标题.md002 第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:**1. ALWAYS publish chapters in strict numeric order: 第1章 → 第2章 → 第3章 → ...2. NEVER skip a chapter number3. If a chapter fails to publish, FIX the issue and retry that chapter BEFORE moving to the next one4. Before starting a batch publish, verify the first chapter is truly Chapter 15. 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`:```pythonCHAPTER_DIR = "/path/to/chapters/书名"ARCHIVE_DIR = "/path/to/chapters/uploaded/书名"BOOK_ID = "7640498714590579774" # from fanqienovel.com writer URL```Run:```bashDISPLAY=:0 uv run python batch_publish.py # all chaptersDISPLAY=:0 uv run python batch_publish.py --count 5 # first 5 onlyDISPLAY=: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 ChaptersMove files back from archive to source, then re-run:```bashmv /path/to/uploaded/书名/NNN*.md /path/to/chapters/书名/DISPLAY=:0 uv run python batch_publish.py```## Getting BOOK_IDOpen the book in the writer backend. Extract the numeric ID from the URL:```https://fanqienovel.com/main/writer/7640498714590579774/manage/```## Known Failure Modes & FixesSee `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`.

Frequently asked questions