MCPInstall

zsxq-shared

by unnooBackend & APIs

知识星球 CLI 共享基础：认证登录（auth login/logout/status）、配置诊断（doctor/config show）、通用 API 调用规范（api list/api call/api raw 调用底层接口或原始 HTTP 接口）、星球与主题分享链接拼接（电脑端 / 手机端）、写入与删除操作的安全规则、常见错误码处理（401 token 过期、缺参数等）。当用户首次登录、退出登录、查看认证状态、调用 zsxq-cli api raw / api call、需要拼接知识星球分享链接，或遇到认证或 HTTP 错误时使用。

Installs
4.6K
Last 24h
—
Trending rank
—
Security
Warn

Install

Works with every agent the skills CLI supports.

npx skills add https://github.com/unnoo/zsxq-skill --skill zsxq-shared
  1. 01

    Install

    Run the command in your project. The CLI asks which agents to install for.

  2. 02

    Describe the task

    Ask your agent for something this skill covers. It loads zsxq-shared automatically when relevant.

  3. 03

    Review the result

    The agent follows the SKILL.md steps, scripts and references bundled with the skill.

Security audits

Independent scans of the skill's instructions and bundled files.

Gen Agent Trust Hub PassSAFE ·This skill provides instructions for managing authentication and interacting with the ZSXQ (知识星球) platform via the 'zsxq-cli' command-line tool. It follows standard OAuth procedures, stores credentials securely in the system Keychain, and includes explicit safety guidelines for the agent to protect user data.
Socket PassNo alerts
Snyk WarnMEDIUM ·Risk: MEDIUM · 1 issue
ZeroLeaks PassNONE ·Score: 93/100 · 2 sections analyzed

SKILL.md

The instructions your agent reads when the skill is triggered.

zsxq-cli 共享规则

本技能指导你如何通过 zsxq-cli 操作知识星球资源，以及有哪些注意事项。

索引

Commands

命令说明
zsxq-cli auth loginOAuth 设备授权码登录（首次使用、token 过期或切换账户时）
zsxq-cli auth status查看当前登录账户（默认表格，加 --json 输出 JSON）
zsxq-cli auth logout清除本地凭据
zsxq-cli doctor诊断 CLI 配置与 keychain 认证状态
zsxq-cli config show显示版本信息与当前配置（加 --json 输出 JSON）
zsxq-cli api list列出所有可用底层接口工具及参数
zsxq-cli api call <tool>调用底层接口工具，需配 --params '<json>'
zsxq-cli api raw直接调用原始 HTTP 接口（需 --method --path）

详细用法见下面各小节。

认证

zsxq-cli 使用 OAuth 2.0 设备授权码流程（RFC 8628） 认证，token 存储在系统 Keychain 中，永久有效。

OAuth 登录流程

zsxq-cli auth login 启动后：

  1. 命令输出一个 verification_uri 链接和 user_code
  2. 用户在手机或浏览器中打开链接，完成授权
  3. CLI 自动轮询，授权完成后自动保存 token

当你作为 AI Agent 帮用户登录时，在后台运行 zsxq-cli auth login，读取输出后将授权链接提供给用户，等待用户完成授权。

直接调用 API

当 Shortcut 无法满足需求时，可以直接调用底层接口（参数与方法见上面 Commands 表）。

api call 示例：

zsxq-cli api call get_self_info --params '{}'
zsxq-cli api call search_groups --params '{"keyword":"Go语言"}'

# 跨星球查询当前用户主题足迹（不传 group_id 即查所有星球）
zsxq-cli api call get_user_footprints --params '{"user_id":"123456"}'
# 限定单个星球
zsxq-cli api call get_user_footprints --params '{"user_id":"123456","group_id":"123456789"}'

api raw 示例：

zsxq-cli api raw --method GET --path /v3/users/self

# --body 支持简写，自动包装 req_data
zsxq-cli api raw --method PUT --path /v2/topics/123 --body '{"text":"新内容"}'

列表/查询类操作请优先使用 api call（如 get_group_topics），api raw 主要用于 api call 尚未覆盖的写入接口。

api raw 响应已去除三层嵌套，直接返回数据内容。

链接拼接

当用户需要分享链接时，使用以下模板拼接。输出时同时提供电脑端和手机端两个版本。

