Skip to main content
Glama

douban-mcp 🎬 📕

npm CI License: MIT

面向 agent 的豆瓣 MCP 服务 + CLI。同一个包既能做 Claude Desktop 的 MCP server(stdio / Streamable HTTP),又能给 Claude Code/OpenClaw 等 agent 直接当 CLI 用。

npm 包名为 douban-mcp-cli(裸名 douban-mcp 在 npm 已被他人占用);GitHub 仓库 / 产品名仍为 douban-mcp。

✨ 特性

  • ✅ 11 个匿名只读工具(电影 / 图书 / 用户态 全覆盖)+ 1 个登录态 cookie 自检工具

  • ✅ 4 个写工具(标记想看/在看/看过 + 打分 + 评论 + 标签),双模式 opt-in

  • ✅ 唯一数据源为 HTML(axios + cheerio);原 Frodo App API 通道因服务端签名要求已移除

  • ✅ MCP server (stdio + Streamable HTTP,兼容旧 SSE) + agent native CLI(--json 模式)

  • ✅ Claude Code Skill 包随仓库交付

  • ✅ 内置缓存 + 限速 + 风控退避

  • ⏳ v1.1:覆盖率 90%+;user search、doulist items

  • ⏳ v1.2:短评写操作

Related MCP server: douban-mcp

🚀 快速开始

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "douban": {
      "command": "npx",
      "args": ["-y", "douban-mcp-cli", "serve"],
      "env": { "DOUBAN_COOKIE": "你的cookie(可选)" }
    }
  }
}

CLI(任何 agent / 命令行)

npx -y douban-mcp-cli search-movie --q "盗梦空间" --count 3
npx -y douban-mcp-cli get-movie --id 3541415
npx -y douban-mcp-cli --json movie-chart --kind top250 --count 5 | jq

启用写操作:

export DOUBAN_COOKIE="bid=...; dbcl2=\"...\"; ck=...; ll=\"108288\""
export DOUBAN_ENABLE_WRITE=true
npx -y douban-mcp-cli mark-movie --id 3541415 --status collect --rating 5

⚠️ 写操作有触发风控/封号风险。建议先用小号验证;本项目对账号安全不承担责任。

v1.0 实测:search- 和 movie-chart top250 等聚合页匿名可用*;但 get-movie / get-book / get-*-reviews 等详情页会被豆瓣风控重定向到 sec.douban.com,必须配置 DOUBAN_COOKIE 才能稳定访问。

匿名模式下详情页会得到一条清晰错误:

⚠️ 豆瓣对该页面触发了风控(详情页常见)。请配置 DOUBAN_COOKIE 后重试。

注:原先设计的 DOUBAN_DATA_SOURCE=frodo 备用通道(豆瓣 App API)被服务端加签名要求拦截(invalid_request_997 签名缺失),代码已移除。仍设置该值会立刻报 AUTH_FAILED 并提示改回 html。

🛠️ 工具清单

只读(默认全部可用)

工具

鉴权

说明

search_movie

无

关键词搜索电影

get_movie

无

电影详情

get_movie_reviews

无

短评列表

get_movie_chart

无

榜单 (top250 / weekly / new)

search_book

无

关键词搜索图书

get_book

无

图书详情

get_book_reviews

无

短评列表

get_book_chart

无

榜单 (fiction / non_fiction / new)

get_user_collections

uid 缺省时需 cookie

想看/在看/看过列表

get_user_doulist

uid 缺省时需 cookie

豆列

get_user_profile

uid 缺省时需 cookie

用户信息

鉴权 / 写

工具

鉴权

说明

check_cookie

cookie

cookie 是否有效

mark_movie / unmark_movie

cookie + DOUBAN_ENABLE_WRITE

标记/取消标记电影

mark_book / unmark_book

cookie + DOUBAN_ENABLE_WRITE

标记/取消标记图书

📚 文档

⚙️ 环境变量

变量

默认

说明

DOUBAN_COOKIE

—

登录态 cookie

DOUBAN_ENABLE_WRITE

false

启用写操作

DOUBAN_DATA_SOURCE

html

仅支持 html;frodo 已移除,设置后直接报错

DOUBAN_LOG_LEVEL

info

debug/info/warn/error

DOUBAN_DISABLE_CACHE

false

关闭缓存(测试用)

DOUBAN_USER_AGENT

内置 Chrome UA

覆盖默认 UA

DOUBAN_HOST

127.0.0.1

HTTP 模式监听地址(--host 优先)

🔧 HTTP 模式(Streamable HTTP)

npx -y douban-mcp-cli serve --transport http --port 3000
# 然后在 MCP 客户端连接 http://127.0.0.1:3000/mcp

