Toutiao Publisher Skill
Manage Toutiao (Today's Headlines) account, maintain persistent login session, and publish articles.
When to Use This Skill
Trigger when user:
- Asks to publish to Toutiao/Today's Headlines
- Wants to manage Toutiao login
- Mentions "toutiao" or "头条号"
Core Workflow
Step 1: Authentication (One-Time Setup)
The skill requires a one-time login. The session is persisted for subsequent uses.
# Browser will open for manual login (scan QR code)
python scripts/run.py auth_manager.py setupInstructions:
- Run the setup command.
- A browser window will open loading the Toutiao login page.
- Log in manually (e.g., scan QR code).
- Once logged in (redirected to dashboard), the script will save the session and close.
Step 2: Publish Article
# Opens browser with authenticated session at publish page
python scripts/run.py publisher.pyInstructions:
- Run the publisher command.
- Browser opens directly to the "Publish Article" page.
- Write and publish the article manually.
- Press
Ctrl+Cin the terminal when done.
Note: Toutiao requires titles to be 2-30 characters. This tool automatically optimizes titles to fit this constraint (truncating if >30, padding if <2).
Advanced Usage (Automated)
You can fully automate the publishing process by providing arguments:
# Publish with title, content file, and cover image
python scripts/run.py publisher.py --title "AI Trends 2025" --content "article.md" --cover "assets/cover.jpg" --headlessManagement
# Check authentication status
python scripts/run.py auth_manager.py status
# Clear authentication data (logout)
python scripts/run.py auth_manager.py clearTechnical Details
- Persistent Auth: Uses
patchrightto launch a persistent browser context. Cookies and storage state are saved todata/browser_state/state.json. - Anti-Detection: Uses
patchright's stealth features to avoid bot detection. - Environment: Automatically manages a virtual environment (
.venv) with required dependencies.
Script Reference
scripts/auth_manager.py: Handles login, session validation, and state persistence.scripts/publisher.py: Launches authenticated browser for publishing.scripts/run.py: Wrapper ensuring execution in the correct virtual environment.