qidian-mcp-server

# Qidian MCP Server Qidian Chinese Web data collection MCP Server, helping online novel authors conduct market research and creation reference. ## Features | Tool | Description | |------|-------------| | `qidian_scan_ranking` | Scan rankings (14 lists x 15 categories) | | `qidian_book_detail` | Get book details (title, author, introduction, word count, recommended data) | | `qidian_chapter_structure` | Chapter structure + free chapter content | | `qidian_reviews` | Collect reader reviews | | `qidian_genre_trend` | Multi-list category trend analysis | | `qidian_deconstruct` | AI-assisted book deconstruction (requires ANTHROPIC_API_KEY) | ## Installation ### Method 1: One-click Installation ```bash git clone <repo-url> cd qidian-mcp-server ./setup.sh ``` ### Method 2: Manual Installation ```bash cd qidian-mcp-server python3 -m venv .venv source .venv/bin/activate pip install "mcp[cli]" playwright anthropic playwright install chromium ``` ## Configure Claude Code ```bash claude mcp add qidian -- /path/to/qidian-mcp-server/.venv/bin/python /path/to/qidian-mcp-server/server.py ``` For AI book deconstruction functionality, set environment variables: ```bash export ANTHROPIC_API_KEY="your-key" ``` ## Supported Rankings **Popular Works:** Monthly vote list, bestseller list, reading index list, book friend list, recommendation list, collection list, update list, VIP collection list **New Book Rankings:** Signed author new book list, public author new book list, new signed author new book list, new author new book list **Others:** Female selection list, female monthly vote list ## Supported Categories Fantasy, Science Fiction, Martial Arts, Xianxia, Urban, Realistic, Military, Historical, Game, Sports, Science Fiction, Infinite Multiverse, Mystery, Light Novel ## Usage Examples In Claude Code: ``` > Help me scan the Qidian new signed author new book list and check the Xianxia category situation > Deconstruct the top-ranked book's first 5 chapters > Analyze recent category trends ``` ## Known Limitations - Monthly votes/recommended votes and other values are encrypted by Qidian's anti-crawling font, making it impossible to read specific numbers - Paid chapter content cannot be obtained - Please control the collection frequency; the tool has a built-in 2.5-4.5-second random delay ## Dependencies - Python >= 3.11 - Playwright (Chromium) - MCP Python SDK - Anthropic Python SDK (optional, for AI book deconstruction)