# 今日头条 MCP Server

基于 [Model Context Protocol](https://modelcontextprotocol.io/) 的今日头条创作者平台服务，使 AI 助手能够通过标准化协议完成内容发布、管理和数据分析。

## 功能

### 认证管理
- `login_with_credentials` — 账密登录（浏览器自动化，支持人工补充验证码）
- `check_login_status` — 检查登录状态
- `delete_cookies` — 删除 Cookie，重置登录

### 内容发布
- `publish_article` — 发布图文文章（标题、正文、图片、标签、分类、封面、原创标记）
- `publish_micro_post` — 发布微头条（文本、图片最多 9 张、话题）
- `save_micro_post_draft` — 保存微头条草稿

### 内容管理
- `get_article_list` — 获取内容列表（支持 all/published/draft/review 筛选）
- `delete_article` — 删除文章或草稿

### 数据分析
- `get_account_overview` — 账户数据概览（粉丝、阅读、获赞）
- `get_article_stats` — 单篇文章统计（阅读、点赞、评论、转发）
- `generate_report` — 生成分析报告（日报/周报/月报）

## 技术栈

| 组件 | 选型 |
|------|------|
| 语言 | Go 1.25+ |
| MCP SDK | `github.com/modelcontextprotocol/go-sdk` |
| 浏览器自动化 | `github.com/go-rod/rod` + `github.com/xpzouying/headless_browser` |
| HTTP 框架 | `github.com/gin-gonic/gin` |
| 日志 | `github.com/sirupsen/logrus` |

## 快速开始

### 编译

```bash
go build -o toutiao-mcp-server.exe .
```

### 运行

```bash
# 默认端口 8080
./toutiao-mcp-server

# 指定端口
./toutiao-mcp-server -port 9000
```

### MCP 客户端配置

```json
{
  "mcpServers": {
    "toutiao": {
      "url": "http://localhost:8080/mcp"
    }
  }
}
```

## API 端点

服务同时提供 MCP 协议和 REST API 两种接入方式。

### MCP

- `POST /mcp` — MCP Streamable HTTP 端点

### REST API

| 方法 | 路径 | 说明 |
|------|------|------|
| POST | `/api/v1/login` | 登录 |
| GET | `/api/v1/login/status` | 检查登录状态 |
| DELETE | `/api/v1/login/cookies` | 删除 Cookie |
| POST | `/api/v1/publish/article` | 发布文章 |
| POST | `/api/v1/publish/micro` | 发布微头条 |
| POST | `/api/v1/publish/micro/draft` | 保存微头条草稿 |
| GET | `/api/v1/articles` | 获取文章列表 |
| POST | `/api/v1/articles/delete` | 删除文章 |
| GET | `/api/v1/analytics/overview` | 账户概览 |
| GET | `/api/v1/analytics/article` | 文章统计 |
| GET | `/api/v1/analytics/report` | 生成报告 |
| GET | `/health` | 健康检查 |

## 项目结构

```
toutiao-mcp-server/
├── main.go                 # 入口
├── app_server.go           # AppServer 聚合（Service + MCP + HTTP）
├── mcp_server.go           # MCP 工具注册、参数结构体、panic 恢复
├── mcp_handlers.go         # MCP handler（参数校验 + 调用 Service）
├── handlers_api.go         # REST API handler
├── routes.go               # 路由配置
├── service.go              # 业务编排层
├── types.go                # 公共类型（MCPToolResult 等）
├── middleware.go            # CORS、错误恢复
├── configs/
│   ├── urls.go             # URL 常量
│   ├── content.go          # 内容限制常量
│   └── browser.go          # 浏览器配置
├── cookies/
│   └── cookies.go          # Cookier 接口 + FileCookieStore
├── browser/
│   └── browser.go          # 浏览器工厂（Option 模式 + Cookie 自动注入）
├── toutiao/
│   ├── login.go            # 登录流程
│   ├── publish_micro.go    # 微头条发布 + 参数校验
│   ├── publish_article.go  # 文章发布 + 参数校验
│   ├── draft_micro.go      # 微头条草稿保存（HTTP API）
│   ├── article_list.go     # 文章列表 + 删除（HTTP API）
│   ├── analytics.go        # 数据分析（HTTP API）
│   ├── navigate.go         # 页面导航辅助
│   ├── selectors.go        # 页面选择器常量
│   └── types.go            # 业务层类型
└── pkg/downloader/
    └── image.go            # 图片下载与校验
```

## 环境变量

| 变量 | 说明 | 默认值 |
|------|------|--------|
| `TOUTIAO_COOKIES_PATH` | Cookie 文件路径 | `cookies.json` |
| `TOUTIAO_PROXY` | 代理地址 | 无 |

## 测试

```bash
go test ./...
```