fanqie-author

Automates novel publishing on Fanqie via Chrome DevTools Protocol API calls.

1|Updated Oct 11, 2025
One-click install
npx skills add https://github.com/ibytechaos/claude --skill fanqie-author-ibytechaos
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: fanqie-author
Source: https://github.com/ibytechaos/claude/tree/main/skills/fanqie-author
Command: npx skills add https://github.com/ibytechaos/claude --skill fanqie-author-ibytechaos

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? Managing novels on the Fanqie (番茄小说) author platform manually is repetitive and slow, especially when publishing dozens of chapters. This Skill automates book creation, chapter publishing, batch publishing, and stats queries by calling Fanqie's internal APIs directly through a logged-in Chrome browser session. ## Core Features & Use Cases - Book & Chapter Management: Create new books, list books/chapters/volumes/drafts, update or delete chapters via the author API. - Single & Batch Publishing: Publish one chapter from a text file or batch-publish an entire directory of chapters with validation (title ≥ 5 chars, body ≥ 1000 chars, Arabic chapter numbering) and configurable delays. - Zero-Dependency CLI: A single Node.js script connects to Chrome over CDP and executes fetch() calls in the browser context, so cookies and msToken authentication are handled automatically. - Use Case: You have 20 finished chapters in a local folder. Run the batch-publish command and all chapters are validated, converted to HTML paragraphs, and published at 3-second intervals with per-chapter success/failure reporting. ## Quick Start Start Chrome with remote debugging on port 9222, log in to fanqienovel.com, then ask the assistant to batch publish the chapters in your local folder to your Fanqie book.

Frequently Asked Questions about fanqie-author

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I batch publish chapters to Fanqie novel platform?

Place your chapters as .txt or .md files in a directory named with the pattern 'number-title.txt', then run the batch-publish command with the book ID and directory path. Each chapter is validated for minimum 1000 characters and 5-character titles before publishing at a configurable interval, defaulting to 3 seconds.

How to publish a single chapter to fanqienovel.com from the command line?

Run the publish command with the book ID, a title of at least 5 characters using Arabic chapter numbering, and a text file containing at least 1000 characters. The script creates a draft, saves the content as HTML paragraphs, then calls the publish_article API with the full volume parameters.

Does this Fanqie publishing tool require npm dependencies?

No external npm packages are required on Node.js 22 or later, which includes a built-in WebSocket client. On older Node versions the script falls back to importing the 'ws' package. The only real prerequisite is Chrome running with --remote-debugging-port=9222 and a logged-in fanqienovel.com session.

Why does Fanqie chapter publishing fail with missing volume parameter errors?

The publish_article API requires the complete parameter set including volume_id, volume_name, publish_status, use_ai, and device_platform. Omitting any field triggers the 'missing book volume parameters' error, so the script always fetches the volume list first and sends all required fields.

What are the content requirements for Fanqie novel chapters?

Chapter titles must be at least 5 characters and use Arabic numerals for chapter numbers (第1章, not 第一章). Body text must be at least 1000 characters and is converted to HTML with paragraphs wrapped in <p> tags. Book names are limited to 15 characters and abstracts must be 50-500 characters.