discord-message-scraper

name	discord-message-scraper
description	抓取 Discord 频道历史消息并导出为 markdown/json/html。用户请求备份频道聊天、导出消息记录、分析历史消息、按频道 ID 拉取消息时使用。优先通过本 Skill 的包装脚本输出结构化执行结果，同时兼容并保留原始 CLI 用法。

Discord Message Scraper

概览

使用本仓库现有的 discord_scraper.py 抓取指定 Discord 频道消息，并导出为 Markdown、JSON、HTML。优先调用 scripts/run_scraper.py，以便给 AI Agent 返回可机读结果。

标准流程

1. 确认在项目根目录执行，并且 .env 中已有 DISCORD_TOKEN。
2. 优先调用 scripts/run_scraper.py 并启用 --json-result。
3. 检查返回码和 output_file；若失败，回传 stderr 中的关键报错。
4. 需要兼容旧流程时，直接调用原命令 python3 discord_scraper.py ...。

常用命令

使用 Skill 包装脚本（推荐）：

python3 skills/discord-message-scraper/scripts/run_scraper.py \
  123456789012345678/234567890123456789 \
  --format json \
  --limit 500 \
  --output exports/channel.json \
  --json-result

保持原始 CLI（兼容模式）：

python3 discord_scraper.py 123456789012345678/234567890123456789 -f json -l 500

参数映射

• channel：频道输入，支持 guild_id/channel_id 或 channel_id
• --limit：最大抓取条数
• --format：markdown、json、html
• --output：导出文件路径
• --concurrent：并发请求数
• --retries：失败重试次数
• --verbose：详细日志

资源

• scripts/run_scraper.py：Agent 友好的包装入口，保留原 CLI 语义并输出结构化结果。
• references/compatibility.md：与 Discord API v10 的兼容性核对记录。