头条_MCP_服务器

Name: 头条_MCP_服务器
Author: chemany

作者：chemany24 星标更新：2025-06-06

安装使用来源：spider==github.com

项目介绍

今日头条MCP服务器

一个完整的用于今日头条内容管理的MCP服务器，支持自动登录、内容发布、数据分析等功能。完全兼容小红书自动发布工具的数据格式，支持一键多平台发布。

✨ 主要特性

🔐 用户认证管理 - 自动登录、Cookie持久化、登录状态检查
📝 内容发布功能 - 发布图文文章、发布微头条、上传和压缩图片
📊 数据分析与统计 - 阅读量统计、粉丝增长分析、内容表现评估
🗂️ 内容管理 - 获取文章列表、编辑和删除内容、管理状态
📈 报告生成 - 自动生成每日、每周和每月报告
🌐 多平台兼容性 - 完全兼容小红书自动发布工具，支持一键多平台发布
⚡ 现代架构 - 基于FastMCP框架，支持HTTP流式模式

🔗 多平台兼容性特点

完全兼容小红书自动发布工具

本项目完全兼容您现有的小红书自动发布工具数据格式，并能实现：

相同数据源 - 支持相同的飞书多维表格格式
相同字段名称 - 兼容“小红书标题”、“模仿小红书文案”、“配图”等字段
相同图片处理 - 支持图片URL下载和本地存储
一键多平台发布 - 可同时在小红书和今日头条上发布

支持兼容接口

publish_xiaohongshu_data - 批量发布小红书格式数据至今日头条
publish_single_xiaohongshu_record - 发布单个小红书记录至今日头条
process_feishu_records - 处理飞书多维表格记录（兼容小红书工具格式）
convert_xiaohongshu_format - 预览小红书格式并转换为今日头条格式

📦 安装指南

环境要求

Python 3.8+
Chrome浏览器（用于Selenium自动登录）
Windows/macOS/Linux

安装步骤

克隆项目

git clone <repository-url>
cd toutiao_mcp_server

安装依赖

pip install -r requirements.txt

安装Chrome WebDriver

# WebDriver会通过webdriver-manager自动下载
# 确保系统已安装Chrome浏览器

配置设置（可选）

# 复制配置示例文件
cp config.example.py config_local.py
# 根据需要修改配置

🚀 快速开始

1. 启动服务器

# 使用默认端口8003启动
python start_server.py

# 或指定端口和日志级别
python start_server.py --port  8080 --log-level DEBUG

2. 多平台发布示例

使用集成示例文件（推荐）：

# 运行多平台发布示例
python integration_example.py

此示例文件完全兼容您的现有小红书工具，并支持：

从相同的飞书多维表格中获取数据
同时在小红书和今日头条上发布
支持批量发布和单独发布
提供详细的发布结果统计

或通过MCP工具调用：

import asyncio
import httpx

async def multi_platform_publish():
    # 飞书数据格式（与小红书工具完全一致）
    records = [
        {
            "title": "科技前沿：AI发展趋势",
            "content": "人工智能正在改变我们的生活...",
            "image_url": "https://example.com/image.jpg"
        }
    ]
    
    # 发布到今日头条
    async with httpx.AsyncClient() as client:
        response = await client.post(
            "http://localhost:8003/publish_xiaohongshu_data",
            json={
                "records": records,
                "download_folder": "downloaded_images"
            }
        )
        result = response.json()
        print(f"发布结果: {result}")

# 运行示例
asyncio.run(multi_platform_publish())

3. 基础功能使用

登录今日头条：

# 通过MCP工具调用
result = login_with_credentials("your_username", "your_password")

发布内容：

# 发布图文文章
result = publish_article(
    title="今日头条MCP服务器使用指南",
    content="这是一个功能强大的今日头条内容管理工具...",
    images=["path/to/image1.jpg", "path/to/image2.jpg"],
    tags=["科技", "工具"]
)

# 发布微头条
result = publish_micro_post(
    content="这是一条测试微头条 #科技#",
    images=["path/to/image.jpg"]
)

🛠️ 主要功能模块

1. 认证管理（`auth.py`）

自动登录（支持用户名密码登录）
Cookie持久化存储
登录状态检查和维护
用户信息获取

2. 内容发布（`publisher.py`）

发布图文文章（支持富文本、图片和标签）
微头条发布（支持图片、话题和地点）
自动图片上传和压缩
定时发布功能

3. 数据分析（`analytics.py`）

