# Zhihu Favorites

> Fetch and inspect Zhihu collections (收藏夹) and saved items, and extract full text for saved answers/articles via Zhihu web APIs (CookieCloud supported). Use when the user asks to查看知乎收藏夹、我收藏了哪些回答/文章、或"这篇回答/文章讲了什么"(need text).

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

---


# Zhihu Favorites

Use the scripts in `scripts/` to read your Zhihu collections and extract readable text for summarization.

Cookie auth (recommended)
- CookieCloud: set `COOKIECLOUD_UUID` + `COOKIECLOUD_PASSWORD` (also accepts `COOKIECLOUDUUID` / `COOKIECLOUDPASSWORD`)
  - Optional: `COOKIECLOUD_SERVER_URL` (default: `http://127.0.0.1:8088`)
- Or set `ZHIHU_COOKIES` / `ZHIHU_COOKIE` (raw `Cookie:` header string)
- Or pass `--cookie 'z_c0=...; ...'` to a script

## Quick Start

Probe login / current user:
```bash
docker compose run --rm runner python skills/zhihu-favorites/scripts/zhihu_me.py
```

List collections (favorites folders):
```bash
docker compose run --rm runner python skills/zhihu-favorites/scripts/zhihu_collections.py --limit 50
```

List items inside a collection:
```bash
docker compose run --rm runner python skills/zhihu-favorites/scripts/zhihu_collection_items.py --collection-id <id> --limit 50
```

Fetch full content for an answer/article (plain text output by default):
```bash
docker compose run --rm runner python skills/zhihu-favorites/scripts/zhihu_item_content.py --url 'https://www.zhihu.com/question/.../answer/...'
docker compose run --rm runner python skills/zhihu-favorites/scripts/zhihu_item_content.py --url 'https://zhuanlan.zhihu.com/p/...'
```

JSON mode (for piping / automation):
- Add `--json` to any script.

## How To Answer Common Requests

- "帮我看看知乎的收藏夹"
  - Run `docker compose run --rm runner python skills/zhihu-favorites/scripts/zhihu_collections.py --json --limit 50` and show `id/title/item_count` so the user can pick a collection.
- "我最近收藏了哪些回答/文章？"
  - Pick a collection and run `docker compose run --rm runner python skills/zhihu-favorites/scripts/zhihu_collection_items.py --collection-id <id> --limit 20` (items come in API order).
- "这篇回答/文章讲了什么？"
  - Run `docker compose run --rm runner python skills/zhihu-favorites/scripts/zhihu_item_content.py --url ...` and summarize from the extracted plain text.

## Troubleshooting

- "No cookies found": set CookieCloud env vars or `ZHIHU_COOKIES`, or pass `--cookie`.
- 403 / captcha / empty payloads: cookies may be expired; re-sync CookieCloud. If Zhihu blocks direct API, use Playwright as fallback (see `references/research.md`).