zsxq-group
unnoo/zsxq-skill
Manage 知识星球 (Zhihu Knowledge Planet) groups: list, browse topics, query tags, search members.
What is zsxq-group?
Manage 知识星球 communities by listing groups you've joined or created, browsing topics within groups, retrieving group IDs, and querying group tags or members. Use this when you need to explore group content or locate specific information within a 知识星球 community.
- List all groups (星球) the current user has joined or created with group_id and names
- Browse latest topics within a group with pagination support, showing topic_id, type, title, and timestamp
- List all hashtags (标签) in a group and their topic counts
- Search for groups by keyword
- Search for group members by keyword with customizable result limits
- Retrieve topics associated with specific hashtags with pagination
How to install zsxq-group
npx skills add https://github.com/unnoo/zsxq-skill --skill zsxq-group- zsxq-cli must be installed and available in PATH
- User must be authenticated with 知识星球 (see zsxq-shared SKILL.md for login instructions)
How to use zsxq-group
- 1.Run `zsxq-cli group +list` to view all groups you've joined or created and obtain their group_id values
- 2.Use `zsxq-cli group +topics <group_id>` to browse the latest topics in a specific group
- 3.Execute `zsxq-cli group +hashtags <group_id>` to see all available tags and their topic counts
- 4.For advanced searches, use `zsxq-cli api call search_groups --keyword <keyword>` to find groups by name
- 5.Use `zsxq-cli api call search_group_members --group_id <id> --keyword <name>` to locate specific members by nickname
Use cases
- Discover which 知识星球 communities you're a member of and get their group IDs for further operations
- Browse the latest discussions and content posted in a specific group
- Find topics tagged with specific hashtags to explore curated content
- Locate specific members within a group by searching their nicknames
- Identify available topic categories (hashtags) within a group before searching for content
- 知识星球 community members and group creators
- Users managing multiple group memberships
- Content researchers exploring group-organized discussions
- Community moderators and administrators
zsxq-group FAQ
Run `zsxq-cli group +list` to see all groups you've joined with their IDs, or use `zsxq-cli api call search_groups --keyword <group_name>` to search for public groups by name.
No, use the zsxq-topic skill's `+search` command for full-text content search. The `+topics` shortcut is for browsing recent topics only.
`+topics` shows recent posts/discussions in chronological order with pagination, while `+hashtags` lists all available tag categories and how many topics are tagged with each.
Use the zsxq-user skill's `+footprints` command to get your cross-group activity history instead of running `+topics` on each group individually.
No, search_group_members is a keyword search tool for locating specific members by nickname. It is not designed for listing or enumerating all group members.
Full instructions (SKILL.md)
Source of truth, from unnoo/zsxq-skill.
name: zsxq-group version: 1.3.2 description: "知识星球（星球）管理：列出星球、浏览主题、查询标签、搜索成员。当用户需要查看自己加入或创建的星球、浏览星球内容、获取 group_id、查询星球标签或成员时使用。" metadata: requires: bins: ["zsxq-cli"] cliHelp: "zsxq-cli group --help"
group
首次使用或遇到认证错误（401 / token 过期 /
not logged in）时，先读../zsxq-shared/SKILL.md了解登录与 API 调用约定。日常调用已登录账户时无需每次重读。
Core Concepts
- 星球（Group）：知识星球的社群单元，由
group_id（纯数字）唯一标识。用户可以是创建者（owner）或成员（member）。 - 主题（Topic）：星球内的内容单元，包括帖子（talk）、提问（q&a）、作业（task）、作业答案（solution）等，由
topic_id唯一标识。 - 标签（Hashtag）：星球内的分类标签，由
hashtag_id标识，可附加到主题上。
Resource Relationships
Group (group_id)
├── Topic (topic_id) — talk / q&a / task / solution
│ ├── Comment (comment_id)
│ │ └── 楼中楼 Reply (replied_comment_id)
│ ├── Answer（q&a 类型专属）
│ └── Hashtag 标签
└── Hashtag (hashtag_id)
└── Topic 列表
Shortcuts（推荐优先使用）
Shortcut 是对常用操作的高级封装（zsxq-cli group +<verb> [flags]）。有 Shortcut 的操作优先使用。
| Shortcut | 说明 |
|---|---|
+list | 列出当前用户加入或创建的所有星球，输出 group_id 和名称表格 |
+topics | 列出星球内最新主题，支持分页游标，输出 topic_id / 类型 / 标题 / 时间表格 |
+hashtags | 列出星球内所有标签及主题数量 |
API（通过 zsxq-cli api call 直接调用）
Shortcut 未覆盖的高级操作：
| 工具 | 参数 | 说明 |
|---|---|---|
search_groups | keyword | 按关键词搜索星球 |
search_group_members | group_id, keyword, limit | 搜索星球成员 |
get_hashtag_topics | hashtag_id, limit, end_time | 列出某标签下的主题（分页） |
反例（不要做）
| ❌ 不要做 | ✅ 应该做 |
|---|---|
按关键词找内容时用 +topics 翻页逐条人工筛选 | 用 zsxq-topic 的 +search 全文搜索 |
查「自己最近发过什么」时逐个星球跑 +topics | 用 zsxq-user 的 +footprints 一次拿到跨星球足迹 |
| 用户只给星球名称时，让用户自己提供 group_id 或凭记忆猜 ID | 先 group +list（自己加入的）或 search_groups（公开搜索）查到 ID 再继续 |
| 名称命中多个相似星球时默认取第一个 | 列出候选（group_id + 名称）让用户确认 |
把 search_group_members 当成员列表接口、调大 limit 遍历全员 | 它是关键词搜索，只用于按昵称定位具体成员 |
Related skills
More from unnoo/zsxq-skill and the wider catalog.
zsxq-shared
知识星球 CLI 共享基础：认证、API 调用、链接拼接、错误处理
zsxq-topic
Manage Knowledge Planet topics: search, create, edit, comment, answer questions, and moderate content.
zsxq-note
Manage shareable public notes on 知识星球 (Zhihu Planet) with create, edit, view, and delete operations.
zsxq-user
View 知识星球 user profile, cross-sphere topic footprints, and submit NPS feedback.