Slack爬虫工具（免费版）

概述

Slack爬虫工具（免费版）基于本地Slack归档数据提供消息检索与统计分析能力。核心设计理念是"本地优先"：优先使用已归档的本地数据回答问题，仅在数据过期或用户要求时才同步，避免重复调用Slack API浪费配额与时间。

本免费版聚焦本地归档的检索与统计场景，提供健康检查、新鲜度查询、关键词检索、时间范围切片与只读SQL统计，适合个人与小型团队的Slack数据分析需求。数据存储于本地SQLite数据库，无需额外数据库服务。

核心能力

核心功能执行

用input_params参数进行配置。

输入: 用户提供核心功能执行所需的指令和必要参数。 处理: 解析核心功能执行的输入参数,完成核心逻辑,返回结构化响应。 输出: 返回核心功能执行的响应数据,包含状态码、结果和日志。

• 执行此能力时使用input_params参数,支持创建/查询/导出操作

参数配置与调用

用config_options参数进行配置。

输入: 用户提供参数配置与调用所需的指令和必要参数。 处理: 解析参数配置与调用的输入参数,完成核心逻辑,返回结构化响应。 输出: 返回参数配置与调用的响应数据,包含状态码、结果和日志。

• 执行此能力时使用config_options参数,支持修改/重置/导入操作

结果处理与输出

用output_format参数进行配置。

输入: 用户提供结果处理与输出所需的指令和必要参数。 处理: 解析结果处理与输出的输入参数,完成核心逻辑,返回结构化响应。 输出: 返回结果处理与输出的响应数据,包含状态码、结果和日志。

• 执行此能力时使用output_format参数,支持导出/保存/转换操作 能力覆盖范围：本skill的核心能力覆盖以下场景关键词：基于本地、归档数据的检索与、统计工具、支持新鲜度检查与、爬虫工具、归档数据提供消息、新鲜度检查与只读、优先使用本地数据、避免重复等。这些关键词对应description中声明的使用场景,均已在上述能力点中提供对应的操作支持。

使用场景

场景1：个人Slack工作区归档分析

小刘希望分析自己Slack工作区过去半年的活跃度。他使用本工具：从Slack桌面应用导出数据同步到本地归档，用只读SQL统计每月消息数、最活跃频道、最活跃成员，生成活跃度报告。

场景2：历史消息快速检索

团队成员需要查找三个月前讨论某功能的消息。直接在Slack中搜索受限于搜索范围与索引延迟。使用本工具在本地归档中全文检索，快速定位相关消息及其上下文。

场景3：避免重复API调用

Agent需要回答"本月#general频道有多少条消息"这类统计问题。本工具优先查询本地归档（毫秒级响应），仅当数据过期时才提示同步，避免每次都调用Slack API（受速率限制且耗时）。

不适用场景

以下场景Slack爬虫工具不适合处理：

• 数据库架构设计决策
• NoSQL选型
• 数据仓库ETL设计

触发条件

需要数据库操作、SQL查询、数据存储管理时使用。不适用于非本工具能力范围的需求。

使用流程

Step 1：检查归档状态

slack-crawler doctor
slack-crawler status --json

doctor检查归档完整性与配置问题，status返回各频道的最后同步时间与消息数量。

Step 2：同步本地数据（首次）

从Slack桌面应用导出数据同步：

slack-crawler sync --source desktop

Step 3：检索消息

# 关键词检索（限20条）
slack-crawler search --limit 20 "产品发布"
# ...
# 时间范围切片（最近7天，限50条）
slack-crawler messages --since 7d --limit 50

Step 4：SQL统计查询

# 统计消息总数
slack-crawler sql "select count(*) from messages;"
# ...
# 各频道消息数排名
slack-crawler sql "select channel, count(*) as cnt from messages group by channel order by cnt desc limit 10;"

示例

健康检查输出

slack-crawler doctor

输出示例：

