Now liveThe Skillselion MCP - thousands of ranked skills, loaded into your agent mid-task. No install.Get it →
guanyang avatar

Toutiao Publisher

  • 1k installs
  • 28 repo stars
  • Updated July 16, 2026
  • guanyang/super-publisher

toutiao-publisher is an agent skill that publishes articles to Toutiao (Today's Headlines) with one-time browser QR login and persistent session management for developers distributing Chinese-language content.

About

toutiao-publisher is an agent skill in the guanyang/super-publisher repository that posts articles to Toutiao (Today's Headlines, 头条号) for developers automating Chinese-language content distribution. The skill opens a browser for a one-time QR-code login, then persists the session so later publishing runs skip re-authentication. When triggered by mentions of toutiao, 头条号, or Today's Headlines, the agent manages account login state and pushes article drafts through Toutiao's interactive publishing flow. Developers reach for toutiao-publisher when they need repeatable, agent-driven posting to ByteDance's Toutiao platform without rebuilding browser automation or session storage themselves. The workflow covers authentication setup, session maintenance, and article submission in a single skill rather than a separate CMS integration.

  • One-time browser-based login with persistent session management
  • Automatically opens authenticated browser session at the publish page
  • Title optimization to fit Toutiao's 2-30 character requirement
  • Handles manual publishing workflow while maintaining login state
  • Trigger-based activation on mentions of toutiao or 头条号

Toutiao Publisher by the numbers

  • 1,021 all-time installs (skills.sh)
  • +9 installs in the week ending Aug 5, 2026 (Skillselion tracking)
  • Ranked #447 of 1,879 Marketing & SEO skills by installs in the Skillselion catalog
  • Security screen: HIGH risk (skills.sh audit)
  • Data as of Aug 5, 2026 (Skillselion catalog sync)
npx skills add https://github.com/guanyang/super-publisher --skill toutiao-publisher

Add your badge

Show developers this skill is listed on Skillselion. Paste this into your README.

Listed on Skillselion
Installs1k
repo stars28
Security audit1 / 3 scanners passed
Last updatedJuly 16, 2026
Repositoryguanyang/super-publisher

How do you publish articles to Toutiao programmatically?

Publish articles directly to Toutiao (Today's Headlines) with persistent authentication.

Who is it for?

Developers automating Chinese article distribution to Toutiao who want persistent browser sessions without writing custom scrapers.

Skip if: Teams publishing only to Western platforms or requiring fully headless CI publishing with no interactive browser login.

When should I use this skill?

User asks to publish to Toutiao, manage 头条号 login, or mentions toutiao or Today's Headlines.

What you get

Live Toutiao articles plus a persisted browser login session for repeat publishing.

  • published Toutiao articles
  • persisted login session

Files

SKILL.mdMarkdownGitHub ↗

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: 1. Run the setup command. 2. A browser window will open loading the Toutiao login page. 3. Log in manually (e.g., scan QR code). 4. 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: 1. Run the publisher command. 2. Browser opens directly to the "Publish Article" page. 3. Write and publish the article manually. 4. 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 (Draft Automation)

You can fill a draft automatically by providing arguments. By default, the tool stops before final publishing so the user can inspect the article and click Publish manually.

# Fill title, Markdown content, inline images, and cover image
python scripts/run.py publisher.py --title "AI Trends 2025" --content "article.md" --cover "assets/cover.jpg"

Markdown images such as ![caption](assets/chart.png) are inserted into the article body at their original positions. Local relative image paths are resolved from the Markdown file directory.

If the article body contains images, the tool skips explicit cover handling and does not open Toutiao's cover picker. --cover is only uploaded when the Markdown body has no inline images.

Debug screenshots are disabled by default. If troubleshooting is needed, add --debug-screenshots; screenshots will be saved under output/toutiao-publisher-debug/ instead of the working directory.

Automated Final Publish

Only use this when the user explicitly asks to publish without manual review:

python scripts/run.py publisher.py --title "AI Trends 2025" --content "article.md" --cover "assets/cover.jpg" --auto-publish

Without --auto-publish, never click Toutiao's final publish buttons automatically.

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.

Related skills

How it compares

Choose toutiao-publisher over generic browser-automation skills when the goal is Toutiao-specific publishing with built-in session persistence rather than one-off page scraping.

FAQ

How does toutiao-publisher handle Toutiao login?

toutiao-publisher opens a browser for a one-time manual login, typically via QR code scan. The skill persists the session so later publishing runs reuse stored credentials without repeating authentication.

When should an agent invoke toutiao-publisher?

toutiao-publisher should run when a developer asks to publish to Toutiao or 头条号, manage Toutiao login, or mentions Today's Headlines. The skill handles session setup and article submission to that platform.

Does toutiao-publisher require login every publish?

No. toutiao-publisher requires interactive browser login only once during initial setup. Subsequent article publishes reuse the persisted session managed by the skill across agent runs.

Is Toutiao Publisher safe to install?

skills.sh reports 1 of 3 security scanners passed. Review the Security Audits panel on this page before installing in production.

Marketing & SEOdistributioncontent

This week in AI coding

Five minutes, every Monday - the tools, releases and tactics for developers.

unsubscribe anytime.