toutiao_mcp_server

This MCP server implements a complete 今日头条 content management platform built on the FastMCP framework. It provides user authentication management, content publishing for articles and micro-posts, data analytics, and multi-platform publishing compatibility with Xiaohongshu data formats. The server exposes HTTP APIs for logging in, checking login status, publishing content (articles and micro posts), and a set of multi-platform publishing helpers that can convert and publish Xiaohongshu-formatted data to 今日头条. Use the included multi-platform publisher to push content to both Xiaohongshu and 今日头条 from a unified data source, benefiting from image handling, URL downloading, and batch operations. The server also supports generating reports and analytics to monitor performance and engagement metrics over time.

Prerequisites:

• Python 3.8 or newer
• Chrome browser (for Selenium-based automated login)
• Supported OS: Windows/macOS/Linux

Installation steps:

1. Clone the repository and navigate to the project folder

git clone <repository-url>
cd toutiao_mcp_server

2. Create or install Python dependencies

python -m pip install --upgrade pip
pip install -r requirements.txt

3. Ensure Chrome WebDriver dependencies are available (webdriver-manager will handle downloads during runtime)
4. Optional: copy and customize configuration

cp config.example.py config_local.py

5. Start the MCP server

python start_server.py

You can customize the port and log level when starting the server:

python start_server.py --port 8080 --log-level DEBUG

Tips and common considerations:

• First run may require manual login to initialize cookies; subsequent starts will attempt to reuse saved cookies.
• The system supports image formats JPG, PNG, GIF, and WebP, with automatic compression enabled by default.
• For multi-platform publishing, ensure both Xiaohongshu MCP server and 今日头条 MCP server are up and reachable; the integration_example.py demonstrates batch publishing across platforms.
• If you enable Selenium headless mode, ensure the environment has all necessary dependencies for headless Chrome.
• API endpoints support batch operations and return structured results including success/failure details and tallied statistics.
• Review and adjust SELENIUM_CONFIG and CONTENT_CONFIG in your local config to fit your environment and publishing policies.