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.