Post Alerts (Social Media Monitoring)

Post Alerts allow you to track new content from your favorite creators across various social media platforms. When a new post is detected, Squint will send a notification to a designated channel.

Quick Start (5 Minutes)

1. Run ;postalerts add youtube MrBeast #alerts @everyone

2. Run ;postalerts add twitter elonmusk #alerts

3. View tracked users: ;postalerts list

4. Remove a user: ;postalerts remove MrBeast

You're done! Read full setup below for advanced options.

Setup

1. Add a creator to track: ;postalerts add youtube UserName #updates @everyone

2. (Optional) Set content preferences: ;postalerts preferences UserName videos false

3. View all tracked users: ;postalerts list

Configuration

• users: A list of objects, each representing a tracked creator:

  • id: Unique identifier for the creator (e.g., youtube:username).

  • name: The creator's username on the platform.

  • platform: The social media platform (e.g., youtube, twitter, instagram, tiktok, bluesky, threads).

  • channelID: The ID of the Discord channel where alerts are sent.

  • mentionRoleId: The ID of a role to mention, or 'everyone' to mention @everyone.

  • lastPostDate: Internal timestamp of the last detected post.

  • lastTweetDate: Internal timestamp of the last detected tweet (Twitter specific).

  • contentPreferences: An object to control which content types trigger alerts:

    • images: Toggles alerts for image posts.

    • videos: Toggles alerts for video content.

    • text: Toggles alerts for text-only posts.

Available Variables (for custom messages - implied):

• {creator} - The name of the creator.

• {platform} - The platform name (e.g., YouTube).

• {title} - The title of the new content.

• {url} - The direct URL to the new content.

• {mention} - The configured role mention (or @everyone).

Common Issues:

• Alerts are not being sent → Ensure the bot has Send Messages and Embed Links permissions in the alert channel.

• Alerts are delayed → The bot checks platforms on staggered intervals (1-5 minutes) to avoid rate limits. Delays are normal.

• Alerts are sent for old content → The system checks the last 5-10 posts. If the creator posts frequently, the system might miss older posts.

• YouTube alerts fail → Ensure the YOUTUBE_API_KEY is valid and has sufficient quota (Developer/Bot Owner issue, but good to note).

Usage

Once a creator is added, Squint will periodically check for new content on the specified platform. When new content is detected (based on your contentPreferences), a notification embed with a link to the post will be sent to the designated channelID, optionally mentioning a mentionRoleId.

Related Commands

• ;postalerts - Main command for managing post alerts.