Weekly competitor X (Twitter) intelligence brief, delivered to Gmail

Build me a weekly competitor intelligence brief that lands in my inbox every Friday at 9am.

Trigger: cron, weekly on Friday at 9am in my local timezone.

Inputs the workflow should expose as configurable variables: (1) a list of competitor X handles to track (start with a placeholder list I can edit), (2) a list of recipient email addresses for the brief, (3) the lookback window in days (default 7), and (4) an optional engagement threshold for highlighting tweets.

Each run, iterate over the competitor handle list. For every handle:

1. Call TwitterAPI.io "Get User Last Tweets" with a sinceTime filter covering the past 7 days so we only get this week's posts. Paginate through the cursor until there are no more tweets in the window. Capture text, link, createdAt, like count, retweet count, reply count, quote count, and view count for each tweet.

2. Call TwitterAPI.io "Get User Info" to grab the current display name, profile picture, follower count, and following count.

Use the workflow's run state to remember each competitor's follower count from the previous Friday. On every run, read the prior count from state, compute the week-over-week delta (absolute and percentage), then write the new count back to state for next week. If there is no prior count yet (first run for that handle), just record the current count and skip the delta for that competitor this week.

Once all competitor data is collected, reason across the full set:

- Cluster the week's tweets into themes such as product launches, hiring, customer wins, PR moments, exec commentary, and memes. Keep the theme list flexible, add or merge themes based on what actually showed up this week.

- For each competitor, identify the single highest-engagement tweet of the week (use a combined like + retweet + reply score, but prefer view count when available) and include the direct link and engagement counts.

- Flag anything that looks like a launch announcement, pricing change, major hire, fundraising news, or competitive callout. Be explicit about why each flagged item matters.

- Build a closing "watch list" of 3-5 accounts that are gaining velocity this week, based on follower growth rate, tweet volume spike, or a single breakout post.

Render a polished HTML email designed to be skimmable in 90 seconds, with this structure:

1. Top-level "What changed this week" section, 3-5 bullets that summarize the most important moves across the whole competitor set.

2. Per-competitor section. For each handle: name and handle, follower count with week-over-week delta (green for gains, red for losses), the themes they hit this week, and their top tweet with link and engagement numbers.

3. Flagged items section listing any launch announcements, pricing changes, or other high-signal posts.

4. Watch list section at the bottom with the accounts gaining velocity and a one-line reason for each.

Use clean inline-styled HTML, a readable email-safe font, and clear section dividers. Subject line should be something like "Competitor brief, week of {date}".

Delivery: call Gmail "Create a Draft" with the rendered HTML, the configured recipient list in the To field, and the subject line. Then call Gmail "Send a Draft" with the draft id returned from the create step. Send from my connected Gmail account.

If any single competitor's TwitterAPI.io calls fail, do not abort the whole run, just note that competitor as "data unavailable this week" in the email and continue with the rest.

Additional information

What does this prompt do?

Pulls the last 7 days of posts from a configurable list of competitor X accounts and groups them by theme like product launches, hiring, customer wins, PR moments, and exec commentary.
Highlights each competitor's single highest-engagement post of the week with a direct link and engagement counts.
Tracks follower-count changes week over week and surfaces a watch list of accounts that are gaining velocity.
Flags anything that looks like a launch announcement or pricing change so you can react quickly.
Renders a polished HTML email and delivers it to your inbox every Friday morning, ready to skim in 90 seconds.

What do I need to use this?

A TwitterAPI.io account with credits for reading public posts and profiles.
A Gmail account for the sender who will draft and send the brief.
A list of competitor X handles you want to track (you can edit this list any time).
The email addresses that should receive the Friday brief.

How can I customize it?

Change the cadence or send time, for example move it to Monday at 7am or run it twice a week.
Edit the competitor handle list, add new accounts, drop ones that have gone quiet, or split into tiers.
Adjust the recipient list, send only to yourself, to your exec team, or to a marketing alias.
Tune the themes the agent clusters around, for example add categories like partnerships, fundraising, or earnings commentary.
Change the lookback window from 7 days to 14 days, or focus only on posts above a certain engagement threshold.

Frequently asked questions

Which competitors can I track?

Any public X (Twitter) account. You give the agent a list of handles when you set up the workflow, and you can edit that list at any time without rebuilding the workflow.

Do I need a paid X developer account?

No. This uses TwitterAPI.io, a third-party service that reads public posts and profiles using a simple API key. You buy credits from them and read operations are inexpensive.

Will it pick up replies and retweets?

By default the brief focuses on original posts from the last 7 days. You can tell the agent to include replies and quote tweets, or to filter them out, depending on how noisy a given competitor's account is.

How does the follower-count comparison work?

On each Friday run the agent saves the current follower count for every tracked handle. The following Friday it reads those saved counts and compares them to this week's numbers, so the brief shows real week-over-week change.

Can I send the brief to my whole team instead of just myself?

Yes. The recipient list is configurable, you can send it to one person, a small group, or a shared distribution list. The email comes from your connected Gmail account.

Can I receive the brief in Slack or another channel instead of email?

Email is the default because the brief is designed to be read in 90 seconds in your inbox. If you'd rather get it in Slack, Notion, or somewhere else, ask the agent to swap the delivery step.