Zsxq Group
List your joined 知识星球 groups and their topic hashtags so an agent can fetch group_id and hashtag_id for community research.
Overview
zsxq-group is an agent skill most often used in Idea (also Grow, Validate) that lists joined 知识星球 groups and their hashtags via zsxq-cli so builders obtain group_id and hashtag_id for topic APIs.
Install
npx skills add https://github.com/unnoo/zsxq-skill --skill zsxq-groupWhat is this skill?
- Shortcut `zsxq-cli group +list` lists joined or created groups (default 10, `--limit 50`) in table or JSON
- Shortcut `zsxq-cli group +hashtags --group-id` returns hashtag_id, title, and topic count per tag
- `--json` on both commands exposes full API fields including owner metadata for agents
- Documents paginated `get_hashtag_topics` calls using hashtag_id from the table output
- Points to zsxq-shared for 401, missing `--group-id`, and permission errors
- `group +list` returns up to 10 groups by default and supports `--limit 50`
- Hashtag table columns: HASHTAG ID, TITLE, TOPIC COUNT
- `get_hashtag_topics` example uses limit 20 with optional end_time pagination
Adoption & trust: 2.3k installs on skills.sh; 157 GitHub stars; 2/3 security scanners passed (skills.sh audits).
What problem does it solve?
You are in paid community circles but your agent cannot browse or filter posts because it lacks group_id and hashtag_id from the official CLI.
Who is it for?
Builders already authenticated with zsxq-cli who want agents to inventory circles and tags before pulling topics for market or content research.
Skip if: Anyone without zsxq-cli login and planet access, or teams that only need one-off manual browsing in the mobile app.
When should I use this skill?
You need group_id from joined 知识星球 communities or hashtag_id to list or paginate topics under a tag via zsxq-cli.
What do I get? / Deliverables
You get a table or JSON map of groups and tags with counts, then chain `get_hashtag_topics` or zsxq-topic-search using those IDs.
- Table or JSON list of group_id values from `group +list`
- Table or JSON of hashtag_id, titles, and topic counts for a given group
Recommended Skills
Journey fit
Spans multiple journey phases - primary shelf plus alternate fits below.
Canonical shelf is Idea because solo builders most often install this first to discover which paid communities and topic tags exist before deeper validation or content workflows. Research fits listing groups and hashtags—the discovery step that unlocks tagged topic APIs and keyword search in those circles.
Where it fits
Run `group +list --limit 50` to see every paid circle you can mine for niche pain points before picking a product idea.
Use `group +hashtags` to find which tags concentrate founder or buyer discussions in a target planet.
Pull topic counts per hashtag to decide which themes warrant deeper topic pulls for problem validation.
Map hashtags with high topic counts to plan repurposed newsletters or threads from archived planet posts.
How it compares
CLI skill shortcuts for 知识星球 IDs, not a generic web scraper or MCP browser automation.
Common Questions / FAQ
Who is zsxq-group for?
Solo and indie builders using Claude Code, Cursor, or Codex with zsxq-cli to research paid 知识星球 communities and organize fetches by hashtag.
When should I use zsxq-group?
During Idea research to discover which groups you belong to and which tags hold signal; during Validate to sample tagged discussions; during Grow when repurposing tagged posts—run `group +list` then `group +hashtags` before topic APIs.
Is zsxq-group safe to install?
Treat it as code that drives authenticated API access; review the Security Audits panel on this Prism page and rotate tokens if the shared skill references secrets handling.
SKILL.md
READMESKILL.md - Zsxq Group
# group +hashtags（查看星球标签） 本 skill 对应 shortcut：`zsxq-cli group +hashtags`。 列出指定星球内所有的话题标签（Hashtag）及其主题数量。常用于获取 `hashtag_id` 以便按分类浏览内容。 ## 命令 ```bash # 列出星球所有标签（表格显示） zsxq-cli group +hashtags --group-id 123456789 # JSON 格式（含 hashtag_id、owner 等完整字段） zsxq-cli group +hashtags --group-id 123456789 --json ``` ## 参数 | 参数 | 必填 | 说明 | |------|------|------| | `--group-id <id>` | **是** | 星球 ID（从 `group +list` 获取） | | `--json` | 否 | 输出原始 JSON | ## 输出（表格模式） | HASHTAG ID | TITLE | TOPIC COUNT | |------------|-------|-------------| | 333444555666 | #示例标签# | 12 | | 333444555677 | #示例标签二# | 5 | ## 说明 获得 `hashtag_id` 后，可通过 API 列出该标签下的所有主题： ```bash zsxq-cli api call get_hashtag_topics \ --params '{"hashtag_id":"333444555666","limit":20}' # 翻页 zsxq-cli api call get_hashtag_topics \ --params '{"hashtag_id":"333444555666","limit":20,"end_time":"2025-11-01T00:00:00.000+0800"}' ``` ## 错误说明 | 症状 | 可能原因 | 处理 | |------|---------|------| | 返回空列表 | 该星球尚未创建任何标签 | 正常情况，无需处理 | 通用错误（401、`--group-id is required`、星球不存在/无权限等）见 [zsxq-shared](../../zsxq-shared/SKILL.md#常见错误处理)。 ## 参考 - [zsxq-group-topics](zsxq-group-topics.md) — 浏览星球全部主题 - [zsxq-topic-search](../../zsxq-topic/references/zsxq-topic-search.md) — 关键词搜索主题 - [zsxq-shared](../../zsxq-shared/SKILL.md) # group +list（列出星球） 本 skill 对应 shortcut：`zsxq-cli group +list`。 列出当前登录用户**加入或创建**的所有知识星球。常用于获取 `group_id` 供后续操作使用。 ## 命令 ```bash # 列出星球（默认最多 10 个，表格显示） zsxq-cli group +list # 返回更多结果 zsxq-cli group +list --limit 50 # JSON 格式输出（含完整字段） zsxq-cli group +list --json ``` ## 参数 | 参数 | 必填 | 说明 | |------|------|------| | `--limit <n>` | 否 | 最多返回数量，默认 10，最大 200 | | `--json` | 否 | 输出原始 JSON（含 owner、statistics 等完整字段） | ## 输出（表格模式） | GROUP ID | NAME | |----------|------| | 123456789 | 示例星球 | ## 说明 - 返回结果同时包含用户**加入**和**创建**的星球 - `group_id` 是纯数字字符串，后续 `+topics`、`+hashtags` 等命令均需要此值 - 如需在结果中区分"加入 / 创建"，使用 `--json` 查看完整字段 ## 错误说明 | 症状 | 可能原因 | 处理 | |------|---------|------| | 返回空列表 | 当前账户尚未加入或创建任何星球 | 确认登录账户：`zsxq-cli user +info` | 通用错误（401 等）见 [zsxq-shared](../../zsxq-shared/SKILL.md#常见错误处理)。 ## 参考 - [zsxq-group-topics](zsxq-group-topics.md) — 查看星球内主题 - [zsxq-group-hashtags](zsxq-group-hashtags.md) — 查看星球标签 - [zsxq-shared](../../zsxq-shared/SKILL.md) # group +topics（浏览星球主题） 本 skill 对应 shortcut：`zsxq-cli group +topics`。 列出指定星球内最新发布的主题，按时间倒序排列，支持分页。 ## 命令 ```bash # 列出星球最新 20 条主题（表格显示） zsxq-cli group +topics --group-id 123456789 # 返回更多（最多 30） zsxq-cli group +topics --group-id 123456789 --limit 30 # 翻页：使用上一页返回的 next_end_time 作为游标 zsxq-cli group +topics --group-id 123456789 --end-time "2025-12-01T00:00:00.000+0800" # JSON 格式（含完整 topic 字段、内容、点赞数等） zsxq-cli group +topics --group-id 123456789 --json ``` ## 参数 | 参数 | 必填 | 说明 | |------|------|------| | `--group-id <id>` | **是** | 星球 ID（从 `group +list` 获取） | | `--limit <n>` | 否 | 返回数量，默认 20，最大 30 | | `--end-time <t>` | 否 | 分页游标，格式：`2025-12-01T00:00:00.000+0800`（上一页返回的 `next_end_time`） | | `--json` | 否 | 输出原始 JSON | ## 输出（表格模式） | TOPIC ID | TYPE | TITLE / DIGEST | CREATED AT | |----------|------|----------------|------------| | 111222333444 | talk | 示例主题标题 | 2025-12-31T09:19:28.239+0800 | - `TYPE`：`talk`（帖子）、`q&a`（提问）、`task`（作业题目）、`solution`（作业答案） - `TITLE / DIGEST`：优先显示标题，无标题时显示内容摘要（截断至 50 字符） ## 说明 按时间倒序返回最新主题。当 `--json` 输出中 `has_more: true` 时，使用返回的 `next_end_time` 值作为 `--end-time` 参数继续翻页： ```bash # 第一页 zsxq-cli group +topics --group-id 123456789 --json # → 得到 next_end_time: "2025-11-01T10:00:00.000+0800" # 第二页 zsxq-cli group +topics --group-id 123456789 \ --end-time "2025-11-01T10:00:00.000+0800" --json ``` ## 错误说明 通用错误（401、参数缺失、404、`--end-time` 格式错误等）见 [zsxq-shared](../../zsxq-shared/SKILL.md#常见错误处理)。本命令无特有错误。 ## 参考 - [zsxq-topic-detail](../../zsxq-topic/references/zsxq-topic-detail.md) — 查看主题详情 - [zsxq-topic-search](../../zsxq-topic/references/zsxq-topic-search.md) — 按关键词搜索主题 - [zsxq-group-hashtags](zsxq-group-hashtags.md) — 按标签筛选主题 - [zsxq-shared](../../zsxq-shared/SKILL.md) --- name: zsxq-group version: 1.3.1 des