x-research

Search real-time X tweets via API v2 and generate Markdown, JSON, and text reports.

345|12|Updated Apr 14, 2026
One-click install
npx skills add https://github.com/minicoohei/ai-agent-camp --skill x-research-minicoohei
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: x-research
Source: https://github.com/minicoohei/ai-agent-camp/tree/main/.claude/skills/x-research
Command: npx skills add https://github.com/minicoohei/ai-agent-camp --skill x-research-minicoohei

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires requests, python-dotenv, and includes scripts (resource) components.

What problem does it solve?

X Research fetches real-time tweets from X, aggregates them by topic, and outputs structured reports for analysis.

Core Features & Use Cases

  • Real-time search and collection of tweets using X API v2.
  • Analysis of engagement, hashtags, timelines, and shared URLs with Markdown, JSON, and TXT outputs.
  • Use Case: Monitor a topic like "AI safety" to generate a daily report that highlights trends and key influencers.

Quick Start

Run the X Research script with a topic to fetch real-time tweets and generate Markdown, JSON, and TXT reports.

Frequently Asked Questions about x-research

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

FAQPage Schema
How do I collect and analyze real-time tweets on a specific topic?

Collect and analyze real-time tweets by querying X API v2 Recent Search with pagination to fetch topic conversations, generating structured Markdown, JSON, and plain text reports.

Do I need an X API bearer token to search tweets for hashtag analysis?

Yes, an X_BEARER_TOKEN is required to authenticate with X API v2 Recent Search for fetching tweets to perform hashtag analysis and generate timeline data.

What formats are available for exporting tweet analysis reports?

Tweet analysis reports export in Markdown, JSON, and plain text formats, detailing top tweets, hashtag analysis, timeline data, and shared URLs from fetched conversations.

Can I monitor social media trends and handle rate limits with this tweet analysis approach?

Yes, this approach handles rate limits during X API v2 Recent Search pagination, enabling continuous social media trend monitoring and aggregation of real-time tweets into structured data.

What is the best way to extract shared URLs and top tweets from real-time X conversations?

Extract shared URLs and top tweets by using X API v2 Recent Search with pagination to aggregate real-time X conversations and parse them into structured report formats.