归档路径: ~/.slack-crawler/archive.db
数据库: SQLite (正常)
频道数: 12
消息总数: 45230
最早消息: 2025-01-15
最新消息: 2026-07-10
新鲜度状态: 部分过期（3个频道超过7天未同步）

新鲜度查询

slack-crawler status --json

输出示例：

{
  "channels": [
    {"name": "#general", "last_sync": "2026-07-10", "message_count": 12340, "stale": false},
    {"name": "#random", "last_sync": "2026-06-28", "message_count": 8765, "stale": true}
  ],
  "total_messages": 45230,
  "freshness": "partial"
}

只读SQL查询

# 按用户统计消息数
slack-crawler sql "select user, count(*) as cnt from messages group by user order by cnt desc limit 10;"
# ...
# 按小时统计活跃度
slack-crawler sql "select strftime('%H', timestamp) as hour, count(*) as cnt from messages group by hour order by cnt desc;"
# ...
# 包含特定关键词的消息
slack-crawler sql "select channel, user, text from messages where text like '%产品发布%' limit 20;"

时间范围切片

# 最近7天
slack-crawler messages --since 7d --limit 50
# ...
# 指定日期范围
slack-crawler messages --since 2026-07-01 --until 2026-07-15 --limit 100
# ...
# 特定频道
slack-crawler messages --channel "#general" --since 30d --limit 200

最佳实践

1. 本地优先：回答问题前先检查本地归档是否新鲜，新鲜则直接查询
2. 按需同步：仅当数据过期或用户明确要求时同步，避免不必要的API调用
3. 有界切片：检索时始终指定--limit，避免返回超大结果集
4. SQL用于精确统计：需要精确计数或排名时用SQL，模糊检索用search
5. 报告要素完整：汇报结果时包含工作区/频道名、绝对日期范围、计数与数据来源限制

常见问题

Q1：本地数据过期了怎么办？

A：运行slack-crawler sync --source desktop从桌面应用导出同步。免费版仅支持桌面端同步，API同步需专业版。

Q2：SQL查询报错"table not found"怎么办？

A：归档尚未同步。先运行slack-crawler sync --source desktop初始化归档，再执行SQL查询。

Q3：检索结果不全怎么办？

A：本地归档可能不完整（缺少线程回复或私信）。免费版仅同步桌面端导出的数据，完整化需专业版的API同步与线程/DM完整化功能。

Q4：可以修改归档数据吗？

A：不可以。本工具仅提供只读SQL，避免误操作损坏归档完整性。数据修改需在Slack原平台操作后重新同步。

Q5：归档数据库占用空间过大怎么办？

A：可定期清理旧数据。建议保留近1年数据，更早的数据导出后清理。专业版支持自动归档与压缩。

已知限制

本免费体验版限制以下高级功能：

• 不支持从Slack API同步最新数据（仅桌面端导出）
• 不支持线程回复与私信完整化
• 不支持定时自动同步调度
• 不支持数据导出为CSV/JSON
• 不支持增量同步与版本对比

解锁全部功能请使用专业版：slack-crawler-pro

• 当前为免费版本,如需完整功能请升级到付费版获取全部能力

依赖说明

运行环境

• Agent平台：支持SKILL.md的任意AI Agent（Claude Code / Cursor / Codex / Gemini CLI等）
• 操作系统：Windows / macOS / Linux
• 本地存储：归档数据库存储于~/.slack-crawler/archive.db

依赖详情

API Key 配置

• 本免费版无需Slack API Token：数据来源为桌面端导出
• Slack API Token：仅专业版API同步需要，存储于环境变量SLACK_TOKEN
• 禁止：在脚本中硬编码Token

可用性分类

• 分类：MD+EXEC（纯Markdown指令，部分功能需要exec命令行执行能力）
• 说明：基于Markdown的AI Skill，通过自然语言指令驱动Agent完成操作

错误处理