Search Discord messages
Input
query requiredWhat to search for. Discord's own search syntax works here, e.g. 'deploy', 'from:someone deploy', 'in:general has:link'. Always use the English keywords (from:/in:/has:/mentions:) regardless of the signed-in account's Discord display language -- the script translates them internally.
guildId requiredServer id to search, e.g. from discord.com/list_servers.
limit optionalHow many hits to return, newest first. Discord serves 25 per page and this reads one page, so 25 is the maximum; total_results tells you how many exist.
Default: 25Output
count requiredquery requiredguildId requiredmessages requiredcomplete optionalTrue when every hit Discord reported was returned; false when more exist beyond this page.
total_results optionalDiscord's own count of matching messages, which can exceed the number returned.
FAQ
Read Discord messages
Reads the most recent messages of a Discord channel (author, timestamp, text), newest first, scrolling up to load more until the requested count. Requires being logged in. It also reads a thread or a forum post, since both are channels in their own right: pass the post's url (from discord.com/list_forum_posts) and you get its replies plus the opening post, newest first — there is no separate thread-reading script. To list the posts of a forum channel rather than its messages, use discord.com/list_forum_posts instead.
Post a Discord message
Posts a text message in a Discord channel, addressed by channel URL. Requires being logged in to Discord. Returns `sent` plus the created message's messageId, channelId, timestamp and content as Discord stored it. This is a write: the message appears in the channel and is visible to everyone who can see it. Discord's own message limits are checked before anything is sent, so a message that is empty or whitespace-only, or longer than 2000 characters, is refused straight away with a clear reason.
Discord login
Opens the Discord web app in the browser and reports whether the account is signed in, together with the username and display name it is signed in as. Run this first: the other Discord scripts need the web app open on a signed-in session.