toutiao-publish

What This Skill Does

The toutiao-publish skill is an automated agent designed to handle content distribution on the Toutiao (mp.toutiao.com) platform. It provides a robust interface for posting articles by either providing raw text and image inputs or by automatically ingesting documents from designated server directories. The tool supports session persistence using saved local sessions or transient cookie headers, ensuring high success rates for automated publishing tasks. By automating the browser-driven interaction with the Toutiao backend, this skill streamlines the process of uploading titles, content, and media, as well as handling complex document imports via the platform's native .docx processor.

Installation

To integrate this skill into your OpenClaw environment, execute the following command in your terminal: clawhub install openclaw/skills/skills/charlesliu-sap/toutiao-publish-docx-v1 Ensure your execution environment is located on a Linux-based host (specifically Ubuntu) as the script relies on specific paths like /home/ubuntu/projects/toutiao_poster to function correctly. Dependencies managed within the local virtual environment (.venv) are pre-configured by the installer.

Use Cases

• Automated Content Marketing: Automatically push daily articles from a content generation pipeline to Toutiao.
• Batch Document Importing: Move pre-formatted .docx files from a local directory directly to the Toutiao editor for consistent formatting.
• Session-Based Publishing: Securely use session cookies to bypass interactive login steps for high-frequency publishing workflows.
• Unattended Posting: Schedule posts via an agent without manual intervention using the --publish flag and optimized waiting intervals for document parsing.

Example Prompts

1. "Publish the latest article in the artifacts folder to my Toutiao account using my stored session."
2. "Draft a new Toutiao post titled 'AI Trends 2024' with the text from my recent analysis, include the images in /tmp/assets, but don't publish it yet."
3. "Use the cookie_header 'sso_uid=...; session_id=...' to upload the first docx file found in the input directory and confirm the post once ready."

Tips & Limitations

• Headless Mode: This skill runs in headless mode by default. Ensure your environment has a compatible Chromium-based browser driver installed.
• Cookie Management: Always keep your cookie_header secure. Using an expired cookie may cause the script to fail at the authentication stage.
• Directory Awareness: The tool relies on fixed directories. Ensure your file system permissions allow the agent to read from artifacts/toutiaodoc and move files to the done/ subfolder post-publication.
• Wait Times: When using the docx flow, network latency can impact document parsing. If you experience upload failures, increase the docx_wait_seconds parameter to 120 or higher to allow the backend processor more time to render the content.