账户概览数据（粉丝数、文章数、阅读量）
文章详细统计数据（阅读、评论、分享、点赞）
趋势分析（指定时间段内的数据变化）
内容表现排名（按各种指标排序）

4. 多平台兼容性（`multi_platform_publisher.py`）

兼容小红书数据格式
智能格式转换
批量处理和发布
发布结果统计

5. MCP服务器（`server.py`）

基于FastMCP框架
提供HTTP API接口
支持流式模式
完整错误处理

🔧 配置选项

基本配置

# 今日头条相关URL（可自定义）
TOUTIAO_URLS = {
    'login': 'https://sso.toutiao.com/login',
    'publish_article': 'https://mp.toutiao.com/core/article/add/',
    # ... 更多URL配置
}

# Selenium配置
SELENIUM_CONFIG = {
    'implicit_wait': 10,
    'explicit_wait': 30,
    'headless': False,  # 是否无头模式
    'chrome_options': [...]
}

# 内容发布配置
CONTENT_CONFIG = {
    'default_category': '科技',
    'max_images_per_article': 20,
    'auto_compress_images': True,
    # ... 更多配置
}

多平台配置

# 在 integration_example.py 中配置
XIAOHONGSHU_MCP_URL = "http://localhost:8002/xhs-mcp-server"
TOUTIAO_MCP_URL = "http://localhost:8003"

# 飞书多维表格配置（与小红书工具保持一致）
LARK_APP_ID = "your_app_id"
LARK_APP_SECRET = "your_app_secret"
APP_TOKEN = "your_app_token"
TABLE_ID = "your_table_id"

📡 API接口文档

用户认证接口

`login_with_credentials(username, password)`

使用用户名和密码登录

参数

username (str): 用户名（手机号/邮箱）
password (str): 密码

返回值：

{
    "success": true,
    "message": "登录成功",
    "login_status": true
}

`check_login_status()`

检查当前登录状态

返回值：

{
    "success": true,
    "is_logged_in": true,
    "user_info": {
        "user_id": "12345",
        "username": "example_user"
    }
}

内容发布接口

`publish_article(title, content, images, tags, category, ...)`

发布图文文章

参数

title (str): 文章标题
content (str): 文章内容
images (List[str], 可选): 图片路径列表
tags (List[str], 可选): 标签列表
category (str, 可选): 文章分类
cover_image (str, 可选): 封面图片路径
publish_time (str, 可选): 定时发布时间
original (bool): 是否原创

`publish_micro_post(content, images, topic, location, ...)`

发布微头条

参数

content (str): 微头条内容
images (List[str], 可选): 图片路径列表（最多9张）
topic (str, 可选): 话题标签
location (str, 可选): 地点信息
publish_time (str, 可选): 定时发布时间

多平台兼容接口

`publish_xiaohongshu_data(records, download_folder)`

批量发布小红书格式数据至今日头条

参数

records (List[Picture]): 小红书格式数据记录列表
download_folder (str): 图片下载目录

数据格式：

[
    {
        "title": "文章标题",
        "content": "文章内容",
        "image_url": "图片URL"
    }
]

返回值：

{
    "success": true,
    "message": "批量发布完成，成功 8/10 条",
    "summary": {
        "total_records": 10,
        "success_count": 8,
        "failed_count": 2,
        "success_rate": 80.0
    }
}

`publish_single_xiaohongshu_record(title, content, image_url, download_folder)`

发布单个小红书格式数据

`process_feishu_records(feishu_records, download_folder)`

处理飞书多维表格记录（完全兼容小红书工具格式）

支持字段：

小红书标题 → 转换为今日头条标题
仿写小红书文案 → 转换为今日头条内容
配图 → 图片URL，自动下载用于发布

`convert_xiaohongshu_format(xiaohongshu_title, xiaohongshu_content, image_url)`

预览小红书格式转换效果

内容管理接口

`get_article_list(page, page_size, status)`

获取文章列表

`delete_article(article_id)`

删除指定文章

数据分析接口

`get_account_overview()`

获取账户概览数据

`get_article_stats(article_id)`

获取文章统计数据

`generate_report(report_type)`

生成数据报告

🎯 使用场景

1. 单平台使用

纯今日头条内容管理
自动发布和数据分析
内容策略优化

2. 多平台使用（推荐）

同时管理小红书和今日头条
一键发布至两个平台
统一数据管理和分析

3. 企业级应用

团队协作内容管理
批量内容发布
数据驱动的内容优化

🔄 与小红书工具对比

