Skill

toutiao-publisher

Publishes articles to Toutiao (Today's Headlines) via Python CLI. Handles one-time login with persistent session, opens browser for interactive publishing, supports automated mode with title/content/cover args.

Python

Bash

automation

cli-tools

Install

npx claudepluginhub guanyang/super-publisher --plugin super-publisher

Tool Access

This skill uses the workspace's default tool permissions.

Preview

Manage Toutiao (Today's Headlines) account, maintain persistent login session, and publish articles.

Supporting Assets

README.mdrequirements.txtscripts/auth_manager.pyscripts/browser_utils.pyscripts/config.pyscripts/md2html.pyscripts/publisher.pyscripts/run.pyscripts/setup_environment.py

SKILL.md

Similar Skills

using-git-worktrees

Creates isolated Git worktrees for feature branches with prioritized directory selection, gitignore safety checks, auto project setup for Node/Python/Rust/Go, and baseline verification.

superpowers

168.3k

subagent-driven-development

3 files

Executes implementation plans in current session by dispatching fresh subagents per independent task, with two-stage reviews: spec compliance then code quality.

superpowers

168.3k

dispatching-parallel-agents

Dispatches parallel agents to independently tackle 2+ tasks like separate test failures or subsystems without shared state or dependencies.

superpowers

168.3k

Stats

Stars17

Forks5

Last CommitJan 16, 2026

Actions

View Source View Plugin View on GitHub View README

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 setup

Instructions:

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.py

Instructions:

Run the publisher command.
Browser opens directly to the "Publish Article" page.
Write and publish the article manually.
Press Ctrl+C in 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" --headless

Management

# Check authentication status
python scripts/run.py auth_manager.py status

# Clear authentication data (logout)
python scripts/run.py auth_manager.py clear

Technical Details

Persistent Auth: Uses patchright to launch a persistent browser context. Cookies and storage state are saved to data/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.