x-research

Search Twitter via X API v2 and write engagement metrics to Markdown files.

1|Updated Feb 3, 2026
One-click install
npx skills add https://github.com/terminaluse/demos --skill x-research-terminaluse
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: x-research
Source: https://github.com/terminaluse/demos/tree/main/devrel/skills/x-research
Command: npx skills add https://github.com/terminaluse/demos --skill x-research-terminaluse

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

Retrieve and interpret Twitter/X engagement data by searching for relevant tweets, extracting metrics, and profiling influential accounts to inform research and content strategy.

Core Features & Use Cases

  • Search recent tweets: Query Twitter for topic-specific tweets and collect metrics such as likes, retweets, replies, and quotes along with author details.
  • Drill into engagement: Fetch who liked, who retweeted, and who quoted a tweet to identify key influencers and conversations.
  • Markdown reporting: Generate human-readable Markdown outputs that are easy to grep, search, and archive for ongoing analysis.

Quick Start

Search recent tweets for a topic and save the results to the chosen output directory.

Frequently Asked Questions about x-research

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

FAQPage Schema
How do I analyze Twitter engagement metrics for recent tweets on a specific topic?

To analyze Twitter engagement metrics, search for topic-specific recent tweets using X API v2 endpoints to collect likes, retweets, replies, and quotes along with author details. Results are written to Markdown files for reproducible research and archiving.

Can I identify key influencers from Twitter retweets and likes?

Yes, you can identify key influencers by drilling into Twitter engagement using API v2 endpoints for liking_users, retweeted_by, and quote_tweets. This fetches specific accounts interacting with a tweet to profile influential users and conversations.

What is the best way to collect and archive Twitter engagement data for research?

The best way to collect Twitter engagement data is querying tweets via X API v2 and generating human-readable Markdown outputs. These reports are easy to grep, search, and archive, ensuring reproducible analysis of trends and topics.

Does this Twitter analysis approach require the X API v2?

Yes, this Twitter analysis approach requires X API v2 to access endpoints for searching recent tweets, fetching liking_users, retweeted_by, and quote_tweets, and extracting engagement metrics and author details for research.

How do I search recent tweets and extract engagement breakdowns for content strategy?

Search recent tweets by querying Twitter for topic-specific content and extract engagement breakdowns covering likes, retweets, replies, and quotes. This profiles influential accounts to inform your research and content strategy.

Are there limitations to analyzing Twitter quote tweets and engagement with this method?

This method is limited to searching recent tweets and drilling into engagement via X API v2 endpoints for liking_users, retweeted_by, and quote_tweets. It writes results to Markdown files, which may require manual searching for large datasets.