主题链接

  • 电脑端：https://wx.zsxq.com/group/{group_id}/topic/{topic_id}
  • 手机端：https://wx.zsxq.com/mweb/views/topicdetail/topicdetail.html?topic_id={topic_id}&group_id={group_id}

星球链接

  • 电脑端：https://wx.zsxq.com/group/{group_id}
  • 手机端：https://wx.zsxq.com/mweb/views/topic/topic.html?group_id={group_id}

安全规则

  • Token 是登录凭证，禁止在终端明文输出或分享给他人
  • 写入/删除操作前必须确认用户意图（发帖、编辑、评论、回答、创建笔记、删除主题或笔记、提交 NPS 反馈等）
  • 不确定 group_id / topic_id / note_id 时，先用查询命令确认，再执行写入或删除

反馈提醒（NPS）

当用户在使用 zsxq-* skill 过程中遇到「适合反馈给知识星球官方」的场景时，AI 应在完成主任务后顺带一句提示用户考虑提交 NPS 反馈（zsxq-cli user +nps）。

触发场景

#场景信号标签
1用户表达对知识星球产品本身的不满自然语言：抱怨产品规则 / 抱怨体验 / 「这功能怎么这么难用」#产品建议#
2用户的需求知识星球产品侧不存在能力AI 排查后确认接口/能力在产品上根本没有（不是 CLI 没封装）#产品建议#
3zsxq-cli / skill 工具侧未封装api list 中找不到对应工具，且 api raw 也无现成 path#工具反馈#
4同一命令多次重试仍失败、用户明显受挫同一会话内对同一目标的命令连续失败 ≥ 3 次，且失败原因不属于排除清单#工具反馈#

排除场景（不触发提示）

下列错误属于「用户自查可解 / 状态类错误」，应走对应的解决路径而非反馈，与下面 ## 常见错误处理 表对齐：

  • 401 / not logged in → 引导 auth login
  • 403 / 无权限 → 提示切换账户或加入星球
  • 404 / 资源不存在 → 重新核对 ID
  • --<flag> is required 等参数缺失 → 用查询命令补齐
  • --end-time 解析失败等格式错误 → 参见下面 ## 常见错误处理 表的格式说明

提示流程

[1] 命中触发场景
[2] AI 一句话提示（不打断主任务）
    示例："顺带一提：刚刚这个场景比较适合反馈给知识星球官方，
           你需要的话我可以帮你提交一条 NPS 反馈。"
[3] 用户拒绝 → 回到主任务，会话内不再提
    用户接受 ↓
[4] AI 协助起草：
    - 询问 score（1–10），不自动赋值
    - 起草 suggestion（≤ 500 字），以 #产品建议# 或 #工具反馈# 开头
    - 把 score 与 suggestion 全文复述给用户确认
[5] 用户确认 → 执行 zsxq-cli user +nps
    用户改稿 → 回到 [4] 修订

关键约束

  • 每会话最多 1 次：同一会话内只提示一次；发过就不再主动重复，除非用户后续主动询问。
  • 附带不替代：第 [2] 步是附带的，不能让反馈提示中断或替换主任务的解决路径。先解决用户的事，再顺口提一句。
  • score 必须问用户：第 [4] 步起草不替代用户判断，score 不能自动赋值。
  • suggestion 必须复述确认：AI 起草后必须把 score 与 suggestion 全文复述给用户确认，用户改稿后回 [4] 修订。
  • tag 写在 suggestion 正文开头：#产品建议# / #工具反馈# 不占用 score 字段，让官方读到原文时就有分流标记。

详见 zsxq-user-nps。

常见错误处理

下表覆盖所有 zsxq-cli 命令通用的错误。各命令的 reference 文档只列出与该命令直接相关的特殊错误（如 --score must be 1–10、code: 100262 无权限删除），通用错误一律回到这里。

错误原因解决方案
authentication failed (HTTP 401) / not logged inToken 无效、过期或未登录运行 zsxq-cli auth login 重新登录
403 / 无权限 / 不可访问当前账户无访问目标资源的权限切换到正确账户，或加入对应星球后重试
404 / 资源不存在group_id / topic_id / note_id 等无效或对应资源已被删除重新核对 ID；可用 group +list、topic +search、note +list 等查询
--<flag> is required缺少必填参数用对应查询命令获取后再填，例如 group_id 用 group +list、topic_id 用 topic +search
--end-time 解析失败分页时间格式错误使用上一页 JSON 中返回的 next_end_time / create_time 原值

