核心用法
zsxq-fetch 是一款面向知识星球用户的自动化内容抓取助手，通过调用知识星球 Web API 实现帖子数据的获取与整理。主要功能分为三大场景：
1. 多星球批量汇总：通过 groups.json 配置多个目标星球，支持「仅精华」或「全部帖子」两种筛选模式，自动抓取并输出结构化摘要（含作者、发布时间、核心观点、互动数据及直达链接）。
2. 单帖详情查询：支持通过帖子 ID 或完整 URL 获取单条帖子完整内容，文本上限 5000 字，适用于深度阅读或引用特定内容。
3. 星球列表查看：快速列出账号已加入的所有星球信息，便于用户确认可用的 group_id。
技术实现上，该 Skill 基于 Node.js ≥18 运行，无额外第三方依赖，通过 ZSXQ_TOKEN Cookie 值进行身份验证。请求限速策略包括翻页间隔 1 秒、多星球间隔 1.5 秒，以及 HTTP 429 时的指数退避重试机制。
显著优点
- 零依赖轻量部署：仅需 Node.js 环境，无需安装复杂依赖
- 多星球集中管理：JSON 配置文件支持批量抓取多个付费社群
- 智能内容筛选：精华帖模式有效过滤低价值信息，提升阅读效率
- 双格式输入支持：单帖查询同时兼容 ID 和完整 URL，降低使用门槛
- 稳健错误处理：Token 过期、权限不足、API 限流等场景均有明确提示，部分失败不中断整体流程
潜在局限
- Token 依赖与有效期：需手动从浏览器 Cookie 提取，存在过期风险
- 非官方 API：基于逆向工程实现，存在接口变更导致失效的可能性
- 内容长度限制：单帖正文强制截断至 5000 字，超长内容可能不完整
- 无增量同步机制：每次调用均为全量抓取，频繁使用可能触发更严格限速
- 仅支持文本核心内容：图片、附件等多媒体资源仅返回计数，不实际下载
适合人群
- 订阅多个知识星球的内容创作者，需要定期汇总行业动态
- 研究人员追踪特定领域（如 AI、投资、产品）的付费社群讨论
- 团队知识管理员，需将星球内容整合至内部知识库
- 对特定精华帖有深度阅读需求的用户
常规风险
| 风险类型 | 说明 | 缓释建议 |
|---------|------|---------|
| 账号安全 | Token 相当于登录凭证，泄露可导致账号被冒用 | 使用环境变量注入，避免硬编码；定期轮换 Token |
| 服务可用性 | 非官方 API 可能随时变更或封禁 | 关注社区更新，准备备用方案 |
| 内容合规 | 抓取付费内容可能涉及版权与平台条款争议 | 仅限个人学习使用，禁止二次分发或商业利用 |
| 频率限制 | 高频调用可能触发平台风控 | 遵循内置限速策略，避免短时间内大量请求 |