spider-mcp
面向 agent 的多平台内容平台自动化 MCP(抖音 / 小红书)。通过 MCP 协议暴露登录、搜索、抓取、发布、评论等能力,供 Claude Code、Cursor 等 agent 调用。
特性
- 多租户:每个账号(
accountId)一套隔离的浏览器 profile 与登录态 - 浏览器自动化:基于 Playwright,复用登录态,适配反爬严格的平台
- 双传输:
stdio(本地开发)+ HTTP/SSE(线上部署) - 媒体上传:
upload_asset+MediaRef(url / asset / base64 / path)
当前状态
骨架已就位,9 个 tool 已注册并可通过 MCP 协议调用,具体平台实现逐步填充中。
| 部分 | 状态 |
|---|---|
| MCP server(stdio) | ✅ |
| 类型契约 / tool schema | ✅ |
| BrowserManager | 🚧 进行中 |
| DouyinHandler 各方法 | 🟡 桩 |
依赖安装
bun install
bunx playwright install chromium # 若复用系统 Chrome 可跳过
在 Claude Code 中接入(stdio)
方式一:CLI 命令(推荐)
claude mcp add spider-mcp -- bun /Users/zeek/Projects/MCP/spider-mcp/index.ts
可加 scope:
-s user(全局)或-s project(仅当前项目,写入.mcp.json)。
方式二:项目配置文件
在项目根目录创建 .mcp.json:
{
"mcpServers": {
"spider-mcp": {
"command": "bun",
"args": ["/Users/zeek/Projects/MCP/spider-mcp/index.ts"]
}
}
}
全局则编辑
~/.claude.json中的mcpServers。
验证
接入后在 Claude Code 里:
/mcp
应能看到 spider-mcp 处于 connected 状态,并列出 9 个 tool:
| tool | 说明 |
|---|---|
login |
发起登录,返回二维码(首次 loggedIn=false) |
login_status |
查询登录态(配合 login 轮询) |
logout |
退出并清理 session |
search |
搜索作品 |
get_note |
抓取单个作品详情 |
get_comments |
抓取评论列表 |
publish |
发布内容(图文/视频) |
comment |
发评论 |
upload_asset |
上传媒体,返回 assetId |
所有 tool 都带 platform(douyin/xiaohongshu)和 accountId 参数。
本地调试
不开 Claude Code,直接用 stdin/stdout 喂 JSON-RPC 验证:
# 初始化握手 + 列出所有 tool
printf '%s\n%s\n%s\n' \
'{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"test","version":"0"}}}' \
'{"jsonrpc":"2.0","method":"notifications/initialized"}' \
'{"jsonrpc":"2.0","id":2,"method":"tools/list","params":{}}' \
| bun run index.ts
目录结构
src/
├── types.ts # 共享数据类型
├── server.ts # MCP server:tool 注册 + 路由
├── registry.ts # 平台 handler 注册表
├── stdio.ts # stdio 传输入口(本地开发)
├── http.ts # HTTP/SSE 传输入口(线上,占位)
├── browser/manager.ts # Playwright 持久化浏览器管理(多租户)
├── platforms/
│ ├── base.ts # PlatformHandler 抽象接口
│ └── douyin.ts # 抖音实现
├── tools/schemas.ts # tool 的 zod 参数 schema
└── assets/store.ts # 媒体资产存储
开发
bun run typecheck # tsc --noEmit
bun run start # 启动 stdio server
