pull-messages-from-discord/README.md

pull-messages-from-discord

Pull messages from a Discord channel for the last N hours and save them as JSON.

Setup

Put the bot token in .env (gitignored):

HM_DISCORD_BOT_TOKEN=...

The bot needs View Channel + Read Message History on the channel, and the Message Content Intent enabled in the Developer Portal (otherwise content and embeds come back empty).

Usage

uv run script.py --channel homelab-alerts --time 24h
uv run script.py -c homelab-alerts -t 24

Options: -c/--channel (required), -t/--time hours, 24 or 24h (default 24), -g/--guild name or ID if the channel name is ambiguous, -o/--output file path.

Output goes next to the script: discord_<channel>_<UTC timestamp>.json.

jq examples

jq '.count' discord_homelab-alerts_*.json
jq -r '.messages[] | "\(.timestamp) \(.content)"' file.json
jq '.messages[].embeds[].title' file.json
jq '.messages[] | select(.content | test("error"; "i"))' file.json