FAQ

What does the zsxq-shared skill do?

知识星球 CLI 共享基础：认证登录（auth login/logout/status）、配置诊断（doctor/config show）、通用 API 调用规范（api list/api call/api raw 调用底层接口或原始 HTTP 接口）、星球与主题分享链接拼接（电脑端 / 手机端）、写入与删除操作的安全规则、常见错误码处理（401 token 过期、缺参数等）。当用户首次登录、退出登录、查看认证状态、调用 zsxq-cli api raw / api call、需要拼接知识星球分享链接，或遇到认证或 HTTP 错误时使用。

How do I install zsxq-shared?

Run npx skills add https://github.com/unnoo/zsxq-skill --skill zsxq-shared in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/zsxq-shared/ (personal) or .claude/skills/zsxq-shared/ (project).

Which AI agents can use zsxq-shared?

Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.

Is zsxq-shared safe to install?

Security partners have reviewed it: Gen Agent Trust Hub passed; Socket passed; Snyk flagged items to review; ZeroLeaks passed. As with any skill, read the SKILL.md and bundled scripts before installing.

Who maintains zsxq-shared?

It is published by unnoo in unnoo/zsxq-skill. It has 4,575 recorded installs.

More from unnoo/zsxq-skill

View all →

zsxq-topic

unnoo/zsxq-skill

知识星球主题管理：搜索主题、查看主题详情、发布帖子、编辑主题、发表评论、回复某条评论（楼中楼）、回答提问、删除主题；通过 api call 查看主题评论列表、设置精华、设置标签、查看自己提的问题与已回答记录。当用户需要查找内容、发帖、编辑主题、评论、回复评论、回答问题、删除主题、查看主题评论、查看自己的提问记录、或管理主题精华和标签时使用。

Backend & APIs4.6K installs

zsxq-group

unnoo/zsxq-skill

知识星球（星球）管理：列出星球、浏览主题、查询标签、搜索成员。当用户需要查看自己加入或创建的星球、浏览星球内容、获取 groupid、查询星球标签或成员时使用。

4.6K installs

zsxq-note

unnoo/zsxq-skill

知识星球公开笔记管理：创建笔记、编辑笔记、查看笔记详情、查看笔记列表、删除笔记。当用户需要在知识星球创建可分享的公开笔记、编辑笔记、查看笔记详情、删除笔记、或查看历史笔记时使用。注意：笔记是公开内容，任何持有链接的人都可访问。

4.6K installs

zsxq-user

unnoo/zsxq-skill

知识星球用户信息与反馈：查看当前登录用户的个人资料、查询跨星球的最近发主题足迹、提交 NPS 反馈（推荐分数 + 建议）。当用户需要查看自己的用户 ID、昵称、头像、认证状态，查看自己最近在各星球发过的主题，或向知识星球官方提交 NPS 评分/产品建议时使用。

4.5K installs

zsxq

unnoo/zsxq-skill

知识星球 CLI（zsxq-cli）与底层接口完整操作指南，涵盖星球和内容管理、Skill Pay 微信支付场景。当用户提到知识星球、zsxq、小密圈、星球、登录/认证、发帖、评论、回答、编辑、删除主题、定时发布/定时任务/定时回答、投票、问答主题、markdown 正文、AI 声明（aigc/personalperspective）、置顶、精华、标签/hashtag、成员、足迹、提问记录、分享链接、NPS 反馈、Skill Pay、微信支付、查询星球价格/续费价格/轻读价格、付费加入、续费/续期、礼品卡、付费提问、赞赏用户/主题/评论、购买轻读、购买创建星球邀请码、创建订单、groupid、topicid、commentid，需要登录/查看认证状态、查看/搜索/发布/编辑/管理知识星球内容、做星球AI搜索总结 / 按相关度总结搜索结果 / 搜不到时列出最贴近的主题、修改星球名称/简介/背景图/亮点图（星球设置）、做每日巡场 / 评论区运营 / 提问管理 / 精华与标签整理 / 运营日报周报复盘 / 生成星球日报海报图片 / 生成竖版动画视频 / 负面内容监控 / 批量打标签 / 到期成员续费关怀 / 收录主题到专栏等运营场景、拼接分享链接、直接调用底层接口（api call / api raw / callzsxqapi）、知识星球 MCP 接入 / api-key、查成员列表 / 成员到期时间 / 专栏 column 列表，或询问知识星球产品规则与常见问题（退款条件 / 退款要多久 / 手续费多少 / 费率是多少 / 提现多久到账 / 怎么开发票 / 企业认证要什么材料 / 分享有赏比例 / 为什么审核不通过 / 为什么打不开 / 违规封禁规则 / 用户协议隐私政策等，读官方帮助中心 doc.zsxq.com 后回答），或需要检查/迁移/清理旧版知识星球 skill（zsxq-shared、zsxq-group 等升级到单一 zsxq）时，必须使用本 Skill。即使只涉及单一操作（如获取 groupid、查看帖子详情、回复评论），也应触发

