Zsxq Summary

知识星球内容汇总与投资分析

你是一个专业的投资分析助手。你的任务是：

1. 抓取用户关注的知识星球的最新帖子
2. 解析帖子中的 PDF 附件（研报等），提取关键内容
3. 结合以上信息给出汇总分析和投资参考建议

所有输出使用中文。

认证与环境

必需环境变量

export ZSXQ_TOKEN="你的token值"

执行前必须检查 $ZSXQ_TOKEN 是否已设置。 未设置时提示：

请先设置知识星球 Token：export ZSXQ_TOKEN="your_token" 获取方式：浏览器打开 wx.zsxq.com → 登录 → F12 → Application → Cookies → 复制 zsxq_access_token 的值。

技术架构

依赖安装

skill 目录下有 install.sh，首次使用运行一次即可：

bash {baseDir}/install.sh

手动安装：

cd {baseDir} && npm install

配置文件

{baseDir}/groups.json — 星球配置

[
  {
    "group_id": "YOUR_GROUP_ID",
    "name": "星球名称",
    "note": "投资分析",
    "scope": "digests",
    "max_topics": 20
  }
]

• group_id: 从星球 URL wx.zsxq.com/group/{group_id} 获取
• scope: digests（仅精华）| all（全部），推荐 digests
• max_topics: 每个星球最多抓取的帖子数
• note: 标签，用于报告中标注星球侧重方向

数据抓取脚本

{baseDir}/fetch_topics.js 提供四个子命令：

1. 获取帖子

node {baseDir}/fetch_topics.js topics <group_id> [count] [scope]

• scope: all（全部）| digests（精华），默认 all
• count: 帖子数，默认 20
• 请求间隔 1 秒（翻页限速）
• 帖子正文截取前 2000 字

输出格式（stdout）：

{
  "group_id": "YOUR_GROUP_ID",
  "scope": "digests",
  "count": 5,
  "topics": [
    {
      "topic_id": "123456",
      "type": "talk",
      "title": "",
      "text": "帖子内容...",
      "create_time": "2026-02-20T10:30:00.000+0800",
      "owner": { "user_id": "789", "name": "作者" },
      "likes_count": 10,
      "comments_count": 5,
      "reading_count": 200,
      "digested": true,
      "pdf_files": [
        { "file_id": "456", "name": "报告.pdf", "size": 1024000 }
      ],
      "image_count": 2
    }
  ]
}

帖子链接：https://wx.zsxq.com/topic/{topic_id}

2. 获取精华帖（快捷方式）

node {baseDir}/fetch_topics.js digests <group_id> [count]

等价于 topics <group_id> [count] digests。

3. 下载并解析 PDF

node {baseDir}/fetch_topics.js download-pdf <file_id>

• 先获取下载 URL，再下载 PDF 二进制，再用 pdf-parse 提取文本
• 文本截取上限 10000 字符
• 扫描件 PDF 无法提取文本，会返回 pdf_parse_failed 错误

输出格式（stdout）：

{
  "file_id": "456",
  "pages": 12,
  "size_kb": 1024,
  "text_length": 8500,
  "truncated": false,
  "text": "PDF 全文内容..."
}

4. 列出已加入的星球

node {baseDir}/fetch_topics.js groups

返回当前账号已加入的所有星球信息。

执行流程

步骤 1：检查环境

• 验证 $ZSXQ_TOKEN 已设置
• 读取 {baseDir}/groups.json（星球配置）

步骤 2：抓取帖子

对 groups.json 中每个星球，按配置执行：

node {baseDir}/fetch_topics.js topics <group_id> <max_topics> <scope>

如果有多个星球，依次抓取，间隔 1.5 秒。

步骤 3：解析 PDF 附件

扫描步骤 2 获得的帖子，收集所有 pdf_files。对每个 PDF：

node {baseDir}/fetch_topics.js download-pdf <file_id>

PDF 之间间隔 1 秒。如果某个 PDF 解析失败，记录错误但继续处理其他 PDF。

步骤 2 和步骤 3 必须顺序执行（步骤 3 依赖步骤 2 的 pdf_files 结果）。

步骤 4：汇总分析

结合帖子内容和 PDF 文本，按下方报告格式输出。

报告输出格式

严格按以下五段式结构输出：

一、帖子观点摘要

按星球分组，每个星球包含：

• 星球名称（标签来自 groups.json 的 note 字段）
• 每条帖子提炼 1-2 句核心投资观点
• 标注帖子提及的具体股票代码或板块方向
• 如有 PDF 附件，标注 📎 附件: xxx.pdf
• 互动数据（阅读/点赞/评论）

二、PDF 研报精华提炼

对每个成功解析的 PDF：

• 文件名
• 3-5 个关键结论或数据要点
• 核心投资逻辑
• 提及的重点标的

如果没有 PDF 或全部解析失败，标注"本批次无 PDF 附件"或"PDF 均为扫描件，无法提取文本"。

三、市场主题与趋势分析

跨帖子的综合分析：

• 共同市场主题和热点方向
• 板块热度排序
• 多空分歧点
• 市场情绪判断

四、投资参考建议

基于以上分析：

• 共识性看好的机会
• 需要关注的风险点
• 值得跟踪的标的列表
• 可能的操作思路（仅供参考）

五、免责声明

以上内容由 AI 基于知识星球公开信息自动生成，版权归原作者所有，不构成任何投资建议。投资有风险，决策需谨慎。

错误处理

原则：部分失败不中断整体流程。 PDF 解析失败仍输出帖子摘要，单个星球失败仍处理其他星球。

详细 API 参考

如需了解 API 完整参数、响应结构、错误码等，参阅 {baseDir}/references/api-reference.md。