- Home
- MCP servers
- Toutiao
Toutiao
- python
44
GitHub Stars
python
Language
6 months ago
First Indexed
2 months ago
Catalog Refreshed
Documentation & install
Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.
You have an MCP server that automates login, content publishing, analytics, and cross‑platform posting for Toutiao while maintaining compatibility with Xiaohongshu data formats. It lets you publish to multiple platforms from a single data source and provides built‑in reporting and analytics features.
How to use
Start by deploying the MCP server endpoints for Toutiao and Xiaohongshu and then use an MCP client to interact with them. You can publish articles or micro posts, retrieve analytics, and manage content from a single control plane. Use the provided HTTP APIs to publish data in Xiaohongshu formats, or publish directly to Toutiao.
Key usage patterns you will implement:
- Authenticate once and reuse the session to publish content and pull analytics.
- Prepare Xiaohongshu‑formatted data and publish in batch or individually to Toutiao.
- Manage articles: list, edit, delete, and monitor publication status.
- Generate daily, weekly, and monthly reports to track performance.
How to install
Prerequisites you need to have before installation.
# Prerequisites
Python 3.8+
Chrome browser for automated login
Windows/macOS/Linux
Install the MCP server dependencies and prepare the environment.
pip install -r requirements.txt
Configure settings if you want to customize endpoints or behavior.
# Copy and modify the local config as needed
cp config.example.py config_local.py
Start the server on the default port or specify your own port and log level.
# Default port 8003
python start_server.py
# Or specify port and log level
python start_server.py --port 8080 --log-level DEBUG
Additional content and configuration
The server supports multi‑platform publishing and Xiaohongshu compatibility. Use the provided configuration blocks to set up the endpoints and data formats.
Troubleshooting
If you encounter login or publish issues, verify that you started the correct MCP services and that you are posting to the right endpoints.
Common checks:
- Ensure the Toutiao MCP endpoint is reachable and running on the configured port.
- Confirm that Xiaohongshu data is formatted according to the supported structure.
- Review the logs for authentication or API errors.
Notes and best practices
- Maintain a stable publish rate to avoid platform rate limits.
- Enable session persistence so you don’t have to reauthenticate on every request.
- Use batch publishing when possible to improve throughput and provide consolidated publish results.
Available tools
login_with_credentials
Log in to the Toutiao MCP server using a username and password to establish a session.
check_login_status
Check whether the current session is authenticated and retrieve user information.
publish_article
Publish a rich article with title, content, images, and tags to Toutiao.
publish_micro_post
Publish a micro post with content, images, and optional location or topic.
publish_xiaohongshu_data
Batch publish Xiaohongshu formatted records to Toutiao from a shared data source.
publish_single_xiaohongshu_record
Publish a single Xiaohongshu formatted record to Toutiao.
process_feishu_records
Process Feishu multidimensional table records, compatible with Xiaohongshu tooling formats.
convert_xiaohongshu_format
Preview the conversion from Xiaohongshu format to Toutiao format.
get_article_list
Retrieve a list of published articles with pagination and status filtering.
delete_article
Delete a specified article by its ID.
get_account_overview
Fetch account overview data such as followers, articles, and reads.
get_article_stats
Get detailed statistics for a specific article.
generate_report
Generate daily, weekly, or monthly performance reports.