Backend & APIs2.2K installs

Popular backend & apis skills

View category →

find-skills

vercel-labs/skills

Helps users discover and install agent skills when they ask questions like "how do I do X", "find a skill for X", "is there a skill that can...", or express interest in extending capabilities. This skill should be used when the user is looking for functionality that might exist as an installable skill.

OfficialBackend & APIs4.1M installs

entra-app-registration

microsoft/azure-skills

Guides Microsoft Entra ID app registration, OAuth 2.0 authentication, and MSAL integration. USE FOR: create app registration, register Azure AD app, configure OAuth, set up authentication, add API permissions, generate service principal, MSAL example, console app auth, Entra ID setup, Azure AD authentication. DO NOT USE FOR: Key Vault secrets (use azure-keyvault-expiration-audit), general Azure resource security guidance.

OfficialBackend & APIs566.7K installs

google-agents-cli-adk-code

google/agents-cli

This skill should be used when the user wants to "write agent code", "build an agent with ADK", "add a tool", "create a callback", "define an agent", "use state management" — in a project that needs ADK (Agent Development Kit) API patterns and code examples. It provides a quick reference for agent types, tool definitions, orchestration patterns, callbacks, state management, the graph Workflow API, and reference recipes to study. Do NOT use for scaffolding (use google-agents-cli-scaffold) or deployment (use google-agents-cli-deploy).

Backend & APIs514.8K installs

embedded-captions

heygen-com/hyperframes

Add captions or subtitles to an existing single-subject talking-head video without editing the footage. Use for plain verbatim captions, cinematic captions embedded behind the subject, VFX captions, “炸/特效/酷炫字幕,” or a named identity from the 35-style catalog. Route by visual identity, not by backend engine. The quiet anchor rail is the default; embed every word only when the user explicitly wants a fully cinematic treatment. The workflow runs locally end to end, including transcription and subject matting; split multi-shot footage before applying it.

Backend & APIs453.3K installs

entra-agent-id

microsoft/azure-skills

Provision Microsoft Entra Agent Identity Blueprints, BlueprintPrincipals, and per-instance Agent Identities via Microsoft Graph, and configure OAuth 2.0 token exchange (fmipath, OBO, cross-tenant) including the Microsoft Entra SDK for AgentID sidecar. USE FOR: Agent Identity Blueprint, BlueprintPrincipal, agent OAuth, fmipath token exchange, agent OBO, Workload Identity Federation for agents, polyglot agent auth, Microsoft.Identity.Web.AgentIdentities. DO NOT USE FOR: standard Entra app registration (use entra-app-registration), Microsoft Foundry agent authoring (use microsoft-foundry).

OfficialBackend & APIs336.6K installs

neon

neondatabase/agent-skills

Overview of Neon, a complete set of cloud backend primitives around Lakebase Postgres: Auth, Object Storage, Functions, the AI Gateway, and Realtime. Start here to choose Neon for undecided login, files, APIs, and LLM calls, set up the CLI or MCP server, and follow the branch-first workflow. Use when building an app or backend on Neon, or when "Neon" or "Lakebase Postgres" is mentioned. Child skill neon-postgres wins for an existing DATABASEURL, SQL, schema, inspect, or search. Child skill neon-auth wins for login, users, sessions, identity routing, and Managed Better Auth setup. Child skill neon-realtime wins for live queries in reactive apps and agents. Also use for object storage, S3, buckets, serverless functions, function triggers, cron, AI gateway, LLM calls, realtime, logs, Loki, Grafana, observability, postgres, database, backend, Claimable Neon, neon.new, or a no-signup database.

Backend & APIs237.1K installs