superwangyuan/toutiaohao-mcp-server

This page was translated automatically. Technical details may differ from the original. View the original

5 stars 4 forks Quality 58 Trend 17

EN: An MCP server and HTTP API powered by Go and go-rod for automated Toutiao (ByteDance) content publishing, analytics, and creator dashboard automation.

Overview

基于 Model Context Protocol (MCP) 与 Go 语言实现的头条号创作者后台自动化运营工具包。支持作为标准 MCP 服务端直接接入 AI 客户端（如 Cursor、DeepSeek、Claude Desktop、Claude Code），同时也暴露了标准的 RESTful HTTP 接口，实现自媒体发文、数据分析与内容管理的自动化。 - ：同一端口（默认 8080）下，同时提供符合标准 MCP 协议的 JSON-RPC 路由（/mcp）与面向传统 Webhooks 的 RESTful HTTP API。同时支持标准 Stdio 管道启动方式无缝集成 Cursor/Claude Desktop。 - ：支持获取真实的微头条历史列表。底层自动对接前端实际使用的 Feed 流接口 /api/feed/mp_provider/v1/，传入 category=mp_wtt、offset_mode=2 并按响应 offset 翻页；再合并 /mp/agw/statistic/v2/item/list?type=3 返回的统计指标，规避作品管理接口游标卡死和统计接口数量不全的问题。 - ： - 数据概览和统计报告优先采用纯 HTTP 极速提取模式（耗时从 10s 降低到 200ms）。通过 /home/merge_v2 瞬间获取粉丝量、总阅读和累计收益；通过 Feed 流接口拉取前 100 篇内容并在内存中累加计算点赞和转发总数。 - 趋势拉取固定使用全局过滤器 type=0，保障粉丝变化及各指标趋势与官方后台完美对应。 - 自动保留了高容错的无头浏览器 DOM 抓取作为优雅降级兜底防线。 - ：支持对已发布或草稿状态的文章进行无残留二次修改。新支持 SaveAsDraft 选项（仅保存草稿不发布），支持纯草稿箱安全测试，测试数据不污染真实主页，且测试完毕后能通过浏览器物理清除。智能跳过非必要封面重传以防超时；引入 React onChange 底层强力驱动与 3s 延迟平息期以彻底防止 React 异步重绘回滚；在最终发布前执行“一致性二次固化校验与强行覆盖”，保证提交数据 100% 固化；物理兼容“发布”确认弹窗。 - ：解除头条原接口对已发布文章仅展示最近 3 篇的封锁。

Install

This server does not publish a one-line install command.

Open the repository installation guide New to MCP? Start with the mcpskill.org guide →

Configuration

{
  "mcpServers": {
    "toutiao-mcp": {
      "command": "/path/to/your/toutiaohao-server",
      "args": ["-stdio"]
    }
  }
}