Skip to main content
Glama
spiriteZeek

spider-mcp

by spiriteZeek
OverviewSchemaRelated ServersScoreDiscussions
TypeScript
Hybrid

spider-mcp

面向 agent 的多平台内容平台自动化 MCP(抖音 / 小红书)。通过 MCP 协议暴露登录、搜索、抓取、发布、评论等能力,供 Claude Code、Cursor 等 agent 调用。

特性

  • 多租户:每个账号(accountId)一套隔离的浏览器 profile 与登录态

  • 浏览器自动化:基于 Playwright,复用登录态,适配反爬严格的平台

  • 双传输:stdio(本地开发)+ HTTP/SSE(线上部署)

  • 媒体上传:upload_asset + MediaRef(url / asset / base64 / path)

Related MCP server: xiaohongshu-mcp-py

当前状态

骨架已就位,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

This server cannot be installed

F
license - not found
-
quality - not tested
B
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/spiriteZeek/spider-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server