# Douban

> Douban

- Skill: `spike-faye-lei/douban` (Agent Skill, multi-file: 20 files)
- Install (CLI): `npx skillmds@latest add spike-faye-lei/douban`
- Raw SKILL.md: https://api.skillmd.com/api/skills/spike-faye-lei/douban/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: spike-faye-lei (https://skillmd.com/u/spike-faye-lei)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/spike-faye-lei/douban

---

# Douban

## Overview
Chinese media review/rating platform (movies, books, music). Social/media archetype — 14 operations across movies, books, music, and discovery via mobile JSON API.

## Workflows

### Find and explore a movie
1. `searchMovies(q)` → pick result → `target.id`
2. `getMovie(id=target.id)` → full detail → `rating.value`, `intro`, `genres`, `directors`, `actors`
3. `getMovieCelebrities(id=target.id)` → directors[], actors[] with `name`, `character`, `latin_name`
4. `getMovieReviews(id=target.id)` → user reviews → `comment`, `rating`, `user.name`, `vote_count`
5. `getMoviePhotos(id=target.id)` → stills, posters → `image.large.url`, dimensions

### Find and explore a book
1. `searchBooks(q)` → pick result → `target.id`
2. `getBook(id=target.id)` → full detail → `rating.value`, `intro`, `author_intro`, `pubdate`
3. `getBookReviews(id=target.id)` → user reviews → `comment`, `rating`, `user.name`, `vote_count`

### Discover trending content
1. `getRecentHotMovies()` → trending movies → `id`, `title`, `rating.value`
2. `getRecentHotTv()` → trending TV shows → `id`, `title`, `rating.value`, `episodes_info`
3. `getNowShowingMovies()` → in-theater movies → `id`, `title`, `release_date`
4. `getTop250(start)` → all-time top movies → `rank_value`, `title`, `rating.value`

### Find music
1. `searchMusic(q)` → pick result → `target.id`
2. `getMusicDetail(id=target.id)` → album detail → `title`, `singer[]`, `songs[]`, `genres[]`

## Operations

| Operation | Intent | Key Input | Key Output | Notes |
|-----------|--------|-----------|------------|-------|
| searchMovies | search movies | q | target.id, title, rating.value, year | entry point |
| getMovie | movie detail | id <- searchMovies/getRecentHotMovies | title, rating.value, genres, intro, directors, actors | |
| getMovieReviews | movie user reviews | id <- searchMovies | comment, rating, user.name, vote_count | paginated (count, start) |
| getMovieCelebrities | movie cast/crew | id <- searchMovies | directors[], actors[] with name, character, latin_name | |
| getMoviePhotos | movie photo gallery | id <- searchMovies | photos[].image.large.url, dimensions | paginated (count, start) |
| getTop250 | top 250 movies | start (optional) | rank_value, title, rating.value, id | paginated by 25 |
| searchBooks | search books | q | target.id, title, rating.value, card_subtitle | entry point |
| getBook | book detail | id <- searchBooks | title, rating.value, intro, author_intro, pubdate | |
| getBookReviews | book user reviews | id <- searchBooks | comment, rating, user.name, vote_count | paginated (count, start) |
| searchMusic | search music | q | target.id, title, rating.value, card_subtitle | entry point |
| getMusicDetail | album detail | id <- searchMusic | title, singer[], songs[], genres[], pubdate | |
| getRecentHotMovies | trending movies | limit (optional) | id, title, rating.value, year | entry point |
| getRecentHotTv | trending TV shows | limit (optional) | id, title, rating.value, episodes_info | entry point |
| getNowShowingMovies | in-theater movies | count (optional) | id, title, rating.value, release_date | entry point |

## Quick Start

```bash
# Search for a movie and get its ID
openweb douban exec searchMovies '{"q": "肖申克的救赎"}'

# Get movie detail by ID (from search results target.id)
openweb douban exec getMovie '{"id": 1292052}'

# Get movie cast and crew
openweb douban exec getMovieCelebrities '{"id": 1292052}'

# Get movie reviews
openweb douban exec getMovieReviews '{"id": 1292052, "count": 10}'

# Get movie photos
openweb douban exec getMoviePhotos '{"id": 1292052, "count": 10}'

# Search books
openweb douban exec searchBooks '{"q": "三体"}'

# Get book detail
openweb douban exec getBook '{"id": 2567698}'

# Trending movies right now
openweb douban exec getRecentHotMovies '{"limit": 20}'

# Movies in theaters
openweb douban exec getNowShowingMovies '{"count": 10}'

# Top 250
openweb douban exec getTop250 '{"start": 0, "count": 25}'

# Search music
openweb douban exec searchMusic '{"q": "周杰伦"}'

# Get album detail
openweb douban exec getMusicDetail '{"id": 1401853}'
```