特性	小红书工具	今日头条MCP	多平台整合
数据源	飞书多维表格	✅ 完全兼容	✅ 统一数据源
字段格式	小红书标题/文案/配图	✅ 完全兼容	✅ 无需修改
图片处理	URL下载	✅ 相同逻辑	✅ 共享下载
发布方式	单平台	单平台	✅ 多平台
错误处理	详细日志	✅ 详细日志	✅ 统一处理

🚨 注意事项

登录要求首次使用需手动登录一次，之后登录状态将自动维持
图片格式：支持JPG、PNG、GIF、WebP格式，带有自动压缩优化
Content-Length：
- 微头条：建议控制在2000字符以内
- 图文文章：支持长文本
发布频率建议控制发布频率以避免被平台限制
多平台兼容性确保小红书MCP服务器和今日头条MCP服务器均已启动

🐛 故障排除

常见问题

登录失败
- 检查用户名和密码是否正确
- 确认已安装Chrome浏览器
- 检查网络连接
图片上传失败
- 检查图片文件是否存在
- 确认支持的图片格式
- 检查网络连接
发布失败
- 确认已登录
- 检查内容是否符合平台标准
- 查看详细错误日志
多平台发布问题
- 确认两个MCP服务器均已启动
- 检查端口配置是否正确
- 验证数据格式是否正确

日志查看

# 查看运行日志
tail -f toutiao_mcp.log

# 调试模式启动
python start_server.py --log-level DEBUG

🤝 贡献指南

欢迎提交Issue和Pull Requests来改进项目！

开发环境设置

分叉项目
创建功能分支
安装和开发依赖：pip install -r requirements.txt
运行测试：python -m pytest tests/
提交更改并创建Pull Request

📄 许可证

本项目采用MIT许可证。请参阅更多详情 LICENSE 文件。

🔗 相关链接

📞 支持与反馈

如有任何问题或建议，请通过以下方式联系我们：

提交GitHub Issue
发送邮件给项目维护者
查看项目Wiki以获得更多帮助

现在开始您的多平台内容发布之旅吧！ 🚀

头条_MCP_服务器

项目介绍

今日头条MCP服务器

✨ 主要特性

🔗 多平台兼容性特点

完全兼容小红书自动发布工具

支持兼容接口

📦 安装指南

环境要求

安装步骤

🚀 快速开始

1. 启动服务器

2. 多平台发布示例

3. 基础功能使用

🛠️ 主要功能模块

1. 认证管理（auth.py）

2. 内容发布（publisher.py）

3. 数据分析（analytics.py）

4. 多平台兼容性（multi_platform_publisher.py）

5. MCP服务器（server.py）

🔧 配置选项

基本配置

多平台配置

📡 API接口文档

用户认证接口

login_with_credentials(username, password)

check_login_status()

内容发布接口

publish_article(title, content, images, tags, category, ...)

publish_micro_post(content, images, topic, location, ...)

多平台兼容接口

publish_xiaohongshu_data(records, download_folder)

publish_single_xiaohongshu_record(title, content, image_url, download_folder)

process_feishu_records(feishu_records, download_folder)

convert_xiaohongshu_format(xiaohongshu_title, xiaohongshu_content, image_url)

内容管理接口

get_article_list(page, page_size, status)

delete_article(article_id)

数据分析接口

get_account_overview()

get_article_stats(article_id)

generate_report(report_type)

🎯 使用场景

1. 单平台使用

2. 多平台使用（推荐）

3. 企业级应用

🔄 与小红书工具对比

🚨 注意事项

🐛 故障排除

常见问题

日志查看

🤝 贡献指南

开发环境设置

📄 许可证

🔗 相关链接

📞 支持与反馈

1. 认证管理（`auth.py`）

2. 内容发布（`publisher.py`）

3. 数据分析（`analytics.py`）

4. 多平台兼容性（`multi_platform_publisher.py`）

5. MCP服务器（`server.py`）

`login_with_credentials(username, password)`

`check_login_status()`

`publish_article(title, content, images, tags, category, ...)`

`publish_micro_post(content, images, topic, location, ...)`

`publish_xiaohongshu_data(records, download_folder)`

`publish_single_xiaohongshu_record(title, content, image_url, download_folder)`

`process_feishu_records(feishu_records, download_folder)`

`convert_xiaohongshu_format(xiaohongshu_title, xiaohongshu_content, image_url)`

`get_article_list(page, page_size, status)`

`delete_article(article_id)`

`get_account_overview()`

`get_article_stats(article_id)`

`generate_report(report_type)`