Fetch Tweets

Fetch X/Twitter posts for a query and produce a deduplicated digest clustered by sub-narrative.

6|2|Updated May 21, 2026
One-click install
npx skills add https://github.com/anajuliabit/aeon --skill fetch-tweets-anajuliabit
Or copy as Structured Prompt for Agentβ–Ό
Please help me install this Agent Skill.
Skill: Fetch Tweets
Source: https://github.com/anajuliabit/aeon/tree/main/skills/fetch-tweets
Command: npx skills add https://github.com/anajuliabit/aeon --skill fetch-tweets-anajuliabit

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill eliminates the manual effort of searching X/Twitter and sorting results into a useful, decision-ready digest instead of a noisy chronological feed.

Core Features & Use Cases

  • Search query to curated digest: Uses your configured query to retrieve tweets and cluster them by sub-narrative.
  • Signal-based ranking & deduplication: Ranks tweets using engagement signal (likes, retweets, replies), filters duplicates from persistent memory, and avoids empty/error notifications.
  • Unattended operation with fallbacks: Prefers a pre-fetched cache, uses the X.AI (Grok) API when available, and falls back to WebSearch when not.
  • Use Case: Get a daily snapshot of what people are saying about a token or topic, grouped into themes like price action, team updates, or criticism, ready to review at a glance.

Quick Start

Run the fetch-tweets skill with your desired search query set in aeon.yml so it produces a clustered digest and sends a notification with the top insights.

Frequently Asked Questions about Fetch Tweets

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I curate X tweets into a ranked digest grouped by sub-narrative?β–Ό

To curate X tweets into a ranked digest, fetch posts using a configured query and cluster results by sub-narrative. The process applies engagement ranking and deduplication to select 7–10 high-signal tweets for notification.

How does tweet deduplication work for scheduled monitoring of X.com keywords?β–Ό

Tweet deduplication works by loading previously seen tweet URLs from persistent memory and recent logs, filtering out duplicates before clustering candidates into a curated digest.

Can I use WebSearch as a fallback when the X.AI API is unavailable for tweet retrieval?β–Ό

You can use WebSearch as a fallback for tweet retrieval when the X.AI API is unavailable. The system prefers a pre-fetched cache, then uses the X.AI API, falling back to WebSearch for generating the digest.

What is the best way to monitor token sentiment and themes on Twitter without a noisy chronological feed?β–Ό

The best way to monitor token sentiment is retrieving tweets and clustering them by themes like price action or criticism. This signal-based ranking prioritizes high-engagement posts over raw chronological results.

Why does my tweet search return an empty notification digest?β–Ό

An empty notification digest occurs when no high-signal tweets are found after deduplication. The system logs empty and error conditions during the clustering and selection process to avoid sending useless alerts.