同一个进程同时提供:

端点

协议

状态

/mcp

Streamable HTTP(2025-03-26+),Mcp-Session-Id 会话

推荐

/sse + /messages

HTTP+SSE(2024-11-05)

已废弃,仅为旧客户端保留

--transport sse 仍可用,但只是 http 的别名并打印废弃警告;请把客户端迁到 /mcp。每个会话独立一个 MCP server 实例,多个客户端可同时连接。

默认只监听 127.0.0.1,并校验 Host / Origin 防 DNS rebinding。端点本身没有鉴权,而且会代理你的豆瓣登录态,所以要暴露给其他机器时必须显式指定,并自行加防火墙或反向代理:

npx -y douban-mcp-cli serve --transport http --port 3000 --host 0.0.0.0

🧰 调试

# 用 mcp-inspector 一键调试
npx @modelcontextprotocol/inspector npx -y douban-mcp-cli serve

# 直接命令行调用任何工具(agent 也用这种方式)
npx -y douban-mcp-cli list-tools
npx -y douban-mcp-cli describe search-movie
npx -y douban-mcp-cli doctor

🛡️ 免责声明

本项目仅供学习和个人使用,禁止用于商业目的或大规模数据爬取。使用本项目造成的任何账号风险(限流、封禁等)由使用者自行承担。本项目无任何官方背景。

Available Tools

11 tools
get_bookA
Read-only

获取图书详情(作者、出版、ISBN、简介等)。id 是豆瓣图书 subject id(数字)。

Inputs: id (required).

get_book_chartC
Read-only

获取图书榜单。kind: fiction (小说)、non_fiction (随笔)、new (新书速递)。

Inputs: kind (required), count.

get_book_reviewsC
Read-only

获取图书的短评列表。

Inputs: id (required), count.

get_movieA
Read-only

获取一部电影的详细信息(导演、演员、评分、简介等)。id 是豆瓣电影 subject id(数字)。

Inputs: id (required).

get_movie_chartB
Read-only

获取电影榜单。kind: top250 (Top250)、weekly (一周口碑榜)、new (近期上映)。

Inputs: kind (required), count, start.

get_movie_reviewsB
Read-only

获取一部电影的短评列表(不含长评)。

Inputs: id (required), count.

get_user_collectionsB
Read-only

获取某用户的"想看/在看/看过"列表。无 cookie 时必须传 uid。

Inputs: uid (required), status (required), category (required), count, +1 more.

get_user_doulistA
Read-only

获取某用户的豆列清单。无 cookie 时必须传 uid。

Inputs: uid (required).

get_user_profileB
Read-only

获取某用户的基本信息。无 cookie 时必须传 uid。

Inputs: uid (required).

search_bookB
Read-only

按关键词搜索豆瓣图书。

Inputs: q (required), count.

search_movieA
Read-only

按关键词搜索豆瓣电影。返回标题/年份/评分/链接的 markdown 列表。

Inputs: q (required), count.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.5/5.0

    Scored across 11 tools

    Disambiguation5/5

    Tools split cleanly along two axes: resource (movie/book/user) and action (search/get/reviews/chart/collections/doulist/profile). The movie and book families are perfectly parallel, so an agent can pick the right tool from the name plus the kind parameter alone. No two tools overlap in scope.

    Naming Consistency5/5

    Every tool follows a strict snake_case verb_noun pattern (search_movie, get_movie_reviews, get_user_doulist). Resource-first grouping (movie_*/book_*/user_*) makes the families obvious. No mixed conventions or vague verbs.

    Tool Count5/5

    11 tools is squarely in the sweet spot, and each one earns its place: four per media type plus three user tools. The symmetric design means no filler tools and no obvious redundancy.

    Completeness4/5

    Read coverage is solid for movies, books, and user lists, including charts and short reviews. Gaps remain: no write operations (marking watched/want-to-watch), no long-review retrieval, no user search, and no music/media coverage despite the broad 'douban' name.

    Maintenance

    ActivityMaintained
    ResponsivenessLimited data

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      A
      quality
      D
      maintenance
      An MCP server that wraps The Movie Database (TMDB) API, enabling search for movies and TV shows, retrieval of movie details, recommendations, similar movies, trending content, streaming providers, and movie discovery.
      8
      -
    • A
      license
      A
      quality
      B
      maintenance
      MCP server for The Movie Database (TMDB): search and look up movies, TV shows and people, and read IMDb/Rotten Tomatoes/Metacritic ratings (via OMDb) in the same call.
      2
      33
      66 npm
      6
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Official MCP server for the DDYS (低端影视) API, enabling search, details, resources, collections, comments, and media export (STRM, M3U) via natural language.
      17 npm
      MIT