x-research

Fetch recent X posts and rank them by engagement score.

18|4|Updated Jan 12, 2026
One-click install
npx skills add https://github.com/parmartejass/AGENTS.MD --skill x-research-parmartejass
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: x-research
Source: https://github.com/parmartejass/AGENTS.MD/tree/main/X-Bookmarks%20Import/skills/x-research
Command: npx skills add https://github.com/parmartejass/AGENTS.MD --skill x-research-parmartejass

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This skill enables researchers, marketers, and product teams to quickly identify and analyze what people are saying about a topic on X, saving time compared to manual scrolling and manual scoring.

Core Features & Use Cases

  • Fetches recent X posts (7-day window) for a given topic and ranks them by a composite engagement score.
  • Attaches author details, media, and relevant links to each post for richer context and exploration.
  • Outputs results in multiple formats (full report, compact list, or JSON) to support human review and programmatic consumption.
  • Use Case: monitor product launches, track public sentiment, and surface actionable insights with top posts and trends.

Quick Start

Run the script with a topic to fetch recent X posts and view the ranked results.

Frequently Asked Questions about x-research

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

FAQPage Schema
How do I analyze recent X posts and rank them by engagement for a specific topic?

To analyze recent X posts and rank them by engagement, you can use a script that fetches data from X API v2 over a 7-day window and applies a scoring algorithm. It outputs structured results with author details and media context.

What do I need to fetch Twitter data and score posts programmatically?

To fetch Twitter data and score posts programmatically, you need an X Bearer token and Python 3.10 or higher. The runtime script uses these to access X API v2 and process the retrieved posts with its engagement scoring algorithm.

Can I filter X API results by language when monitoring trend analysis data?

Yes, you can filter X API results by language when monitoring trend analysis data. The skill supports optional language filtering alongside its 7-day data retrieval window to help refine your research and sentiment scanning workflows.

What output formats are available for Twitter engagement data extraction?

Available output formats for Twitter engagement data extraction include full reports, compact lists, and JSON. These options support both human review of top trending posts and programmatic consumption for downstream data enrichment workflows.

How does the engagement scoring mechanism work for recent X posts?

The engagement scoring mechanism works by fetching recent X posts about a given topic and calculating a composite engagement score for each. It then ranks the posts and attaches author details and media to provide richer context for your analysis.

Are there limitations to retrieving X posts for competitive analysis using this approach?

A limitation of retrieving X posts for competitive analysis is the 7-day retrieval window imposed by the X API v2. This restricts historical trend monitoring to data from the past week, making it best suited for current sentiment scanning and recent launches.